@malloydata/malloy 0.0.334 → 0.0.336

package/dist/malloy.js

@@ -1,3421 +0,0 @@
-"use strict";
-/*
- * Copyright 2023 Google LLC
- *
- * Permission is hereby granted, free of charge, to any person obtaining
- * a copy of this software and associated documentation files
- * (the "Software"), to deal in the Software without restriction,
- * including without limitation the rights to use, copy, modify, merge,
- * publish, distribute, sublicense, and/or sell copies of the Software,
- * and to permit persons to whom the Software is furnished to do so,
- * subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
- * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
- * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
- * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
- * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
- * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InMemoryModelCache = exports.CacheManager = exports.CSVWriter = exports.JSONWriter = exports.DataWriter = exports.DataRecord = exports.DataArray = exports.Result = exports.ExploreMaterializer = exports.PreparedResultMaterializer = exports.QueryMaterializer = exports.ModelMaterializer = exports.SingleConnectionRuntime = exports.ConnectionRuntime = exports.Runtime = exports.ExploreField = exports.JoinRelationship = exports.QueryField = exports.Query = exports.StringField = exports.UnsupportedField = exports.JSONField = exports.BooleanField = exports.NumberField = exports.TimestampField = exports.DateField = exports.TimestampTimeframe = exports.DateTimeframe = exports.AtomicField = exports.AtomicFieldType = exports.Explore = exports.SourceRelationship = exports.FixedConnectionMap = exports.InMemoryURLReader = exports.EmptyURLReader = exports.PreparedResult = exports.DocumentCompletion = exports.DocumentSymbol = exports.DocumentPosition = exports.DocumentRange = exports.DocumentTablePath = exports.Parse = exports.PreparedQuery = exports.Model = exports.MalloyError = exports.Malloy = void 0;
-const lang_1 = require("./lang");
-const model_1 = require("./model");
-const dialect_1 = require("./dialect");
-const version_1 = require("./version");
-const uuid_1 = require("uuid");
-const annotation_1 = require("./annotation");
-const sql_block_1 = require("./model/sql_block");
-const utils_1 = require("./lang/utils");
-const reference_list_1 = require("./lang/reference-list");
-const row_data_utils_1 = require("./api/row_data_utils");
-function isSourceComponent(source) {
-    return (source.type === 'table' ||
-        source.type === 'sql_select' ||
-        source.type === 'query_source');
-}
-const MALLOY_INTERNAL_URL = 'internal://internal.malloy';
-class Malloy {
-    static get version() {
-        return version_1.MALLOY_VERSION;
-    }
-    static _parse(source, url, eventStream, options, invalidationKey) {
-        if (url === undefined) {
-            url = new URL(MALLOY_INTERNAL_URL);
-        }
-        let importBaseURL = url;
-        if (options === null || options === void 0 ? void 0 : options.importBaseURL) {
-            importBaseURL = options === null || options === void 0 ? void 0 : options.importBaseURL;
-        }
-        const translator = new lang_1.MalloyTranslator(url.toString(), importBaseURL.toString(), {
-            urls: { [url.toString()]: source },
-        }, eventStream);
-        if (options === null || options === void 0 ? void 0 : options.testEnvironment) {
-            translator.allDialectsEnabled = true;
-        }
-        return new Parse(translator, invalidationKey);
-    }
-    static parse({ url, urlReader, source, eventStream, options, }) {
-        if (source !== undefined) {
-            return Malloy._parse(source, url, eventStream, options);
-        }
-        else {
-            if (urlReader === undefined) {
-                throw new Error('Internal Error: urlReader is required.');
-            }
-            if (url === undefined) {
-                throw new Error('Internal Error: url is required if source not present.');
-            }
-            return readURL(urlReader, url).then(({ contents, invalidationKey }) => {
-                return Malloy._parse(contents, url, eventStream, options, invalidationKey);
-            });
-        }
-    }
-    /**
-     * Compile a parsed Malloy document.
-     *
-     * @param urlReader Object capable of reading contents of a URL.
-     * @param connections Mapping of connection names to objects capable of reading Malloy schemas.
-     * @param parse The parsed Malloy document.
-     * @param model A compiled model to build upon (optional).
-     * @return A (promise of a) compiled `Model`.
-     */
-    static async compile({ url, source, parse, urlReader, connections, model, refreshSchemaCache, noThrowOnError, eventStream, importBaseURL, cacheManager, }) {
-        var _a, _b, _c, _d, _e;
-        let refreshTimestamp;
-        if (refreshSchemaCache) {
-            refreshTimestamp =
-                typeof refreshSchemaCache === 'number'
-                    ? refreshSchemaCache
-                    : Date.now();
-        }
-        if (url === undefined && source === undefined && parse === undefined) {
-            throw new Error('Internal Error: url, source, or parse required.');
-        }
-        if (url === undefined) {
-            if (parse !== undefined) {
-                url = new URL(parse._translator.sourceURL);
-            }
-            else {
-                url = new URL(MALLOY_INTERNAL_URL);
-            }
-        }
-        const invalidationKeys = {};
-        // Before anything, if we have a URL and not source code, we check if that URL
-        // is cached.
-        if (source === undefined && cacheManager !== undefined) {
-            const cached = await cacheManager.getCachedModelDef(urlReader, url.toString());
-            if (cached) {
-                return new Model(cached.modelDef, [], // TODO when using a model from cache, should we also store the problems??
-                [url.toString(), ...flatDeps(cached.modelDef.dependencies)]);
-            }
-        }
-        importBaseURL !== null && importBaseURL !== void 0 ? importBaseURL : (importBaseURL = url);
-        let translator;
-        // It's not cached, so we may need to get the actual source
-        const _url = url.toString();
-        if (parse !== undefined) {
-            translator = parse._translator;
-            const invalidationKey = (_a = parse._invalidationKey) !== null && _a !== void 0 ? _a : (await getInvalidationKey(urlReader, url));
-            invalidationKeys[_url] = invalidationKey;
-        }
-        else {
-            if (source === undefined) {
-                const { contents, invalidationKey } = await readURL(urlReader, url);
-                invalidationKeys[_url] = invalidationKey;
-                source = contents;
-            }
-            else {
-                const invalidationKey = await getInvalidationKey(urlReader, url);
-                invalidationKeys[_url] = invalidationKey;
-            }
-            translator = new lang_1.MalloyTranslator(_url, importBaseURL.toString(), {
-                urls: { [_url]: source },
-            }, eventStream);
-        }
-        for (;;) {
-            const result = translator.translate(model === null || model === void 0 ? void 0 : model._modelDef);
-            if (result.final) {
-                if (result.modelDef) {
-                    await (cacheManager === null || cacheManager === void 0 ? void 0 : cacheManager.setCachedModelDef(url.toString(), {
-                        modelDef: result.modelDef,
-                        invalidationKeys,
-                    }));
-                    for (const model of translator.newlyTranslatedDependencies()) {
-                        await (cacheManager === null || cacheManager === void 0 ? void 0 : cacheManager.setCachedModelDef(model.url, {
-                            modelDef: model.modelDef,
-                            invalidationKeys,
-                        }));
-                    }
-                    return new Model(result.modelDef, result.problems || [], [
-                        ...((_b = model === null || model === void 0 ? void 0 : model.fromSources) !== null && _b !== void 0 ? _b : []),
-                        ...((_c = result.fromSources) !== null && _c !== void 0 ? _c : []),
-                    ]);
-                }
-                else if (noThrowOnError) {
-                    const emptyModel = {
-                        name: 'modelDidNotCompile',
-                        exports: [],
-                        contents: {},
-                        dependencies: {},
-                        queryList: [],
-                    };
-                    const modelFromCompile = (model === null || model === void 0 ? void 0 : model._modelDef) || emptyModel;
-                    return new Model(modelFromCompile, result.problems || [], [
-                        ...((_d = model === null || model === void 0 ? void 0 : model.fromSources) !== null && _d !== void 0 ? _d : []),
-                        ...((_e = result.fromSources) !== null && _e !== void 0 ? _e : []),
-                    ]);
-                }
-                else {
-                    const errors = result.problems || [];
-                    const errText = translator.prettyErrors();
-                    throw new MalloyError(`Error(s) compiling model:\n${errText}`, errors);
-                }
-            }
-            else {
-                // Parse incomplete because some external information is required,
-                // there might be more than one of these in a single reply ...
-                if (result.urls) {
-                    for (const neededUrl of result.urls) {
-                        try {
-                            if (isInternalURL(neededUrl)) {
-                                throw new Error('In order to use relative imports, you must compile a file via a URL.');
-                            }
-                            // First, check the cache
-                            if (cacheManager !== undefined) {
-                                const cached = await cacheManager.getCachedModelDef(urlReader, neededUrl);
-                                if (cached) {
-                                    for (const dependency in cached.invalidationKeys) {
-                                        invalidationKeys[dependency] =
-                                            cached.invalidationKeys[dependency];
-                                    }
-                                    translator.update({
-                                        translations: { [neededUrl]: cached.modelDef },
-                                    });
-                                    continue;
-                                }
-                            }
-                            // Otherwise, fetch the URL contents
-                            const { contents, invalidationKey } = await readURL(urlReader, new URL(neededUrl));
-                            const urls = { [neededUrl]: contents };
-                            invalidationKeys[neededUrl] = invalidationKey;
-                            translator.update({ urls });
-                        }
-                        catch (error) {
-                            translator.update({
-                                errors: { urls: { [neededUrl]: error.message } },
-                            });
-                        }
-                    }
-                }
-                const { modelAnnotation } = translator.modelAnnotation(model === null || model === void 0 ? void 0 : model._modelDef);
-                if (result.tables) {
-                    // collect tables by connection name since there may be multiple connections
-                    const tablesByConnection = new Map();
-                    for (const tableKey in result.tables) {
-                        const { connectionName, tablePath } = result.tables[tableKey];
-                        const connectionToTablesMap = tablesByConnection.get(connectionName);
-                        if (connectionToTablesMap === undefined) {
-                            tablesByConnection.set(connectionName, { [tableKey]: tablePath });
-                        }
-                        else {
-                            connectionToTablesMap[tableKey] = tablePath;
-                        }
-                    }
-                    // iterate over connections, fetching schema for all missing tables
-                    for (const [connectionName, tablePathByKey] of tablesByConnection) {
-                        try {
-                            const connection = await connections.lookupConnection(connectionName);
-                            // TODO detect if the union of `Object.keys(tables)` and `Object.keys(errors)` is not the same
-                            //      as `Object.keys(tablePathByKey)`, i.e. that all tables are accounted for. Otherwise
-                            //      the translator runs into an infinite loop fetching tables.
-                            const { schemas: tables, errors } = await Malloy.safelyFetchTableSchema(connection, tablePathByKey, {
-                                refreshTimestamp,
-                                modelAnnotation,
-                            });
-                            translator.update({ tables, errors: { tables: errors } });
-                        }
-                        catch (error) {
-                            // There was an exception getting the connection, associate that error
-                            // with all its tables
-                            const tables = {};
-                            const errors = {};
-                            for (const tableKey in tablePathByKey) {
-                                errors[tableKey] = error.toString();
-                            }
-                            translator.update({ tables, errors: { tables: errors } });
-                        }
-                    }
-                }
-                if (result.compileSQL) {
-                    // Unlike other requests, these do not come in batches
-                    const toCompile = result.compileSQL;
-                    const connectionName = toCompile.connection;
-                    const key = (0, sql_block_1.sqlKey)(toCompile.connection, toCompile.selectStr);
-                    try {
-                        const conn = await connections.lookupConnection(connectionName);
-                        const resolved = await conn.fetchSchemaForSQLStruct(toCompile, {
-                            refreshTimestamp,
-                            modelAnnotation,
-                        });
-                        if (resolved.error) {
-                            translator.update({
-                                errors: {
-                                    compileSQL: {
-                                        [key]: resolved.error,
-                                    },
-                                },
-                            });
-                        }
-                        if (resolved.structDef) {
-                            translator.update({
-                                compileSQL: { [key]: resolved.structDef },
-                            });
-                        }
-                    }
-                    catch (error) {
-                        const errors = {};
-                        errors[key] = error.toString();
-                        translator.update({ errors: { compileSQL: errors } });
-                    }
-                }
-            }
-        }
-    }
-    /**
-     * A dialect must provide a response for every table, or the translator loop
-     * will never exit. Because there was a time when this happened, we throw
-     * instead of looping forever, but the fix is to correct the dialect.
-     */
-    static async safelyFetchTableSchema(connection, toFetch, opts) {
-        const ret = await connection.fetchSchemaForTables(toFetch, opts);
-        for (const req of Object.keys(toFetch)) {
-            if (ret.schemas[req] === undefined && ret.errors[req] === undefined) {
-                throw new Error(`Schema fetch error for ${connection.name}, no response for ${req} from ${connection.dialectName}`);
-            }
-        }
-        return ret;
-    }
-    static async run({ connections, preparedResult, sqlStruct, connection, options, }) {
-        if (!connection) {
-            if (!connections) {
-                throw new Error('Internal Error: Connection or LookupConnection<Connection> must be provided.');
-            }
-            const connectionName = (sqlStruct === null || sqlStruct === void 0 ? void 0 : sqlStruct.connection) || (preparedResult === null || preparedResult === void 0 ? void 0 : preparedResult.connectionName);
-            connection = await connections.lookupConnection(connectionName);
-        }
-        if (sqlStruct) {
-            const data = await connection.runSQL(sqlStruct.selectStr);
-            return new Result({
-                structs: [sqlStruct],
-                sql: sqlStruct.selectStr,
-                result: data.rows,
-                totalRows: data.totalRows,
-                runStats: data.runStats,
-                lastStageName: sqlStruct.name,
-                // TODO feature-sql-block There is no malloy code...
-                malloy: '',
-                connectionName: sqlStruct.connection,
-                // TODO feature-sql-block There is no source explore...
-                sourceExplore: '',
-                sourceFilters: [],
-                profilingUrl: data.profilingUrl,
-            }, {
-                name: 'empty_model',
-                exports: [],
-                contents: {},
-                queryList: [],
-                dependencies: {},
-            });
-        }
-        else if (preparedResult) {
-            const result = await connection.runSQL(preparedResult.sql, options);
-            return new Result({
-                ...preparedResult._rawQuery,
-                result: result.rows,
-                totalRows: result.totalRows,
-                runStats: result.runStats,
-                profilingUrl: result.profilingUrl,
-            }, preparedResult._modelDef);
-        }
-        else {
-            throw new Error('Internal error: sqlStruct or preparedResult must be provided.');
-        }
-    }
-    static async *runStream({ connections, preparedResult, sqlStruct, connection, options, }) {
-        if (sqlStruct === undefined && preparedResult === undefined) {
-            throw new Error('Internal error: sqlBlock or preparedResult must be provided.');
-        }
-        const connectionName = (sqlStruct === null || sqlStruct === void 0 ? void 0 : sqlStruct.connection) || (preparedResult === null || preparedResult === void 0 ? void 0 : preparedResult.connectionName);
-        if (connection === undefined) {
-            if (connections === undefined) {
-                throw new Error('Internal Error: Connection or LookupConnection<Connection> must be provided.');
-            }
-            connection = await connections.lookupConnection(connectionName);
-        }
-        // TODO is there a better way to handle this case? Just require StreamingConnections?
-        if (!connection.canStream()) {
-            throw new Error(`Connection '${connectionName}' cannot stream results.`);
-        }
-        let sql;
-        let resultExplore;
-        if (sqlStruct) {
-            resultExplore = new Explore(sqlStruct);
-            sql = sqlStruct.selectStr;
-        }
-        else if (preparedResult !== undefined) {
-            resultExplore = preparedResult.resultExplore;
-            sql = preparedResult.sql;
-        }
-        else {
-            throw new Error('Internal error: sqlStruct or preparedResult must be provided.');
-        }
-        let index = 0;
-        for await (const row of connection.runSQLStream(sql, options)) {
-            yield new DataRecord(row, index, resultExplore, undefined, undefined);
-            index += 1;
-        }
-    }
-    static async estimateQueryCost({ connections, preparedResult, sqlStruct, }) {
-        if (!connections) {
-            throw new Error('Internal Error: Connection or LookupConnection<Connection> must be provided.');
-        }
-        const connectionName = (sqlStruct === null || sqlStruct === void 0 ? void 0 : sqlStruct.connection) || (preparedResult === null || preparedResult === void 0 ? void 0 : preparedResult.connectionName);
-        const connection = await connections.lookupConnection(connectionName);
-        if (sqlStruct) {
-            return await connection.estimateQueryCost(sqlStruct.selectStr);
-        }
-        else if (preparedResult) {
-            return await connection.estimateQueryCost(preparedResult.sql);
-        }
-        else {
-            throw new Error('Internal error: sqlStruct or preparedResult must be provided.');
-        }
-    }
-}
-exports.Malloy = Malloy;
-/**
- * A Malloy error, which may contain log messages produced during compilation.
- */
-class MalloyError extends Error {
-    /**
-     * An array of log messages produced during compilation.
-     */
-    constructor(message, problems = []) {
-        super(message);
-        this.problems = problems;
-    }
-}
-exports.MalloyError = MalloyError;
-/**
- * A compiled Malloy document.
- */
-class Model {
-    constructor(modelDef, problems, fromSources) {
-        var _a, _b;
-        this.modelDef = modelDef;
-        this.problems = problems;
-        this.fromSources = fromSources;
-        this.references = new reference_list_1.ReferenceList((_a = fromSources[0]) !== null && _a !== void 0 ? _a : '', (_b = modelDef.references) !== null && _b !== void 0 ? _b : []);
-    }
-    tagParse(spec) {
-        return (0, annotation_1.annotationToTag)(this.modelDef.annotation, spec);
-    }
-    getTaglines(prefix) {
-        return (0, annotation_1.annotationToTaglines)(this.modelDef.annotation, prefix);
-    }
-    /**
-     * Retrieve a document reference for the token at the given position within
-     * the document that produced this model.
-     *
-     * @param position A position within the document.
-     * @return A `DocumentReference` at that position if one exists.
-     */
-    getReference(position) {
-        return this.references.find(position);
-    }
-    /**
-     * Retrieve an import for the token at the given position within
-     * the document that produced this model.
-     *
-     * @param position A position within the document.
-     * @return An `ImportLocation` at that position if one exists.
-     */
-    getImport(position) {
-        var _a;
-        return (_a = this.modelDef.imports) === null || _a === void 0 ? void 0 : _a.find(i => (0, utils_1.locationContainsPosition)(i.location, position));
-    }
-    /**
-     * Retrieve a prepared query by the name of a query at the top level of the model.
-     *
-     * @param queryName Name of the query to retrieve.
-     * @return A prepared query.
-     */
-    getPreparedQueryByName(queryName) {
-        const query = this.modelDef.contents[queryName];
-        if ((query === null || query === void 0 ? void 0 : query.type) === 'query') {
-            return new PreparedQuery(query, this.modelDef, this.problems, queryName);
-        }
-        throw new Error('Given query name does not refer to a named query.');
-    }
-    /**
-     * Retrieve a prepared query by the index of an unnamed query at the top level of a model.
-     *
-     * @param index The index of the query to retrieve.
-     * @return A prepared query.
-     */
-    getPreparedQueryByIndex(index) {
-        if (index < 0) {
-            throw new Error(`Invalid index ${index}.`);
-        }
-        else if (index >= this.modelDef.queryList.length) {
-            throw new Error(`Query index ${index} is out of bounds.`);
-        }
-        return new PreparedQuery(this.modelDef.queryList[index], this.modelDef, this.problems);
-    }
-    /**
-     * Retrieve a prepared query for the final unnamed query at the top level of a model.
-     *
-     * @return A prepared query.
-     */
-    get preparedQuery() {
-        return this.getPreparedQuery();
-    }
-    /**
-     * Retrieve a prepared query for the final unnamed query at the top level of a model.
-     *
-     * @return A prepared query.
-     */
-    getPreparedQuery() {
-        if (this.modelDef.queryList.length === 0) {
-            throw new Error('Model has no queries.');
-        }
-        return new PreparedQuery(this.modelDef.queryList[this.modelDef.queryList.length - 1], this.modelDef, this.problems);
-    }
-    /**
-     * Retrieve an `Explore` from the model by name.
-     *
-     * @param name The name of the `Explore` to retrieve.
-     * @return An `Explore`.
-     */
-    getExploreByName(name) {
-        const struct = this.modelDef.contents[name];
-        if (struct && (0, model_1.isSourceDef)(struct)) {
-            return new Explore(struct);
-        }
-        throw new Error("'name' is not an explore");
-    }
-    /**
-     * Get an array of `Explore`s contained in the model.
-     *
-     * @return An array of `Explore`s contained in the model.
-     */
-    get explores() {
-        return Object.values(this.modelDef.contents)
-            .filter(model_1.isSourceDef)
-            .map(structDef => new Explore(structDef));
-    }
-    /**
-     * Get an array of `NamedQuery`s contained in the model.
-     *
-     * @return An array of `NamedQuery`s contained in the model.
-     */
-    get namedQueries() {
-        const isNamedQuery = (object) => object.type === 'query';
-        return Object.values(this.modelDef.contents).filter(isNamedQuery);
-    }
-    get exportedExplores() {
-        return this.explores.filter(explore => this.modelDef.exports.includes(explore.name));
-    }
-    get _modelDef() {
-        return this.modelDef;
-    }
-}
-exports.Model = Model;
-/**
- * A prepared query which has all the necessary information to produce its SQL.
- */
-class PreparedQuery {
-    constructor(query, model, problems, name) {
-        this.problems = problems;
-        this.name = name;
-        this._query = query;
-        this._modelDef = model;
-    }
-    tagParse(spec) {
-        const modelScope = (0, annotation_1.annotationToTag)(this._modelDef.annotation).tag;
-        spec = (0, annotation_1.addModelScope)(spec, modelScope);
-        return (0, annotation_1.annotationToTag)(this._query.annotation, spec);
-    }
-    getTaglines(prefix) {
-        return (0, annotation_1.annotationToTaglines)(this._query.annotation, prefix);
-    }
-    /**
-     * Generate the SQL for this query.
-     *
-     * @return A fully-prepared query (which contains the generated SQL).
-     */
-    get preparedResult() {
-        return this.getPreparedResult();
-    }
-    /**
-     * Generate the SQL for this query.
-     *
-     * @return A fully-prepared query (which contains the generated SQL).
-     * @param options.eventStream An event stream to use when compiling the SQL
-     */
-    getPreparedResult(options) {
-        const queryModel = new model_1.QueryModel(this._modelDef, options === null || options === void 0 ? void 0 : options.eventStream);
-        const translatedQuery = queryModel.compileQuery(this._query, options);
-        return new PreparedResult({
-            ...translatedQuery,
-            queryName: this.name || translatedQuery.queryName,
-        }, this._modelDef);
-    }
-    get dialect() {
-        const sourceRef = this._query.structRef;
-        const source = typeof sourceRef === 'string'
-            ? this._modelDef.contents[sourceRef]
-            : sourceRef;
-        if (!(0, model_1.isSourceDef)(source)) {
-            throw new Error('Invalid source for query');
-        }
-        return source.dialect;
-    }
-    /**
-     * Get the flattened version of a query -- one that does not have a `pipeHead`.
-     * @deprecated Because queries can no longer have `pipeHead`s.
-     */
-    getFlattenedQuery(_defaultName) {
-        return this;
-    }
-}
-exports.PreparedQuery = PreparedQuery;
-/**
- * A parsed Malloy document.
- */
-class Parse {
-    constructor(translator, invalidationKey) {
-        this.translator = translator;
-        this.invalidationKey = invalidationKey;
-    }
-    /**
-     * Retrieve the symbols defined in the parsed document.
-     *
-     * These symbols represent any object defined (e.g. `Query`s and `Explore`s)
-     * in the document.
-     *
-     * @return An array of document symbols.
-     */
-    get symbols() {
-        return (this.translator.metadata().symbols || []).map(symbol => new DocumentSymbol(symbol));
-    }
-    /**
-     * Retrieve the full table paths for tables defined in the parsed document.
-     * Derived tables i.e. a table that extends another table, table from a query
-     * are not included.
-     *
-     * @return An array of document table path info.
-     */
-    get tablePathInfo() {
-        var _a;
-        const paths = (_a = this.translator.tablePathInfo().pathInfo) !== null && _a !== void 0 ? _a : [];
-        return paths.map(path => new DocumentTablePath(path));
-    }
-    get _translator() {
-        return this.translator;
-    }
-    get _invalidationKey() {
-        return this.invalidationKey;
-    }
-    completions(position) {
-        return (this.translator.completions(position).completions || []).map(completion => new DocumentCompletion(completion));
-    }
-    helpContext(position) {
-        return this.translator.helpContext(position).helpContext;
-    }
-}
-exports.Parse = Parse;
-/**
- * Path info for a table defined in a Malloy document.
- */
-class DocumentTablePath {
-    constructor(tablePath) {
-        this._range = DocumentRange.fromJSON(tablePath.range);
-        this._connectionId = tablePath.connectionId;
-        this._tablePath = tablePath.tablePath;
-    }
-    /**
-     * @return The range of characters in the source Malloy document that defines
-     * this table.
-     */
-    get range() {
-        return this._range;
-    }
-    /** @return The Connection Id for this table. */
-    get connectionId() {
-        return this._connectionId;
-    }
-    /** @return The full table path. */
-    get tablePath() {
-        return this._tablePath;
-    }
-}
-exports.DocumentTablePath = DocumentTablePath;
-/**
- * A range of characters within a Malloy document.
- */
-class DocumentRange {
-    constructor(start, end) {
-        this._start = start;
-        this._end = end;
-    }
-    /**
-     * @return The position of the first character in the range.
-     */
-    get start() {
-        return this._start;
-    }
-    /**
-     * @return The position of the last character in the range.
-     */
-    get end() {
-        return this._end;
-    }
-    /**
-     * @return This range in JSON format.
-     */
-    toJSON() {
-        return {
-            start: this.start.toJSON(),
-            end: this.end.toJSON(),
-        };
-    }
-    /**
-     * Construct a DocumentRange from JSON.
-     */
-    static fromJSON(json) {
-        return new DocumentRange(new DocumentPosition(json.start.line, json.start.character), new DocumentPosition(json.end.line, json.end.character));
-    }
-}
-exports.DocumentRange = DocumentRange;
-/**
- * A position within a Malloy document.
- */
-class DocumentPosition {
-    constructor(line, character) {
-        this._line = line;
-        this._character = character;
-    }
-    /**
-     * @return The line number of the position.
-     */
-    get line() {
-        return this._line;
-    }
-    /**
-     * @return The character index on the line `this.getLine()`.
-     */
-    get character() {
-        return this._character;
-    }
-    /**
-     * @return This position in JSON format.
-     */
-    toJSON() {
-        return { line: this.line, character: this.character };
-    }
-}
-exports.DocumentPosition = DocumentPosition;
-/**
- * A symbol defined in a Malloy document.
- *
- * Represents any object defined (e.g. `Query`s and `Explore`s) in the document.
- */
-class DocumentSymbol {
-    constructor(documentSymbol) {
-        this._range = DocumentRange.fromJSON(documentSymbol.range);
-        this._lensRange = documentSymbol.lensRange
-            ? DocumentRange.fromJSON(documentSymbol.lensRange)
-            : undefined;
-        this._type = documentSymbol.type;
-        this._name = documentSymbol.name;
-        this._children = documentSymbol.children.map(child => new DocumentSymbol(child));
-    }
-    /**
-     * @return The range of characters in the source Malloy document that define this symbol.
-     */
-    get range() {
-        return this._range;
-    }
-    /**
-     * @return The range of characters in the source Malloy document that define this symbol,
-     * including tags. Note: "block tags" are included if there is exactly one
-     * definition in the block.
-     */
-    get lensRange() {
-        var _a;
-        return (_a = this._lensRange) !== null && _a !== void 0 ? _a : this._range;
-    }
-    /**
-     * @return The type of symbol.
-     *
-     * Possible values are: `"explore"`, `"query"`, `"field"`, `"turtle"`, `"join"`, or `"unnamed_query"`.
-     */
-    get type() {
-        return this._type;
-    }
-    /**
-     * @return The name of this symbol, e.g. the `Explore` name or `Query` name.
-     *
-     * For type `"unnamed_query"`, `getName()` is `"unnamed_query"`.
-     */
-    get name() {
-        return this._name;
-    }
-    /**
-     * @return An array of document symbols defined inside this document symbol,
-     * e.g. fields in an `Explore`.
-     */
-    get children() {
-        return this._children;
-    }
-}
-exports.DocumentSymbol = DocumentSymbol;
-class DocumentCompletion {
-    constructor(completion) {
-        this.type = completion.type;
-        this.text = completion.text;
-    }
-}
-exports.DocumentCompletion = DocumentCompletion;
-/**
- * A fully-prepared query containing SQL and metadata required to run the query.
- */
-class PreparedResult {
-    constructor(query, modelDef) {
-        this.modelDef = modelDef;
-        this.inner = query;
-    }
-    static fromJson({ query, modelDef, }) {
-        // Validate extracted properties (optional, but recommended)
-        if (!query || !modelDef) {
-            throw new Error('Missing required properties in JSON data');
-        }
-        return new PreparedResult(query, modelDef);
-    }
-    tagParse(spec) {
-        const modelScope = (0, annotation_1.annotationToTag)(this.modelDef.annotation).tag;
-        spec = (0, annotation_1.addModelScope)(spec, modelScope);
-        return (0, annotation_1.annotationToTag)(this.inner.annotation, spec);
-    }
-    getTaglines(prefix) {
-        return (0, annotation_1.annotationToTaglines)(this.inner.annotation, prefix);
-    }
-    get annotation() {
-        return this.inner.annotation;
-    }
-    get modelAnnotation() {
-        return this.modelDef.annotation;
-    }
-    get modelTag() {
-        return (0, annotation_1.annotationToTag)(this.modelDef.annotation).tag;
-    }
-    /**
-     * @return The name of the connection this query should be run against.
-     */
-    get connectionName() {
-        return this.inner.connectionName;
-    }
-    get _rawQuery() {
-        return this.inner;
-    }
-    get _modelDef() {
-        return this.modelDef;
-    }
-    /**
-     * @return The SQL that should be run against the SQL runner
-     * with the connection name `this.getConnectionName()`.
-     */
-    get sql() {
-        return this.inner.sql;
-    }
-    get dependenciesToMaterialize() {
-        return this.inner.dependenciesToMaterialize;
-    }
-    get materialization() {
-        return this.inner.materialization;
-    }
-    /**
-     * @return The `Explore` representing the data that will be returned by running this query.
-     */
-    get resultExplore() {
-        if (this.inner.structs.length === 0) {
-            throw new Error('Malformed query result.');
-        }
-        const explore = this.inner.structs[this.inner.structs.length - 1];
-        const namedExplore = {
-            ...explore,
-            annotation: this.inner.annotation,
-            name: this.inner.queryName || explore.name,
-        };
-        // TODO `sourceExplore` is not fully-implemented yet -- it cannot
-        //      handle cases where the source of the query is something other than
-        //      a named explore.
-        try {
-            return new Explore(namedExplore, this.sourceExplore);
-        }
-        catch (error) {
-            return new Explore(namedExplore);
-        }
-    }
-    get sourceExplore() {
-        const name = this.inner.sourceExplore;
-        const explore = this.modelDef.contents[name];
-        if (explore && (0, model_1.isSourceDef)(explore)) {
-            return new Explore(explore);
-        }
-    }
-    get _sourceExploreName() {
-        return this.inner.sourceExplore;
-    }
-    get _sourceArguments() {
-        return this.inner.sourceArguments;
-    }
-    get _sourceFilters() {
-        return this.inner.sourceFilters || [];
-    }
-    /**
-     * @return Whether this result has a schema. DDL statements (INSTALL, LOAD,
-     * CREATE SECRET, etc.) do not return a schema.
-     */
-    get hasSchema() {
-        return this.inner.structs.length > 0;
-    }
-}
-exports.PreparedResult = PreparedResult;
-/**
- * A URL reader which always throws an error when a URL's contents is requested.
- *
- * Useful for scenarios in which `import` statements are not required.
- */
-class EmptyURLReader {
-    async readURL(_url) {
-        throw new Error('No files.');
-    }
-    async getInvalidationKey(_url) {
-        throw new Error('No files.');
-    }
-}
-exports.EmptyURLReader = EmptyURLReader;
-/**
- * A URL reader backed by an in-memory mapping of URL contents.
- */
-class InMemoryURLReader {
-    constructor(files) {
-        this.files = files;
-    }
-    async readURL(url) {
-        const file = this.files.get(url.toString());
-        if (file !== undefined) {
-            return Promise.resolve({
-                contents: file,
-                invalidationKey: this.invalidationKey(url, file),
-            });
-        }
-        else {
-            throw new Error(`File not found '${url}'`);
-        }
-    }
-    async getInvalidationKey(url) {
-        const file = this.files.get(url.toString());
-        if (file !== undefined) {
-            return Promise.resolve(this.invalidationKey(url, file));
-        }
-        else {
-            throw new Error(`File not found '${url}'`);
-        }
-    }
-    invalidationKey(url, contents) {
-        if (isInternalURL(url.toString())) {
-            return null;
-        }
-        return hashForInvalidationKey(contents);
-    }
-}
-exports.InMemoryURLReader = InMemoryURLReader;
-/**
- * A fixed mapping of connection names to connections.
- */
-class FixedConnectionMap {
-    constructor(connections, defaultConnectionName) {
-        this.connections = connections;
-        this.defaultConnectionName = defaultConnectionName;
-    }
-    /**
-     * Get a connection by name.
-     *
-     * @param connectionName The name of the connection to look up.
-     * @return A `Connection`
-     * @throws An `Error` if no connection with the given name exists.
-     */
-    async getConnection(connectionName) {
-        if (connectionName === undefined) {
-            if (this.defaultConnectionName !== undefined) {
-                connectionName = this.defaultConnectionName;
-            }
-            else {
-                throw new Error('No default connection.');
-            }
-        }
-        const connection = this.connections.get(connectionName);
-        if (connection !== undefined) {
-            return Promise.resolve(connection);
-        }
-        else {
-            throw new Error(`No connection found with name ${connectionName}.`);
-        }
-    }
-    /**
-     * Gets a list of registered connections.
-     *
-     * @return The list of registered connections.
-     */
-    listConnections() {
-        return Array.from(this.connections.values());
-    }
-    async lookupConnection(connectionName) {
-        return this.getConnection(connectionName);
-    }
-    static fromArray(connections) {
-        return new FixedConnectionMap(new Map(connections.map(connection => [connection.name, connection])));
-    }
-}
-exports.FixedConnectionMap = FixedConnectionMap;
-/**
- * The relationship of an `Explore` to its source.
- */
-var SourceRelationship;
-(function (SourceRelationship) {
-    /**
-     * The `Explore` is nested data within the source's rows.
-     */
-    SourceRelationship["Nested"] = "nested";
-    /**
-     * The `Explore` is the base table.
-     */
-    SourceRelationship["BaseTable"] = "base_table";
-    /**
-     * The `Explore` is joined to its source
-     */
-    SourceRelationship["Cross"] = "cross";
-    SourceRelationship["One"] = "one";
-    SourceRelationship["Many"] = "many";
-    // TODO document this
-    SourceRelationship["Inline"] = "inline";
-})(SourceRelationship || (exports.SourceRelationship = SourceRelationship = {}));
-class Entity {
-    constructor(name, parent, source) {
-        this._name = name;
-        this._parent = parent;
-        this._source = source;
-    }
-    get source() {
-        return this.source;
-    }
-    get name() {
-        return this._name;
-    }
-    get sourceClasses() {
-        const sourceClasses = [];
-        if (this.source) {
-            sourceClasses.push(this.source.name);
-        }
-        sourceClasses.push(this.name);
-        return sourceClasses;
-    }
-    get fieldPath() {
-        const path = [this.name];
-        let f = this._parent;
-        while (f) {
-            path.unshift(f.name);
-            f = f._parent;
-        }
-        return path;
-    }
-    hasParentExplore() {
-        return this._parent !== undefined;
-    }
-    isExplore() {
-        return this instanceof Explore;
-    }
-    isQuery() {
-        return this instanceof QueryField;
-    }
-}
-class Explore extends Entity {
-    constructor(structDef, parentExplore, source) {
-        super(structDef.as || structDef.name, parentExplore, source);
-        this._structDef = structDef;
-        this._parentExplore = parentExplore;
-        this.sourceExplore = source;
-    }
-    get source() {
-        return this.sourceExplore;
-    }
-    isIntrinsic() {
-        // Don't have the right discriminator, if this was a field def at some point, the field-defness ahs been lost.
-        // A record or an array might be atomic, AND be a structdef, unless they are a dimension (i.e. have a an
-        // expression)
-        if ((0, model_1.isAtomicFieldType)(this._structDef.type)) {
-            return !('e' in this._structDef);
-        }
-        return false;
-    }
-    isExploreField() {
-        return false;
-    }
-    tagParse(spec) {
-        return (0, annotation_1.annotationToTag)(this._structDef.annotation, spec);
-    }
-    getTaglines(prefix) {
-        return (0, annotation_1.annotationToTaglines)(this._structDef.annotation, prefix);
-    }
-    get modelTag() {
-        this.parsedModelTag || (this.parsedModelTag = (0, annotation_1.annotationToTag)(this._structDef.modelAnnotation).tag);
-        return this.parsedModelTag;
-    }
-    /**
-     * @return The name of the entity.
-     */
-    get name() {
-        return this.structDef.as || this.structDef.name;
-    }
-    getQueryByName(name) {
-        const structRef = this.sourceStructDef;
-        if (!structRef) {
-            throw new Error(`Cannot get query by name from a struct of type ${this.structDef.type}`);
-        }
-        const view = structRef.fields.find(f => { var _a; return ((_a = f.as) !== null && _a !== void 0 ? _a : f.name) === name; });
-        if (view === undefined) {
-            throw new Error(`No such view named \`${name}\``);
-        }
-        if (view.type !== 'turtle') {
-            throw new Error(`\`${name}\` is not a view`);
-        }
-        const internalQuery = {
-            type: 'query',
-            structRef,
-            pipeline: view.pipeline,
-        };
-        return new PreparedQuery(internalQuery, this.modelDef, [], name);
-    }
-    get modelDef() {
-        if (!(0, model_1.isSourceDef)(this.structDef)) {
-            throw new Error(`Cannot create pseudo model for struct type ${this.structDef.type}`);
-        }
-        return {
-            name: 'generated_model',
-            exports: [],
-            contents: { [this.structDef.name]: this.structDef },
-            queryList: [],
-            dependencies: {},
-        };
-    }
-    getSingleExploreModel() {
-        return new Model(this.modelDef, [], []);
-    }
-    get fieldMap() {
-        var _a;
-        if (this._fieldMap === undefined) {
-            const sourceFields = ((_a = this.source) === null || _a === void 0 ? void 0 : _a.fieldMap) || new Map();
-            this._fieldMap = new Map(this.structDef.fields.map(fieldDef => {
-                const name = fieldDef.as || fieldDef.name;
-                const sourceField = sourceFields.get(fieldDef.name);
-                if ((0, model_1.isJoined)(fieldDef)) {
-                    return [name, new ExploreField(fieldDef, this, sourceField)];
-                }
-                else if (fieldDef.type === 'turtle') {
-                    return [name, new QueryField(fieldDef, this, sourceField)];
-                }
-                else {
-                    if (fieldDef.type === 'string') {
-                        return [name, new StringField(fieldDef, this, sourceField)];
-                    }
-                    else if (fieldDef.type === 'number') {
-                        return [name, new NumberField(fieldDef, this, sourceField)];
-                    }
-                    else if (fieldDef.type === 'date') {
-                        // TODO this is a hack
-                        // Is this a bug? The extraction functions don't seem like they should return a
-                        // field of type "date". Rather, they should be of type "number".
-                        if (fieldDef.timeframe &&
-                            ['day_of_month', 'day_of_week', 'day_of_year'].includes(fieldDef.timeframe)) {
-                            return [
-                                name,
-                                new NumberField({ ...fieldDef, type: 'number' }, this, sourceField),
-                            ];
-                        }
-                        return [name, new DateField(fieldDef, this, sourceField)];
-                    }
-                    else if (fieldDef.type === 'timestamp') {
-                        return [name, new TimestampField(fieldDef, this, sourceField)];
-                    }
-                    else if (fieldDef.type === 'timestamptz') {
-                        return [name, new TimestampField(fieldDef, this, sourceField)];
-                    }
-                    else if (fieldDef.type === 'boolean') {
-                        return [name, new BooleanField(fieldDef, this, sourceField)];
-                    }
-                    else if (fieldDef.type === 'json') {
-                        return [name, new JSONField(fieldDef, this, sourceField)];
-                    }
-                    else if (fieldDef.type === 'sql native') {
-                        return [name, new UnsupportedField(fieldDef, this, sourceField)];
-                    }
-                }
-            }));
-        }
-        return this._fieldMap;
-    }
-    get allFields() {
-        return [...this.fieldMap.values()];
-    }
-    get allFieldsWithOrder() {
-        var _a, _b, _c;
-        if (!this._allFieldsWithOrder) {
-            const orderByFields = [
-                ...(((_c = (_b = (_a = this.sourceStructDef) === null || _a === void 0 ? void 0 : _a.resultMetadata) === null || _b === void 0 ? void 0 : _b.orderBy) === null || _c === void 0 ? void 0 : _c.map(f => {
-                    if (typeof f.field === 'string') {
-                        const a = {
-                            field: this.fieldMap.get(f.field),
-                            dir: f.dir,
-                        };
-                        return a;
-                    }
-                    throw new Error('Does not support mapping order by from number.');
-                })) || []),
-            ];
-            const orderByFieldSet = new Set(orderByFields.map(f => f.field.name));
-            this._allFieldsWithOrder = [
-                ...orderByFields,
-                ...this.allFields
-                    .filter(f => !orderByFieldSet.has(f.name))
-                    .map(field => {
-                    return {
-                        field,
-                        dir: 'asc',
-                    };
-                }),
-            ];
-        }
-        return this._allFieldsWithOrder;
-    }
-    get intrinsicFields() {
-        return [...this.fieldMap.values()].filter(f => f.isIntrinsic());
-    }
-    get dimensions() {
-        return [...this.allFieldsWithOrder].filter(f => f.field.isAtomicField() && f.field.sourceWasDimension());
-    }
-    getFieldByName(fieldName) {
-        const field = this.fieldMap.get(fieldName);
-        if (field === undefined) {
-            throw new Error(`No such field ${fieldName}.`);
-        }
-        return field;
-    }
-    getFieldByNameIfExists(fieldName) {
-        return this.fieldMap.get(fieldName);
-    }
-    get primaryKey() {
-        var _a;
-        return (_a = this.sourceStructDef) === null || _a === void 0 ? void 0 : _a.primaryKey;
-    }
-    get parentExplore() {
-        return this._parentExplore;
-    }
-    hasParentExplore() {
-        return this instanceof ExploreField;
-    }
-    // TODO wrapper type for FilterCondition
-    get filters() {
-        var _a;
-        if ((0, model_1.isSourceDef)(this.structDef)) {
-            return ((_a = this.structDef.resultMetadata) === null || _a === void 0 ? void 0 : _a.filterList) || [];
-        }
-        return [];
-    }
-    get limit() {
-        var _a, _b;
-        return (_b = (_a = this.sourceStructDef) === null || _a === void 0 ? void 0 : _a.resultMetadata) === null || _b === void 0 ? void 0 : _b.limit;
-    }
-    get structDef() {
-        return this._structDef;
-    }
-    get queryTimezone() {
-        var _a;
-        return (_a = this.sourceStructDef) === null || _a === void 0 ? void 0 : _a.queryTimezone;
-    }
-    get sourceStructDef() {
-        if ((0, model_1.isSourceDef)(this.structDef)) {
-            return this.structDef;
-        }
-    }
-    toJSON() {
-        var _a, _b;
-        return {
-            _structDef: this._structDef,
-            sourceExplore: (_a = this.sourceExplore) === null || _a === void 0 ? void 0 : _a.toJSON(),
-            _parentExplore: (_b = this._parentExplore) === null || _b === void 0 ? void 0 : _b.toJSON(),
-        };
-    }
-    static fromJSON(main_explore) {
-        const parentExplore = main_explore._parentExplore !== undefined
-            ? Explore.fromJSON(main_explore._parentExplore)
-            : undefined;
-        const sourceExplore = main_explore.sourceExplore !== undefined
-            ? Explore.fromJSON(main_explore.sourceExplore)
-            : undefined;
-        return new Explore(main_explore._structDef, parentExplore, sourceExplore);
-    }
-    get location() {
-        return this.structDef.location;
-    }
-    collectSourceComponents(structDef) {
-        const sources = [];
-        if (structDef.type === 'composite') {
-            for (const source of structDef.sources) {
-                sources.push(...this.collectSourceComponents(source));
-            }
-            return sources;
-        }
-        if (isSourceComponent(structDef)) {
-            if (structDef.type === 'table') {
-                // Generate componentID based on connection and table name
-                sources.push({
-                    type: 'table',
-                    tableName: structDef.tablePath,
-                    componentID: `${structDef.connection}:${structDef.tablePath}`,
-                    sourceID: `${structDef.connection}:${structDef.tablePath}`,
-                });
-            }
-            else if (structDef.type === 'sql_select') {
-                sources.push({
-                    type: 'sql',
-                    selectStatement: structDef.selectStr,
-                    componentID: `${structDef.connection}:${structDef.selectStr}`,
-                    sourceID: `${structDef.connection}:${structDef.selectStr}`,
-                });
-            }
-            else if (structDef.type === 'query_source') {
-                // For QuerySourceDef, we need to extract the SQL from the query
-                // We need to create a PreparedQuery from the query, then get a PreparedResult
-                // to access the SQL
-                let sql;
-                try {
-                    // Create a PreparedQuery from the query in the QuerySourceDef
-                    const preparedQuery = new PreparedQuery(structDef.query, this.modelDef, []);
-                    // Get the PreparedResult which contains the SQL
-                    const preparedResult = preparedQuery.getPreparedResult();
-                    // Extract the SQL
-                    sql = preparedResult.sql;
-                }
-                catch (error) {
-                    // If we can't compile the query, use a placeholder
-                    sql = `-- Could not compile SQL for query ${structDef.query.name || 'unnamed query'}: ${error instanceof Error ? error.message : String(error)}`;
-                }
-                // Generate componentID based on connection and SQL
-                const componentID = `${structDef.connection}:${sql}`;
-                sources.push({
-                    type: 'sql',
-                    selectStatement: sql,
-                    componentID: componentID,
-                    sourceID: componentID,
-                });
-            }
-        }
-        else {
-            return [];
-        }
-        // Process all fields to find joins
-        for (const field of structDef.fields) {
-            if ((0, model_1.isJoined)(field)) {
-                sources.push(...this.collectSourceComponents(field));
-            }
-        }
-        return sources;
-    }
-    /**
-     * THIS IS A HIGHLY EXPERIMENTAL API AND MAY VANISH OR CHANGE WITHOUT NOTICE
-     */
-    getSourceComponents() {
-        const uniqueSources = {};
-        if ((0, model_1.isSourceDef)(this.structDef)) {
-            const allSources = this.collectSourceComponents(this.structDef);
-            // Deduplicate sources using componentID as the key
-            for (const source of allSources) {
-                if (source.componentID) {
-                    uniqueSources[source.componentID] = source;
-                }
-                else if (source.sourceID) {
-                    uniqueSources[source.sourceID] = source;
-                }
-            }
-        }
-        // Return the deduplicated sources as an array
-        return Object.values(uniqueSources);
-    }
-}
-exports.Explore = Explore;
-var AtomicFieldType;
-(function (AtomicFieldType) {
-    AtomicFieldType["String"] = "string";
-    AtomicFieldType["Number"] = "number";
-    AtomicFieldType["Boolean"] = "boolean";
-    AtomicFieldType["Date"] = "date";
-    AtomicFieldType["Timestamp"] = "timestamp";
-    AtomicFieldType["Timestamptz"] = "timestamptz";
-    AtomicFieldType["Json"] = "json";
-    AtomicFieldType["NativeUnsupported"] = "sql native";
-    AtomicFieldType["Error"] = "error";
-})(AtomicFieldType || (exports.AtomicFieldType = AtomicFieldType = {}));
-class AtomicField extends Entity {
-    constructor(fieldTypeDef, parent, source) {
-        super(fieldTypeDef.as || fieldTypeDef.name, parent, source);
-        this.fieldTypeDef = fieldTypeDef;
-        this.parent = parent;
-    }
-    get type() {
-        switch (this.fieldTypeDef.type) {
-            case 'string':
-                return AtomicFieldType.String;
-            case 'boolean':
-                return AtomicFieldType.Boolean;
-            case 'date':
-                return AtomicFieldType.Date;
-            case 'timestamp':
-                return AtomicFieldType.Timestamp;
-            case 'timestamptz':
-                return AtomicFieldType.Timestamptz;
-            case 'number':
-                return AtomicFieldType.Number;
-            case 'json':
-                return AtomicFieldType.Json;
-            case 'sql native':
-                return AtomicFieldType.NativeUnsupported;
-            case 'error':
-                return AtomicFieldType.Error;
-            case 'record':
-            case 'array':
-                throw new Error(`MTOY TODO IMPLEMENT Atomic ${this.fieldTypeDef.type}`);
-            default: {
-                const x = this.fieldTypeDef;
-                throw new Error(`Can't make an atomic field from ${x}`);
-            }
-        }
-    }
-    tagParse(spec) {
-        spec = (0, annotation_1.addModelScope)(spec, this.parent.modelTag);
-        return (0, annotation_1.annotationToTag)(this.fieldTypeDef.annotation, spec);
-    }
-    getTaglines(prefix) {
-        return (0, annotation_1.annotationToTaglines)(this.fieldTypeDef.annotation, prefix);
-    }
-    isIntrinsic() {
-        return (0, model_1.fieldIsIntrinsic)(this.fieldTypeDef);
-    }
-    isQueryField() {
-        return false;
-    }
-    isExploreField() {
-        return false;
-    }
-    isAtomicField() {
-        return true;
-    }
-    isCalculation() {
-        //return !!this.fieldTypeDef.aggregate;
-        return (0, model_1.expressionIsCalculation)(this.fieldTypeDef.expressionType);
-    }
-    get sourceField() {
-        // TODO
-        throw new Error();
-    }
-    get sourceClasses() {
-        const sourceField = this.fieldTypeDef.name || this.fieldTypeDef.as;
-        return sourceField ? [sourceField] : [];
-    }
-    /**
-     * A unique ID of this field within the context of a result; undefined
-     * for fields that are not derived from a Result.
-     */
-    get referenceId() {
-        var _a;
-        return (_a = this.fieldTypeDef.resultMetadata) === null || _a === void 0 ? void 0 : _a.referenceId;
-    }
-    // was the field generated from a measure in the previous query
-    sourceWasMeasure() {
-        var _a;
-        return ((_a = this.fieldTypeDef.resultMetadata) === null || _a === void 0 ? void 0 : _a.fieldKind) === 'measure';
-    }
-    sourceWasMeasureLike() {
-        var _a, _b;
-        return (((_a = this.fieldTypeDef.resultMetadata) === null || _a === void 0 ? void 0 : _a.fieldKind) === 'measure' ||
-            ((_b = this.fieldTypeDef.resultMetadata) === null || _b === void 0 ? void 0 : _b.fieldKind) === 'struct');
-    }
-    sourceWasDimension() {
-        var _a;
-        return ((_a = this.fieldTypeDef.resultMetadata) === null || _a === void 0 ? void 0 : _a.fieldKind) === 'dimension';
-    }
-    hasParentExplore() {
-        return true;
-    }
-    isString() {
-        return this instanceof StringField;
-    }
-    isNumber() {
-        return this instanceof NumberField;
-    }
-    isDate() {
-        return this instanceof DateField;
-    }
-    isBoolean() {
-        return this instanceof BooleanField;
-    }
-    isJSON() {
-        return this instanceof JSONField;
-    }
-    isTimestamp() {
-        return this instanceof TimestampField;
-    }
-    isUnsupported() {
-        return this instanceof UnsupportedField;
-    }
-    get parentExplore() {
-        return this.parent;
-    }
-    /**
-     * @return Field name for drill.
-     */
-    get expression() {
-        const dot = '.';
-        const resultMetadata = this.fieldTypeDef.resultMetadata;
-        // If field is joined-in from another table i.e. of type `tableName.columnName`,
-        // return sourceField, else return name because this could be a renamed field.
-        return ((resultMetadata === null || resultMetadata === void 0 ? void 0 : resultMetadata.sourceExpression) ||
-            ((resultMetadata === null || resultMetadata === void 0 ? void 0 : resultMetadata.sourceField.includes(dot))
-                ? resultMetadata === null || resultMetadata === void 0 ? void 0 : resultMetadata.sourceField
-                : this.name));
-    }
-    get location() {
-        return this.fieldTypeDef.location;
-    }
-}
-exports.AtomicField = AtomicField;
-var DateTimeframe;
-(function (DateTimeframe) {
-    DateTimeframe["Day"] = "day";
-    DateTimeframe["Week"] = "week";
-    DateTimeframe["Month"] = "month";
-    DateTimeframe["Quarter"] = "quarter";
-    DateTimeframe["Year"] = "year";
-})(DateTimeframe || (exports.DateTimeframe = DateTimeframe = {}));
-var TimestampTimeframe;
-(function (TimestampTimeframe) {
-    TimestampTimeframe["Day"] = "day";
-    TimestampTimeframe["Week"] = "week";
-    TimestampTimeframe["Month"] = "month";
-    TimestampTimeframe["Quarter"] = "quarter";
-    TimestampTimeframe["Year"] = "year";
-    TimestampTimeframe["Second"] = "second";
-    TimestampTimeframe["Hour"] = "hour";
-    TimestampTimeframe["Minute"] = "minute";
-})(TimestampTimeframe || (exports.TimestampTimeframe = TimestampTimeframe = {}));
-class DateField extends AtomicField {
-    constructor(fieldDateDef, parent, source) {
-        super(fieldDateDef, parent, source);
-        this.fieldDateDef = fieldDateDef;
-    }
-    get timeframe() {
-        if (this.fieldDateDef.timeframe === undefined) {
-            return undefined;
-        }
-        switch (this.fieldDateDef.timeframe) {
-            case 'day':
-                return DateTimeframe.Day;
-            case 'week':
-                return DateTimeframe.Week;
-            case 'month':
-                return DateTimeframe.Month;
-            case 'quarter':
-                return DateTimeframe.Quarter;
-            case 'year':
-                return DateTimeframe.Year;
-        }
-    }
-}
-exports.DateField = DateField;
-class TimestampField extends AtomicField {
-    constructor(fieldTimestampDef, parent, source) {
-        super(fieldTimestampDef, parent, source);
-        this.fieldTimestampDef = fieldTimestampDef;
-    }
-    get timeframe() {
-        if (this.fieldTimestampDef.timeframe === undefined) {
-            return undefined;
-        }
-        switch (this.fieldTimestampDef.timeframe) {
-            case 'day':
-                return TimestampTimeframe.Day;
-            case 'week':
-                return TimestampTimeframe.Week;
-            case 'month':
-                return TimestampTimeframe.Month;
-            case 'quarter':
-                return TimestampTimeframe.Quarter;
-            case 'year':
-                return TimestampTimeframe.Year;
-            case 'second':
-                return TimestampTimeframe.Second;
-            case 'hour':
-                return TimestampTimeframe.Hour;
-            case 'minute':
-                return TimestampTimeframe.Minute;
-        }
-    }
-}
-exports.TimestampField = TimestampField;
-class NumberField extends AtomicField {
-    constructor(fieldNumberDef, parent, source) {
-        super(fieldNumberDef, parent, source);
-        this.fieldNumberDef = fieldNumberDef;
-    }
-}
-exports.NumberField = NumberField;
-class BooleanField extends AtomicField {
-    constructor(fieldBooleanDef, parent, source) {
-        super(fieldBooleanDef, parent, source);
-        this.fieldBooleanDef = fieldBooleanDef;
-    }
-}
-exports.BooleanField = BooleanField;
-class JSONField extends AtomicField {
-    constructor(fieldJSONDef, parent, source) {
-        super(fieldJSONDef, parent, source);
-        this.fieldJSONDef = fieldJSONDef;
-    }
-}
-exports.JSONField = JSONField;
-class UnsupportedField extends AtomicField {
-    constructor(fieldUnsupportedDef, parent, source) {
-        super(fieldUnsupportedDef, parent, source);
-        this.fieldUnsupportedDef = fieldUnsupportedDef;
-    }
-    get rawType() {
-        return this.fieldUnsupportedDef.rawType;
-    }
-}
-exports.UnsupportedField = UnsupportedField;
-class StringField extends AtomicField {
-    constructor(fieldStringDef, parent, source) {
-        super(fieldStringDef, parent, source);
-        this.fieldStringDef = fieldStringDef;
-    }
-}
-exports.StringField = StringField;
-class Query extends Entity {
-    constructor(turtleDef, parent, source) {
-        super(turtleDef.as || turtleDef.name, parent, source);
-        this.turtleDef = turtleDef;
-    }
-    get source() {
-        return this.sourceQuery;
-    }
-    isIntrinsic() {
-        return false;
-    }
-    get location() {
-        return this.turtleDef.location;
-    }
-}
-exports.Query = Query;
-class QueryField extends Query {
-    constructor(turtleDef, parent, source) {
-        super(turtleDef, parent, source);
-        this.parent = parent;
-    }
-    tagParse(spec) {
-        spec = (0, annotation_1.addModelScope)(spec, this.parent.modelTag);
-        return (0, annotation_1.annotationToTag)(this.turtleDef.annotation, spec);
-    }
-    getTaglines(prefix) {
-        return (0, annotation_1.annotationToTaglines)(this.turtleDef.annotation, prefix);
-    }
-    isQueryField() {
-        return true;
-    }
-    isExploreField() {
-        return false;
-    }
-    isAtomicField() {
-        return false;
-    }
-    get sourceClasses() {
-        const sourceField = this.turtleDef.name || this.turtleDef.as;
-        return sourceField ? [sourceField] : [];
-    }
-    hasParentExplore() {
-        return true;
-    }
-    get parentExplore() {
-        return this.parent;
-    }
-    get expression() {
-        return this.name;
-    }
-}
-exports.QueryField = QueryField;
-var JoinRelationship;
-(function (JoinRelationship) {
-    JoinRelationship["OneToOne"] = "one_to_one";
-    JoinRelationship["OneToMany"] = "one_to_many";
-    JoinRelationship["ManyToOne"] = "many_to_one";
-})(JoinRelationship || (exports.JoinRelationship = JoinRelationship = {}));
-class ExploreField extends Explore {
-    constructor(structDef, parentExplore, source) {
-        super(structDef, parentExplore, source);
-        this._parentExplore = parentExplore;
-    }
-    get joinRelationship() {
-        if ((0, model_1.isJoined)(this.structDef)) {
-            switch (this.structDef.join) {
-                case 'one':
-                    return JoinRelationship.OneToOne;
-                case 'many':
-                case 'cross':
-                    return JoinRelationship.ManyToOne;
-            }
-        }
-        throw new Error('A source field must have a join relationship.');
-    }
-    get isRecord() {
-        return this.joinRelationship === JoinRelationship.OneToOne;
-    }
-    get isArray() {
-        return this.joinRelationship !== JoinRelationship.OneToOne;
-    }
-    tagParse(spec) {
-        spec = (0, annotation_1.addModelScope)(spec, this._parentExplore.modelTag);
-        return (0, annotation_1.annotationToTag)(this._structDef.annotation, spec);
-    }
-    isQueryField() {
-        return false;
-    }
-    isExploreField() {
-        return true;
-    }
-    isAtomicField() {
-        return false;
-    }
-    get parentExplore() {
-        return this._parentExplore;
-    }
-    get sourceClasses() {
-        const sourceField = this.structDef.name || this.structDef.as;
-        return sourceField ? [sourceField] : [];
-    }
-    get queryTimezone() {
-        // For ExploreField, check the structDef directly first
-        if ((0, model_1.isRecordOrRepeatedRecord)(this._structDef)) {
-            return this._structDef.queryTimezone;
-        }
-        // Fall back to the parent implementation
-        return super.queryTimezone;
-    }
-}
-exports.ExploreField = ExploreField;
-/**
- * An environment for compiling and running Malloy queries.
- */
-class Runtime {
-    constructor({ urlReader, connections, connection, eventStream, cacheManager, }) {
-        this.isTestRuntime = false;
-        if (connections === undefined) {
-            if (connection === undefined) {
-                throw new Error('A LookupConnection<Connection> or Connection is required.');
-            }
-            connections = {
-                lookupConnection: () => Promise.resolve(connection),
-            };
-        }
-        if (urlReader === undefined) {
-            urlReader = new EmptyURLReader();
-        }
-        this._urlReader = urlReader;
-        this._connections = connections;
-        this._eventStream = eventStream;
-        this._cacheManager = cacheManager;
-    }
-    /**
-     * @return The `CacheManager` for this runtime instance.
-     */
-    get cacheManager() {
-        return this._cacheManager;
-    }
-    /**
-     * @return The `URLReader` for this runtime instance.
-     */
-    get urlReader() {
-        return this._urlReader;
-    }
-    /**
-     * @return The `LookupConnection<Connection>` for this runtime instance.
-     */
-    get connections() {
-        return this._connections;
-    }
-    /**
-     * @return The `EventStream` for this runtime instance.
-     */
-    get eventStream() {
-        return this._eventStream;
-    }
-    /**
-     * Load a Malloy model by URL or contents.
-     *
-     * @param source The model URL or contents to load and (eventually) compile.
-     * @return A `ModelMaterializer` capable of materializing the requested model,
-     * or loading further related objects.
-     */
-    loadModel(source, options) {
-        const { refreshSchemaCache, noThrowOnError } = options || {};
-        if (this.isTestRuntime) {
-            if (options === undefined) {
-                options = { testEnvironment: true };
-            }
-            else {
-                options = { ...options, testEnvironment: true };
-            }
-        }
-        const compilable = source instanceof URL ? { url: source } : { source };
-        return new ModelMaterializer(this, async () => {
-            return Malloy.compile({
-                ...compilable,
-                urlReader: this.urlReader,
-                connections: this.connections,
-                refreshSchemaCache,
-                noThrowOnError,
-                eventStream: this.eventStream,
-                replaceMaterializedReferences: options === null || options === void 0 ? void 0 : options.replaceMaterializedReferences,
-                materializedTablePrefix: options === null || options === void 0 ? void 0 : options.materializedTablePrefix,
-                importBaseURL: options === null || options === void 0 ? void 0 : options.importBaseURL,
-                testEnvironment: options === null || options === void 0 ? void 0 : options.testEnvironment,
-                cacheManager: this.cacheManager,
-            });
-        }, options);
-    }
-    // TODO Consider formalizing this. Perhaps as a `withModel` method,
-    //      as well as a `Model.fromModelDefinition` if we choose to expose
-    //      `ModelDef` to the world formally. For now, this should only
-    //      be used in tests.
-    _loadModelFromModelDef(modelDef, options) {
-        return new ModelMaterializer(this, async () => {
-            return new Model(modelDef, [], []);
-        }, options);
-    }
-    /**
-     * Load a Malloy query by URL or contents.
-     *
-     * @param query The query URL or contents to load and (eventually) compile.
-     * @return A `QueryMaterializer` capable of materializing the requested query, running it,
-     * or loading further related objects.
-     */
-    loadQuery(query, options) {
-        return this.loadModel(query, options).loadFinalQuery();
-    }
-    /**
-     * Load a Malloy query by the URL or contents of a Malloy model document
-     * and the index of an unnamed query contained in the model.
-     *
-     * @param model The model URL or contents to load and (eventually) compile to retrieve the requested query.
-     * @param index The index of the query to use within the model.
-     * @return A `QueryMaterializer` capable of materializing the requested query, running it,
-     * or loading further related objects.
-     */
-    loadQueryByIndex(model, index, options) {
-        return this.loadModel(model, options).loadQueryByIndex(index, options);
-    }
-    /**
-     * Load a Malloy query by the URL or contents of a Malloy model document
-     * and the name of a query contained in the model.
-     *
-     * @param model The model URL or contents to load and (eventually) compile to retrieve the requested query.
-     * @param name The name of the query to use within the model.
-     * @return A `QueryMaterializer` capable of materializing the requested query, running it,
-     * or loading further related objects.
-     */
-    loadQueryByName(model, name, options) {
-        return this.loadModel(model, options).loadQueryByName(name, options);
-    }
-    // TODO maybe use overloads for the alternative parameters
-    /**
-     * Compile a Malloy model by URL or contents.
-     *
-     * @param source The URL or contents of a Malloy model document to compile.
-     * @return A promise of a compiled `Model`.
-     */
-    getModel(source, options) {
-        return this.loadModel(source, options).getModel();
-    }
-    /**
-     * Compile a Malloy query by URL or contents.
-     *
-     * @param query The URL or contents of a Malloy query document to compile.
-     * @return A promise of a compiled `PreparedQuery`.
-     */
-    getQuery(query, options) {
-        return this.loadQuery(query, options).getPreparedQuery();
-    }
-    /**
-     * Compile a Malloy query by the URL or contents of a model document
-     * and the index of an unnamed query contained within the model.
-     *
-     * @param model The URL or contents of a Malloy model document to compile.
-     * @param index The index of an unnamed query contained within the model.
-     * @return A promise of a compiled `PreparedQuery`.
-     */
-    getQueryByIndex(model, index, options) {
-        return this.loadQueryByIndex(model, index, options).getPreparedQuery();
-    }
-    /**
-     * Compile a Malloy query by the URL or contents of a model document
-     * and the name of a query contained within the model.
-     *
-     * @param model The URL or contents of a Malloy model document to compile.
-     * @param name The name of a query contained within the model.
-     * @return A promise of a compiled `PreparedQuery`.
-     */
-    getQueryByName(model, name, options) {
-        return this.loadQueryByName(model, name, options).getPreparedQuery();
-    }
-}
-exports.Runtime = Runtime;
-class ConnectionRuntime extends Runtime {
-    constructor({ urlReader, connections, }) {
-        super({
-            connections: FixedConnectionMap.fromArray(connections),
-            urlReader,
-        });
-        this.rawConnections = connections;
-    }
-}
-exports.ConnectionRuntime = ConnectionRuntime;
-class SingleConnectionRuntime extends Runtime {
-    constructor({ urlReader, connection, eventStream, cacheManager, }) {
-        super({
-            urlReader,
-            eventStream,
-            cacheManager,
-            connection,
-        });
-        this.connection = connection;
-    }
-    get supportsNesting() {
-        return (0, dialect_1.getDialect)(this.connection.dialectName).supportsNesting;
-    }
-    // quote a column name
-    quote(column) {
-        return (0, dialect_1.getDialect)(this.connection.dialectName).sqlMaybeQuoteIdentifier(column);
-    }
-    get dialect() {
-        return (0, dialect_1.getDialect)(this.connection.dialectName);
-    }
-    getQuoter() {
-        return (x) => this.quote(x.toString());
-    }
-}
-exports.SingleConnectionRuntime = SingleConnectionRuntime;
-class FluentState {
-    constructor(runtime, materialize) {
-        this.runtime = runtime;
-        this._materialize = materialize;
-    }
-    materialize() {
-        if (this.materialized === undefined) {
-            return this.rematerialize();
-        }
-        return this.materialized;
-    }
-    rematerialize() {
-        this.materialized = this._materialize();
-        return this.materialized;
-    }
-    makeQueryMaterializer(materialize, options) {
-        return new QueryMaterializer(this.runtime, materialize, options);
-    }
-    makeExploreMaterializer(materialize, options) {
-        return new ExploreMaterializer(this.runtime, materialize, options);
-    }
-    makePreparedResultMaterializer(materialize) {
-        return new PreparedResultMaterializer(this.runtime, materialize);
-    }
-}
-/**
- * An object representing the task of loading a `Model`, capable of
- * materializing that model (via `getModel()`) or extending the task to load
- * queries or explores (via e.g. `loadFinalQuery()`, `loadQuery`, `loadExploreByName`, etc.).
- */
-class ModelMaterializer extends FluentState {
-    constructor(runtime, materialize, options) {
-        super(runtime, materialize);
-        this.runtime = runtime;
-        this.compileQueryOptions = options;
-    }
-    /**
-     * Load the final (unnamed) Malloy query contained within this loaded `Model`.
-     *
-     * @return A `QueryMaterializer` capable of materializing the requested query, running it,
-     * or loading further related objects.
-     */
-    loadFinalQuery(options) {
-        return this.makeQueryMaterializer(async () => {
-            return (await this.materialize()).getPreparedQuery();
-        }, {
-            ...this.compileQueryOptions,
-            ...options,
-        });
-    }
-    /**
-     * Load an unnamed query contained within this loaded `Model` by index.
-     *
-     * @param index The index of the query to load.
-     * @return A `QueryMaterializer` capable of materializing the requested query, running it,
-     * or loading further related objects.
-     */
-    loadQueryByIndex(index, options) {
-        return this.makeQueryMaterializer(async () => {
-            return (await this.materialize()).getPreparedQueryByIndex(index);
-        }, {
-            ...this.compileQueryOptions,
-            ...options,
-        });
-    }
-    /**
-     * Load a query contained within this loaded `Model` by its name.
-     *
-     * @param name The name of the query to load.
-     * @return A `QueryMaterializer` capable of materializing the requested query, running it,
-     * or loading further related objects.
-     */
-    loadQueryByName(name, options) {
-        return this.makeQueryMaterializer(async () => {
-            return (await this.materialize()).getPreparedQueryByName(name);
-        }, {
-            ...this.compileQueryOptions,
-            ...options,
-        });
-    }
-    /**
-     * Load a query against this loaded `Model` by its URL or contents.
-     *
-     * @param query The URL or contents of the query to load and (eventually) compile.
-     * @return A `QueryMaterializer` capable of materializing the requested query, running it,
-     * or loading further related objects.
-     */
-    loadQuery(query, options) {
-        const { refreshSchemaCache, noThrowOnError } = options || {};
-        return this.makeQueryMaterializer(async () => {
-            const urlReader = this.runtime.urlReader;
-            const connections = this.runtime.connections;
-            if (this.runtime.isTestRuntime) {
-                if (options === undefined) {
-                    options = { testEnvironment: true };
-                }
-                else {
-                    options = { ...options, testEnvironment: true };
-                }
-            }
-            const compilable = query instanceof URL ? { url: query } : { source: query };
-            const model = await this.getModel();
-            const queryModel = await Malloy.compile({
-                ...compilable,
-                urlReader,
-                connections,
-                model,
-                refreshSchemaCache,
-                noThrowOnError,
-                importBaseURL: options === null || options === void 0 ? void 0 : options.importBaseURL,
-                testEnvironment: options === null || options === void 0 ? void 0 : options.testEnvironment,
-                ...this.compileQueryOptions,
-            });
-            return queryModel.preparedQuery;
-        });
-    }
-    /**
-     * Extend a Malloy model by URL or contents.
-     *
-     * @param source The model URL or contents to load and (eventually) compile.
-     * @return A `ModelMaterializer` capable of materializing the requested model,
-     * or loading further related objects.
-     */
-    extendModel(query, options) {
-        if (this.runtime.isTestRuntime) {
-            if (options === undefined) {
-                options = { testEnvironment: true };
-            }
-            else {
-                options = { ...options, testEnvironment: true };
-            }
-        }
-        return new ModelMaterializer(this.runtime, async () => {
-            const urlReader = this.runtime.urlReader;
-            const connections = this.runtime.connections;
-            const compilable = query instanceof URL ? { url: query } : { source: query };
-            const model = await this.getModel();
-            const queryModel = await Malloy.compile({
-                ...compilable,
-                urlReader,
-                connections,
-                model,
-                refreshSchemaCache: options === null || options === void 0 ? void 0 : options.refreshSchemaCache,
-                noThrowOnError: options === null || options === void 0 ? void 0 : options.noThrowOnError,
-                importBaseURL: options === null || options === void 0 ? void 0 : options.importBaseURL,
-                testEnvironment: options === null || options === void 0 ? void 0 : options.testEnvironment,
-                ...this.compileQueryOptions,
-            });
-            return queryModel;
-        }, options);
-    }
-    async search(sourceName, searchTerm, limit = 1000, searchField = undefined, eventStream) {
-        const model = await this.materialize();
-        const queryModel = new model_1.QueryModel(model._modelDef, eventStream);
-        const schema = model.getExploreByName(sourceName).structDef;
-        if (!(0, model_1.isSourceDef)(schema)) {
-            throw new Error('Source to be searched was unexpectedly, not a source');
-        }
-        const connectionName = schema.connection;
-        const connection = await this.runtime.connections.lookupConnection(connectionName);
-        return await queryModel.searchIndex(connection, sourceName, searchTerm, limit, searchField);
-    }
-    async searchValueMap(sourceName, limit = 10, options) {
-        const model = await this.materialize();
-        const schema = model.getExploreByName(sourceName);
-        if (!(0, model_1.isSourceDef)(schema.structDef)) {
-            throw new Error('Source to be searched was unexpectedly, not a source');
-        }
-        let indexQuery = '{index: *}';
-        if (schema.getFieldByNameIfExists('search_index')) {
-            indexQuery = 'search_index';
-        }
-        const searchMapMalloy = `
-      run: ${sourceName}
-        -> ${indexQuery}
-        -> {
-          where: fieldType = 'string'
-          group_by: fieldName
-          aggregate: cardinality is count(fieldValue)
-          nest: values is {
-            group_by: fieldValue, weight
-            order_by: weight desc
-            limit: ${limit}
-          }
-          limit: 1000
-        }
-    `;
-        const result = await this.loadQuery(searchMapMalloy, options).run({
-            rowLimit: 1000,
-        });
-        const rawResult = result._queryResult.result;
-        return rawResult.map(row => ({
-            ...row,
-            cardinality: (0, row_data_utils_1.rowDataToNumber)(row.cardinality),
-            values: row.values.map(v => ({
-                ...v,
-                weight: (0, row_data_utils_1.rowDataToNumber)(v.weight),
-            })),
-        }));
-    }
-    /**
-     * Materialize the final query contained within this loaded `Model`.
-     *
-     * @return A promise to a prepared query.
-     */
-    getFinalQuery() {
-        return this.loadFinalQuery().getPreparedQuery();
-    }
-    /**
-     * Materialize an unnamed query contained within this loaded `Model` by index.
-     *
-     * @param index The index of the query contained within this loaded `Model`.
-     * @return A promise to a prepared query.
-     */
-    getQueryByIndex(index) {
-        return this.loadQueryByIndex(index).getPreparedQuery();
-    }
-    /**
-     * Materialize a query contained within this loaded `Model` by name.
-     *
-     * @param name The name of the query contained within this loaded `Model`.
-     * @return A promise to a prepared query.
-     */
-    getQueryByName(name) {
-        return this.loadQueryByName(name).getPreparedQuery();
-    }
-    /**
-     * Materialize a query against this loaded `Model` by its URL or contents.
-     *
-     * @param query The URL or contents of a query document to compile.
-     * @return A promise to a prepared query.
-     */
-    getQuery(query, options) {
-        return this.loadQuery(query, options).getPreparedQuery();
-    }
-    // TODO Consider formalizing this. Perhaps as a `withQuery` method,
-    //      as well as a `PreparedQuery.fromQueryDefinition` if we choose to expose
-    //      `InternalQuery` to the world formally. For now, this should only
-    //      be used in tests.
-    _loadQueryFromQueryDef(query, options) {
-        return this.makeQueryMaterializer(async () => {
-            const model = await this.materialize();
-            return new PreparedQuery(query, model._modelDef, model.problems);
-        }, {
-            ...this.compileQueryOptions,
-            ...options,
-        });
-    }
-    /**
-     * Load an explore contained within this loaded `Model` by name.
-     *
-     * @param name The name of the explore contained within this loaded `Model`.
-     * @return An `ExploreMaterializer` capable of materializing the requested explore,
-     * or loading further related objects.
-     */
-    loadExploreByName(name) {
-        return this.makeExploreMaterializer(async () => {
-            return (await this.materialize()).getExploreByName(name);
-        }, this.compileQueryOptions);
-    }
-    /**
-     * Materialize an explore contained within this loaded `Model` by its name.
-     *
-     * @param query The name of an explore within this loaded `Model`.
-     * @return A promise to an explore.
-     */
-    getExploreByName(name) {
-        return this.loadExploreByName(name).getExplore();
-    }
-    /**
-     * Compile and materialize this loaded `Model`.
-     *
-     * @return A promise to the compiled model that is loaded.
-     */
-    getModel() {
-        return this.materialize();
-    }
-}
-exports.ModelMaterializer = ModelMaterializer;
-/**
- * An object representing the task of loading a `Query`, capable of
- * materializing the query (via `getPreparedQuery()`) or extending the task to load
- * prepared results or run the query (via e.g. `loadPreparedResult()` or `run()`).
- */
-class QueryMaterializer extends FluentState {
-    constructor(runtime, materialize, options) {
-        super(runtime, materialize);
-        this.runtime = runtime;
-        this.compileQueryOptions = options;
-    }
-    /**
-     * Run this loaded `Query`.
-     *
-     * @return The query results from running this loaded query.
-     */
-    async run(options) {
-        const connections = this.runtime.connections;
-        const preparedResult = await this.getPreparedResult(options);
-        const finalOptions = runSQLOptionsWithAnnotations(preparedResult, options);
-        return Malloy.run({ connections, preparedResult, options: finalOptions });
-    }
-    async *runStream(options) {
-        const preparedResult = await this.getPreparedResult(options);
-        const connections = this.runtime.connections;
-        const finalOptions = runSQLOptionsWithAnnotations(preparedResult, options);
-        const stream = Malloy.runStream({
-            connections,
-            preparedResult,
-            options: finalOptions,
-        });
-        for await (const row of stream) {
-            yield row;
-        }
-    }
-    /**
-     * Load the prepared result of this loaded query.
-     *
-     * @return A `PreparedResultMaterializer` capable of materializing the requested
-     * prepared query or running it.
-     */
-    loadPreparedResult(options) {
-        return this.makePreparedResultMaterializer(async () => {
-            return (await this.materialize()).getPreparedResult({
-                eventStream: this.eventStream,
-                ...this.compileQueryOptions,
-                ...options,
-            });
-        });
-    }
-    /**
-     * Materialize the prepared result of this loaded query.
-     *
-     * @return A promise of the prepared result of this loaded query.
-     */
-    getPreparedResult(options) {
-        return this.loadPreparedResult(options).getPreparedResult();
-    }
-    /**
-     * Materialize the SQL of this loaded query.
-     *
-     * @return A promise of the SQL string.
-     */
-    async getSQL(options) {
-        return (await this.getPreparedResult(options)).sql;
-    }
-    /**
-     * Materialize this loaded query.
-     *
-     * @return A promise of the `PreparedQuery`.
-     */
-    getPreparedQuery() {
-        return this.materialize();
-    }
-    /**
-     * Estimates the cost of this loaded `Query`.
-     *
-     * @return The estimated cost of running this loaded query.
-     */
-    async estimateQueryCost(options) {
-        const connections = this.runtime.connections;
-        const preparedResult = await this.getPreparedResult(options);
-        return Malloy.estimateQueryCost({ connections, preparedResult });
-    }
-    get eventStream() {
-        return this.runtime.eventStream;
-    }
-}
-exports.QueryMaterializer = QueryMaterializer;
-function runSQLOptionsWithAnnotations(preparedResult, givenOptions) {
-    return {
-        queryAnnotation: preparedResult.annotation,
-        modelAnnotation: preparedResult.modelAnnotation,
-        ...givenOptions,
-    };
-}
-/**
- * An object representing the task of loading a `PreparedResult`, capable of
- * materializing the prepared result (via `getPreparedResult()`) or extending the task run
- * the query.
- */
-class PreparedResultMaterializer extends FluentState {
-    /**
-     * Run this prepared result.
-     *
-     * @return A promise to the query result data.
-     */
-    async run(options) {
-        const preparedResult = await this.getPreparedResult();
-        const connections = this.runtime.connections;
-        const finalOptions = runSQLOptionsWithAnnotations(preparedResult, options);
-        return Malloy.run({
-            connections,
-            preparedResult,
-            options: finalOptions,
-        });
-    }
-    async *runStream(options) {
-        const preparedResult = await this.getPreparedResult();
-        const connections = this.runtime.connections;
-        const finalOptions = runSQLOptionsWithAnnotations(preparedResult, options);
-        const stream = Malloy.runStream({
-            connections,
-            preparedResult,
-            options: finalOptions,
-        });
-        for await (const row of stream) {
-            yield row;
-        }
-    }
-    /**
-     * Materialize this loaded prepared result.
-     *
-     * @return A promise of a prepared result.
-     */
-    getPreparedResult() {
-        return this.materialize();
-    }
-    /**
-     * Materialize the SQL of this loaded prepared result.
-     *
-     * @return A promise to the SQL string.
-     */
-    async getSQL() {
-        return (await this.getPreparedResult()).sql;
-    }
-}
-exports.PreparedResultMaterializer = PreparedResultMaterializer;
-/**
- * An object representing the task of loading an `Explore`, capable of
- * materializing the explore (via `getExplore()`) or extending the task to produce
- * related queries.
- */
-class ExploreMaterializer extends FluentState {
-    constructor(runtime, materialize, options) {
-        var _a;
-        super(runtime, materialize);
-        this.runtime = runtime;
-        this.replaceMaterializedReferences =
-            (_a = options === null || options === void 0 ? void 0 : options.replaceMaterializedReferences) !== null && _a !== void 0 ? _a : false;
-    }
-    /**
-     * Load a query contained within this loaded explore.
-     *
-     * @param name The name of the query to load.
-     * @return A `QueryMaterializer` capable of materializing the requested query, running it,
-     * or loading further related objects.
-     */
-    loadQueryByName(name, options) {
-        return this.makeQueryMaterializer(async () => {
-            return (await this.materialize()).getQueryByName(name);
-        }, options);
-    }
-    /**
-     * Materialize a query contained within this loaded explore.
-     *
-     * @param name The name of the query to materialize.
-     * @return A promise to the requested prepared query.
-     */
-    getQueryByName(name) {
-        return this.loadQueryByName(name).getPreparedQuery();
-    }
-    /**
-     * Materialize this loaded explore.
-     *
-     * @return A promise to the compiled `Explore`.
-     */
-    getExplore() {
-        return this.materialize();
-    }
-}
-exports.ExploreMaterializer = ExploreMaterializer;
-/**
- * The result of running a Malloy query.
- *
- * A `Result` is a `PreparedResult` along with the data retrieved from running the query.
- */
-class Result extends PreparedResult {
-    constructor(queryResult, modelDef) {
-        super(queryResult, modelDef);
-        this.inner = queryResult;
-    }
-    get _queryResult() {
-        return this.inner;
-    }
-    /**
-     * @return The result data.
-     */
-    get data() {
-        return new DataArray(this.inner.result, this.resultExplore, undefined, undefined);
-    }
-    get totalRows() {
-        return this.inner.totalRows;
-    }
-    get runStats() {
-        return this.inner.runStats;
-    }
-    get profilingUrl() {
-        return this.inner.profilingUrl;
-    }
-    toJSON() {
-        // DDL statements (INSTALL, LOAD, CREATE SECRET, etc.) don't have a schema,
-        // so we can't call this.data.toJSON() which requires resultExplore.
-        if (!this.hasSchema) {
-            return {
-                queryResult: this.inner,
-                modelDef: this._modelDef,
-            };
-        }
-        // The result rows are converted to JSON separately because they
-        // may contain un-serializable data types.
-        return {
-            queryResult: { ...this.inner, result: this.data.toJSON() },
-            modelDef: this._modelDef,
-        };
-    }
-    static fromJSON({ queryResult, modelDef }) {
-        return new Result(queryResult, modelDef);
-    }
-}
-exports.Result = Result;
-class Data {
-    constructor(field, parent, parentRecord) {
-        this.parent = parent;
-        this.parentRecord = parentRecord;
-        this._field = field;
-    }
-    get field() {
-        return this._field;
-    }
-    isString() {
-        return this instanceof DataString;
-    }
-    get string() {
-        if (this.isString()) {
-            return this;
-        }
-        throw new Error('Not a string.');
-    }
-    isBoolean() {
-        return this instanceof DataBoolean;
-    }
-    get boolean() {
-        if (this.isBoolean()) {
-            return this;
-        }
-        throw new Error('Not a boolean.');
-    }
-    isNumber() {
-        return this instanceof DataNumber;
-    }
-    get number() {
-        if (this.isNumber()) {
-            return this;
-        }
-        throw new Error('Not a number.');
-    }
-    isTimestamp() {
-        return this instanceof DataTimestamp;
-    }
-    get timestamp() {
-        if (this.isTimestamp()) {
-            return this;
-        }
-        throw new Error('Not a timestamp.');
-    }
-    isDate() {
-        return this instanceof DataDate;
-    }
-    get date() {
-        if (this.isDate()) {
-            return this;
-        }
-        throw new Error('Not a date.');
-    }
-    isNull() {
-        return this instanceof DataNull;
-    }
-    isBytes() {
-        return this instanceof DataBytes;
-    }
-    get bytes() {
-        if (this.isBytes()) {
-            return this;
-        }
-        throw new Error('Not bytes.');
-    }
-    isRecord() {
-        return this instanceof DataRecord;
-    }
-    get record() {
-        if (this.isRecord()) {
-            return this;
-        }
-        throw new Error('Not a record.');
-    }
-    isUnsupported() {
-        return this instanceof DataUnsupported;
-    }
-    get unsupported() {
-        if (this.isUnsupported()) {
-            return this;
-        }
-        throw new Error('Not unsupported.');
-    }
-    isArray() {
-        return this instanceof DataArray;
-    }
-    get array() {
-        if (this.isArray()) {
-            return this;
-        }
-        throw new Error('Not an array.');
-    }
-    isArrayOrRecord() {
-        if (this instanceof DataArray || this instanceof DataRecord) {
-            return this;
-        }
-        throw new Error('No Array or Record');
-    }
-    isScalar() {
-        return true;
-    }
-}
-class ScalarData extends Data {
-    constructor(value, field, parent, parentRecord) {
-        super(field, parent, parentRecord);
-        this._value = value;
-        this._field = field;
-    }
-    get value() {
-        return this._value;
-    }
-    get field() {
-        return this._field;
-    }
-    isScalar() {
-        return this instanceof ScalarData;
-    }
-}
-class DataString extends ScalarData {
-    constructor(value, field, parent, parentRecord) {
-        super(value, field, parent, parentRecord);
-        this._field = field;
-    }
-    get field() {
-        return this._field;
-    }
-    get key() {
-        return this.value;
-    }
-    compareTo(other) {
-        return this.value
-            .toLocaleLowerCase()
-            .localeCompare(other.value.toLocaleLowerCase());
-    }
-}
-class DataUnsupported extends ScalarData {
-    constructor(value, field, parent, parentRecord) {
-        super(value, field, parent, parentRecord);
-        this._field = field;
-    }
-    get field() {
-        return this._field;
-    }
-    get key() {
-        return '<unsupported>';
-    }
-    compareTo(_other) {
-        return 0;
-    }
-}
-class DataBoolean extends ScalarData {
-    constructor(value, field, parent, parentRecord) {
-        super(value, field, parent, parentRecord);
-        this._field = field;
-    }
-    get field() {
-        return this._field;
-    }
-    get key() {
-        return `${this.value}`;
-    }
-    compareTo(other) {
-        if (this.value === other.value) {
-            return 0;
-        }
-        if (this.value) {
-            return 1;
-        }
-        return -1;
-    }
-}
-class DataJSON extends ScalarData {
-    constructor(value, field, parent, parentRecord) {
-        super(value, field, parent, parentRecord);
-        this._field = field;
-    }
-    get field() {
-        return this._field;
-    }
-    get key() {
-        return this.value;
-    }
-    compareTo(other) {
-        const value = this.value.toString();
-        const otherValue = other.toString();
-        if (value === otherValue) {
-            return 0;
-        }
-        else if (value > otherValue) {
-            return 1;
-        }
-        else {
-            return -1;
-        }
-    }
-}
-class DataNumber extends ScalarData {
-    constructor(value, field, parent, parentRecord) {
-        super((0, row_data_utils_1.rowDataToNumber)(value), field, parent, parentRecord);
-        this._field = field;
-    }
-    get field() {
-        return this._field;
-    }
-    get key() {
-        return `${this.value}`;
-    }
-    compareTo(other) {
-        const difference = this.value - other.value;
-        if (difference > 0) {
-            return 1;
-        }
-        else if (difference === 0) {
-            return 0;
-        }
-        return -1;
-    }
-}
-class DataTimestamp extends ScalarData {
-    constructor(value, field, parent, parentRecord) {
-        super(value, field, parent, parentRecord);
-        this._field = field;
-    }
-    get value() {
-        return (0, row_data_utils_1.rowDataToDate)(this._value);
-    }
-    get field() {
-        return this._field;
-    }
-    get key() {
-        return `${this.value.toLocaleString()}`;
-    }
-    compareTo(other) {
-        if (this.value > other.value) {
-            return 1;
-        }
-        else if (this.value < other.value) {
-            return -1;
-        }
-        return 0;
-    }
-}
-class DataDate extends ScalarData {
-    constructor(value, field, parent, parentRecord) {
-        super(value, field, parent, parentRecord);
-        this._field = field;
-    }
-    get value() {
-        return (0, row_data_utils_1.rowDataToDate)(this._value);
-    }
-    get field() {
-        return this._field;
-    }
-    get key() {
-        return `${this.value.toLocaleString()}`;
-    }
-    compareTo(other) {
-        if (this.value > other.value) {
-            return 1;
-        }
-        else if (this.value < other.value) {
-            return -1;
-        }
-        return 0;
-    }
-}
-class DataBytes extends ScalarData {
-    get key() {
-        return this.value.toString();
-    }
-    compareTo(other) {
-        const value = this.value.toString();
-        const otherValue = other.toString();
-        if (value === otherValue) {
-            return 0;
-        }
-        else if (value > otherValue) {
-            return 1;
-        }
-        else {
-            return -1;
-        }
-    }
-}
-class DataNull extends Data {
-    get value() {
-        return null;
-    }
-    get key() {
-        return '<null>';
-    }
-}
-/**
- * Safe bigint conversion - handles floats that are incorrectly typed as bigint
- * (e.g., avg() results which should be float but Malloy marks as bigint).
- */
-function safeRowDataToBigint(value) {
-    const strValue = (0, row_data_utils_1.rowDataToSerializedBigint)(value);
-    if (strValue.includes('.') ||
-        strValue.includes('e') ||
-        strValue.includes('E')) {
-        return (0, row_data_utils_1.rowDataToNumber)(value);
-    }
-    try {
-        return BigInt(strValue);
-    }
-    catch {
-        return (0, row_data_utils_1.rowDataToNumber)(value);
-    }
-}
-/**
- * Safe bigint serialization - returns number for floats that should stay as numbers.
- */
-function safeRowDataToSerializedBigint(value) {
-    const strValue = (0, row_data_utils_1.rowDataToSerializedBigint)(value);
-    if (strValue.includes('.') ||
-        strValue.includes('e') ||
-        strValue.includes('E')) {
-        return (0, row_data_utils_1.rowDataToNumber)(value);
-    }
-    return strValue;
-}
-/**
- * Normalizers for toObject() - returns JS native types (number | bigint, Date)
- */
-const OBJECT_NORMALIZERS = {
-    number: row_data_utils_1.rowDataToNumber,
-    bigint: safeRowDataToBigint,
-    date: row_data_utils_1.rowDataToDate,
-};
-/**
- * Normalizers for toJSON() - returns JSON-safe types (number | string, ISO strings)
- */
-const JSON_NORMALIZERS = {
-    number: row_data_utils_1.rowDataToNumber,
-    bigint: safeRowDataToSerializedBigint,
-    date: (value) => (0, row_data_utils_1.rowDataToDate)(value).toISOString(),
-};
-/**
- * Walk a QueryData array and normalize values according to the given normalizers.
- */
-function walkQueryData(data, structDef, normalizers) {
-    return data.map(row => walkQueryDataRow(row, structDef, normalizers));
-}
-/**
- * Walk a QueryDataRow and normalize values according to the given normalizers.
- */
-function walkQueryDataRow(row, structDef, normalizers) {
-    var _a;
-    const result = {};
-    for (const fieldDef of structDef.fields) {
-        const fieldName = (_a = fieldDef.as) !== null && _a !== void 0 ? _a : fieldDef.name;
-        const value = row[fieldName];
-        result[fieldName] = walkValue(value, fieldDef, normalizers);
-    }
-    return result;
-}
-/**
- * Normalize a single value based on its field definition.
- */
-function walkValue(value, fieldDef, normalizers) {
-    if (value === null || value === undefined) {
-        return null;
-    }
-    // Handle scalar types
-    if (fieldDef.type === 'number') {
-        const numberDef = fieldDef;
-        if (numberDef.numberType === 'bigint') {
-            return normalizers.bigint(value);
-        }
-        return normalizers.number(value);
-    }
-    if (fieldDef.type === 'date' ||
-        fieldDef.type === 'timestamp' ||
-        fieldDef.type === 'timestamptz') {
-        return normalizers.date(value);
-    }
-    if (fieldDef.type === 'string' ||
-        fieldDef.type === 'boolean' ||
-        fieldDef.type === 'json' ||
-        fieldDef.type === 'sql native') {
-        // Pass through as-is (or with minimal conversion for booleans from numbers)
-        if (fieldDef.type === 'boolean' && typeof value === 'number') {
-            return value !== 0;
-        }
-        return value;
-    }
-    // Handle arrays
-    if (fieldDef.type === 'array') {
-        if (!Array.isArray(value)) {
-            return value; // Unexpected, but don't crash
-        }
-        if ((0, model_1.isRepeatedRecord)(fieldDef)) {
-            // Array of records - recurse into each record
-            return value.map(item => walkQueryDataRow(item, fieldDef, normalizers));
-        }
-        else if ((0, model_1.isBasicArray)(fieldDef)) {
-            // Scalar array - normalize each element based on elementTypeDef
-            // Cast needed because QueryValue type doesn't cleanly express scalar arrays
-            const elementType = fieldDef.elementTypeDef;
-            return value.map(item => walkScalarValue(item, elementType, normalizers));
-        }
-    }
-    // Handle records (non-array)
-    if (fieldDef.type === 'record') {
-        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
-            return walkQueryDataRow(value, fieldDef, normalizers);
-        }
-    }
-    // Fallback - pass through
-    return value;
-}
-/**
- * Normalize a scalar value (not in a row context, e.g., elements of a scalar array).
- */
-function walkScalarValue(value, typeDef, normalizers) {
-    if (value === null || value === undefined) {
-        return null;
-    }
-    if (typeDef.type === 'number') {
-        const numberDef = typeDef;
-        if (numberDef.numberType === 'bigint') {
-            return normalizers.bigint(value);
-        }
-        return normalizers.number(value);
-    }
-    if (typeDef.type === 'date' ||
-        typeDef.type === 'timestamp' ||
-        typeDef.type === 'timestamptz') {
-        return normalizers.date(value);
-    }
-    if (typeDef.type === 'boolean' && typeof value === 'number') {
-        return value !== 0;
-    }
-    // Handle nested arrays (array of arrays)
-    if (typeDef.type === 'array' && Array.isArray(value)) {
-        if ((0, model_1.isBasicArray)(typeDef)) {
-            const elementType = typeDef.elementTypeDef;
-            return value.map(item => walkScalarValue(item, elementType, normalizers));
-        }
-        else if ((0, model_1.isRepeatedRecord)(typeDef)) {
-            return value.map(item => walkQueryDataRow(item, typeDef, normalizers));
-        }
-    }
-    // Pass through other types
-    return value;
-}
-class DataArray extends Data {
-    constructor(queryData, field, parent, parentRecord) {
-        super(field, parent, parentRecord);
-        this.rowCache = new Map();
-        this.queryData = queryData;
-        this._field = field;
-    }
-    /**
-     * @return The `Explore` that describes the structure of this data.
-     */
-    get field() {
-        return this._field;
-    }
-    /**
-     * @return The raw query data as returned by the database driver.
-     * Values may be in various formats depending on the driver (wrapper objects, strings, etc.).
-     * Use this for passing to mapData() which handles normalization itself.
-     */
-    get rawData() {
-        return this.queryData;
-    }
-    /**
-     * @return Normalized data with JS native types (number | bigint, Date).
-     * Use this for CSV output, tests, and general programmatic access.
-     */
-    toObject() {
-        return walkQueryData(this.queryData, this._field.structDef, OBJECT_NORMALIZERS);
-    }
-    /**
-     * @return Normalized data with JSON-safe types (numbers as number | string, dates as ISO strings).
-     * Use this for JSON serialization.
-     */
-    toJSON() {
-        return walkQueryData(this.queryData, this._field.structDef, JSON_NORMALIZERS);
-    }
-    path(...path) {
-        return getPath(this, path);
-    }
-    row(index) {
-        let record = this.rowCache.get(index);
-        if (!record) {
-            record = new DataRecord(this.queryData[index], index, this.field, this, this.parentRecord);
-            this.rowCache.set(index, record);
-        }
-        return record;
-    }
-    get rowCount() {
-        return this.queryData.length;
-    }
-    get value() {
-        return this.toObject();
-    }
-    [Symbol.iterator]() {
-        let currentIndex = 0;
-        const queryData = this.queryData;
-        const getRow = (index) => this.row(index);
-        return {
-            next() {
-                if (currentIndex < queryData.length) {
-                    return { value: getRow(currentIndex++), done: false };
-                }
-                else {
-                    return { value: undefined, done: true };
-                }
-            },
-        };
-    }
-    async *inMemoryStream() {
-        for (let i = 0; i < this.queryData.length; i++) {
-            yield this.row(i);
-        }
-    }
-}
-exports.DataArray = DataArray;
-function getPath(data, path) {
-    for (const segment of path) {
-        if (typeof segment === 'number') {
-            data = data.array.row(segment);
-        }
-        else {
-            data = data.record.cell(segment);
-        }
-    }
-    return data;
-}
-class DataRecord extends Data {
-    constructor(queryDataRow, index, field, parent, parentRecord) {
-        super(field, parent, parentRecord);
-        this.cellCache = new Map();
-        this.queryDataRow = queryDataRow;
-        this._field = field;
-        this.index = index;
-    }
-    /**
-     * @return Normalized data with JS native types (number | bigint, Date).
-     * Use this for CSV output, tests, and general programmatic access.
-     */
-    toObject() {
-        return walkQueryDataRow(this.queryDataRow, this._field.structDef, OBJECT_NORMALIZERS);
-    }
-    /**
-     * @return Normalized data with JSON-safe types (numbers as number | string, dates as ISO strings).
-     * Use this for JSON serialization.
-     */
-    toJSON() {
-        return walkQueryDataRow(this.queryDataRow, this._field.structDef, JSON_NORMALIZERS);
-    }
-    path(...path) {
-        return getPath(this, path);
-    }
-    cell(fieldOrName) {
-        const fieldName = typeof fieldOrName === 'string' ? fieldOrName : fieldOrName.name;
-        const field = this._field.getFieldByName(fieldName);
-        let column = this.cellCache.get(fieldName);
-        if (!column) {
-            const value = this.queryDataRow[fieldName];
-            if (value === null) {
-                column = new DataNull(field, this, this);
-            }
-            else if (field.isAtomicField()) {
-                if (field.isBoolean()) {
-                    column = new DataBoolean(value, field, this, this);
-                }
-                else if (field.isDate()) {
-                    column = new DataDate(value, field, this, this);
-                }
-                else if (field.isJSON()) {
-                    column = new DataJSON(value, field, this, this);
-                }
-                else if (field.isTimestamp()) {
-                    column = new DataTimestamp(value, field, this, this);
-                }
-                else if (field.isNumber()) {
-                    column = new DataNumber(value, field, this, this);
-                }
-                else if (field.isString()) {
-                    column = new DataString(value, field, this, this);
-                }
-                else if (field.isUnsupported()) {
-                    column = new DataUnsupported(value, field, this, this);
-                }
-            }
-            else if (field.isExploreField()) {
-                if (Array.isArray(value)) {
-                    column = new DataArray(value, field, this, this);
-                }
-                else {
-                    column = new DataRecord(value, undefined, field, this, this);
-                }
-            }
-            if (column)
-                this.cellCache.set(fieldName, column);
-        }
-        if (column)
-            return column;
-        throw new Error(`Internal Error: could not construct data column for field '${fieldName}'.`);
-    }
-    get value() {
-        throw new Error('Not implemented;');
-    }
-    // Non repeating values show up as DataRecords
-    get field() {
-        return this._field;
-    }
-    // Allow iteration over non repeating values to simplify end user code.
-    [Symbol.iterator]() {
-        let returned = false;
-        const getSelf = () => {
-            return this;
-        };
-        return {
-            next() {
-                if (!returned) {
-                    returned = true;
-                    return {
-                        value: getSelf(),
-                        done: false,
-                    };
-                }
-                else {
-                    return { value: undefined, done: true };
-                }
-            },
-        };
-    }
-}
-exports.DataRecord = DataRecord;
-class DataWriter {
-    constructor(stream) {
-        this.stream = stream;
-    }
-}
-exports.DataWriter = DataWriter;
-class JSONWriter extends DataWriter {
-    async process(data) {
-        this.stream.write('[\n');
-        for await (const row of data) {
-            if (row.index !== undefined && row.index > 0) {
-                this.stream.write(',\n');
-            }
-            // toJSON() returns JSON-safe values: bigints as strings, dates as ISO strings
-            const json = JSON.stringify(row.toJSON(), null, 2);
-            const jsonLines = json.split('\n');
-            for (let i = 0; i < jsonLines.length; i++) {
-                const line = jsonLines[i];
-                this.stream.write(`  ${line}`);
-                if (i < jsonLines.length - 1) {
-                    this.stream.write('\n');
-                }
-            }
-        }
-        this.stream.write('\n]\n');
-        this.stream.close();
-    }
-}
-exports.JSONWriter = JSONWriter;
-/**
- * CSV writer class that handles nested data.
- * This writer creates CSV using a DFS traversal of the result dataset.
- * Each trivial column value is converted to a CSV of 1x1 matrix and all the
- * columns are merged together to create a CSV that represents 1 QueryDataRow.
- * Since this follows DFS, each non trivial data is rendered into a NxM matrix
- * where N is the number of rows in the nested data and M is the number of
- * columns it has.
- * For any row with X number of columns, we end up with X number of NxM matrices
- * where the value of N,M pair may be different for each column.
- * We then merge the matrices so that we end up with a larger matrix of size
- * Max(N)xSum(M) by taking one row of csv from each matric at a time. For any
- * matrix with N<Max(N), we add a row of empty CSV cells of size N.
- */
-class CSVWriter extends DataWriter {
-    constructor() {
-        super(...arguments);
-        this.columnSeparator = ',';
-        this.rowSeparator = '\n';
-        this.quoteCharacter = '"';
-        this.includeHeader = true;
-        this.emptyCell = '';
-    }
-    escape(value) {
-        const hasInnerQuote = value.includes(this.quoteCharacter);
-        const hasInnerCommas = value.includes(this.columnSeparator);
-        const hasNewline = value.includes(this.rowSeparator);
-        const needsQuoting = hasInnerCommas || hasInnerQuote || hasNewline;
-        if (hasInnerQuote) {
-            value = value.replace(new RegExp(this.quoteCharacter, 'g'), this.quoteCharacter + this.quoteCharacter);
-        }
-        if (needsQuoting) {
-            value = this.quoteCharacter + value + this.quoteCharacter;
-        }
-        return value;
-    }
-    // Re-using the old stringify method for sanity.
-    stringify(value) {
-        if (value === null) {
-            return this.emptyCell;
-        }
-        else if (value instanceof Date) {
-            return value.toISOString();
-        }
-        else if (typeof value === 'boolean' || typeof value === 'number') {
-            return JSON.stringify(value);
-        }
-        else if (typeof value === 'bigint') {
-            // Bigints from toObject() - write as unquoted number string
-            return value.toString();
-        }
-        else {
-            return `${value}`;
-        }
-    }
-    // Extra weight to be added becase of nested tables inside the cells.
-    getColWeight(jsonVal) {
-        let firstVal = jsonVal;
-        if (Array.isArray(jsonVal)) {
-            firstVal = jsonVal[0];
-        }
-        let numKeys = 0;
-        for (const key in firstVal) {
-            numKeys = numKeys + 1;
-            const val = firstVal[key];
-            if (Array.isArray(val)) {
-                const weight = this.getColWeight(val) - 1;
-                numKeys = numKeys + weight;
-            }
-        }
-        return numKeys;
-    }
-    // Get header row along with extra empty spaces for nested children.
-    getHeaderRow(row) {
-        const csv = [];
-        let width = 0;
-        for (const key in row) {
-            csv.push(this.escape(key));
-            const val = row[key];
-            width++;
-            if (Array.isArray(val)) {
-                const numKeys = this.getColWeight(val) - 1;
-                width = width + numKeys;
-                for (let i = 0; i < numKeys; i++) {
-                    csv.push(this.emptyCell);
-                }
-            }
-        }
-        return { rows: [csv.join(this.columnSeparator)], length: 1, width: width };
-    }
-    // Merge the child matrices i.e. merge the columns into one bigger matrix i.e. CSV.
-    mergeMatrices(matrices) {
-        const maxLength = Math.max(...matrices.map(matrix => matrix.length));
-        const matrixWidth = matrices.reduce((sum, matrix) => sum + matrix.width, 0);
-        const csvMatrix = [];
-        for (let i = 0; i < maxLength; i++) {
-            const csvRow = [];
-            for (const matrix of matrices) {
-                if (i < matrix.length) {
-                    csvRow.push(matrix.rows[i]);
-                }
-                else {
-                    // Add empty cells.
-                    const emptyCells = Array(matrix.width).fill(this.emptyCell);
-                    csvRow.push(...emptyCells);
-                }
-            }
-            csvMatrix.push(csvRow.join(this.columnSeparator));
-        }
-        return {
-            rows: csvMatrix,
-            length: maxLength,
-            width: matrixWidth,
-        };
-    }
-    // Gets CSV for a data cell that has nested data.
-    getChildMatrix(jsonVal) {
-        // This is not expected to happen.
-        if (!Array.isArray(jsonVal)) {
-            return {
-                rows: ['Invalid data found, value is not an array'],
-                length: 1,
-                width: 1,
-            };
-        }
-        else if (jsonVal.length === 0) {
-            return {
-                rows: [''],
-                length: 1,
-                width: 1,
-            };
-        }
-        const csvMatrix = [];
-        const header = this.getHeaderRow(jsonVal[0]);
-        // Header has 1 row.
-        csvMatrix.push(...header.rows);
-        const width = header.width;
-        let rowCount = 1;
-        for (const row of jsonVal) {
-            const rowMatrix = this.getRowMatrix(row);
-            rowCount = rowCount + rowMatrix.length;
-            csvMatrix.push(...rowMatrix.rows);
-        }
-        return { rows: csvMatrix, length: rowCount, width: width };
-    }
-    // Creates CSV content for one row of data.
-    getRowMatrix(row) {
-        const matrices = [];
-        for (const key in row) {
-            const val = row[key];
-            if (!Array.isArray(val)) {
-                const cell = {
-                    rows: [this.stringify(val)],
-                    length: 1,
-                    width: 1,
-                };
-                matrices.push(cell);
-            }
-            else {
-                const cell = this.getChildMatrix(val);
-                matrices.push(cell);
-            }
-        }
-        return this.mergeMatrices(matrices);
-    }
-    async process(data) {
-        let headerDefined = false;
-        for await (const row of data) {
-            if (!headerDefined && this.includeHeader) {
-                const header = this.getHeaderRow(row.toObject());
-                this.stream.write(header.rows[0]);
-                this.stream.write(this.rowSeparator);
-                headerDefined = true;
-            }
-            const rowCsv = this.getRowMatrix(row.toObject());
-            for (const line of rowCsv.rows) {
-                this.stream.write(line);
-                this.stream.write(this.rowSeparator);
-            }
-        }
-        this.stream.close();
-    }
-}
-exports.CSVWriter = CSVWriter;
-class CacheManager {
-    constructor(modelCache) {
-        this.modelCache = modelCache;
-        this.modelDependencies = new Map();
-        this.modelInvalidationKeys = new Map();
-    }
-    async getCachedModelDef(urlReader, url) {
-        const _dependencies = this.modelDependencies.get(url);
-        if (_dependencies === undefined) {
-            return undefined;
-        }
-        const dependencies = [url, ...flatDeps(_dependencies)];
-        const invalidationKeys = {};
-        for (const dependency of dependencies) {
-            const invalidationKey = this.modelInvalidationKeys.get(dependency);
-            if (invalidationKey === undefined || invalidationKey === null) {
-                return undefined;
-            }
-            invalidationKeys[dependency] = invalidationKey;
-        }
-        for (const dependency of dependencies) {
-            const invalidationKey = await getInvalidationKey(urlReader, new URL(dependency));
-            if (invalidationKey !== invalidationKeys[dependency]) {
-                return undefined;
-            }
-        }
-        const cached = await this.modelCache.getModel(new URL(url));
-        if (cached === undefined) {
-            return undefined;
-        }
-        for (const dependency of dependencies) {
-            if (cached.invalidationKeys[dependency] !== invalidationKeys[dependency]) {
-                return undefined;
-            }
-        }
-        // Return the cached model def and the invalidation keys for this
-        // model def's dependencies
-        return { modelDef: cached.modelDef, invalidationKeys };
-    }
-    async setCachedModelDef(url, cachedModel) {
-        this.modelDependencies.set(url, cachedModel.modelDef.dependencies);
-        const invalidationKeys = {};
-        for (const dependency of [
-            url,
-            ...flatDeps(cachedModel.modelDef.dependencies),
-        ]) {
-            if (cachedModel.invalidationKeys[dependency] === null) {
-                return false;
-            }
-            if (cachedModel.invalidationKeys[dependency] === undefined) {
-                throw new Error(`Missing invalidation key for dependency ${dependency}`);
-            }
-            this.modelInvalidationKeys.set(dependency, cachedModel.invalidationKeys[dependency]);
-            invalidationKeys[dependency] = cachedModel.invalidationKeys[dependency];
-        }
-        const result = await this.modelCache.setModel(new URL(url), {
-            modelDef: cachedModel.modelDef,
-            invalidationKeys,
-        });
-        if (result) {
-            return true; // TODO just return `result` when it's a boolean
-        }
-        return false;
-    }
-}
-exports.CacheManager = CacheManager;
-function flatDeps(tree) {
-    return [...Object.keys(tree), ...Object.values(tree).map(flatDeps).flat()];
-}
-// TODO maybe make this memory bounded....
-class InMemoryModelCache {
-    constructor() {
-        this.models = new Map();
-    }
-    async getModel(url) {
-        return Promise.resolve(this.models.get(url.toString()));
-    }
-    async setModel(url, cachedModel) {
-        this.models.set(url.toString(), cachedModel);
-        return Promise.resolve(true);
-    }
-}
-exports.InMemoryModelCache = InMemoryModelCache;
-function hashForInvalidationKey(input) {
-    const MALLOY_UUID = '76c17e9d-f3ce-5f2d-bfde-98ad3d2a37f6';
-    return (0, uuid_1.v5)(input, MALLOY_UUID);
-}
-async function readURL(urlReader, url) {
-    const result = await urlReader.readURL(url);
-    const { contents, invalidationKey } = typeof result === 'string'
-        ? { contents: result, invalidationKey: undefined }
-        : result;
-    return {
-        contents,
-        invalidationKey: isInternalURL(url.toString())
-            ? null
-            : invalidationKey !== null && invalidationKey !== void 0 ? invalidationKey : hashForInvalidationKey(contents),
-    };
-}
-async function getInvalidationKey(urlReader, url) {
-    if (isInternalURL(url.toString())) {
-        return null;
-    }
-    if (urlReader.getInvalidationKey !== undefined) {
-        return await urlReader.getInvalidationKey(url);
-    }
-    return (await readURL(urlReader, url)).invalidationKey;
-}
-function isInternalURL(url) {
-    return url.startsWith('internal://');
-}
-//# sourceMappingURL=malloy.js.map