linkgress-orm 0.0.1

package/dist/query/strategies/temptable-collection-strategy.js

@@ -0,0 +1,456 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TempTableCollectionStrategy = void 0;
+/**
+ * Temp table-based collection strategy
+ *
+ * This strategy uses PostgreSQL temporary tables to store parent IDs,
+ * then JOINs against them to aggregate related records.
+ *
+ * Benefits:
+ * - Better performance for large datasets
+ * - Indexed temp table JOIN can be faster than CTE
+ * - More control over query plan
+ *
+ * Trade-offs:
+ * - Requires two round trips (get parent IDs, then aggregate)
+ * - Needs temp table management
+ * - Transaction-scoped temp tables
+ *
+ * SQL Pattern:
+ * ```sql
+ * CREATE TEMP TABLE tmp_parent_ids_0 (
+ *   id integer PRIMARY KEY
+ * ) ON COMMIT DROP;
+ *
+ * INSERT INTO tmp_parent_ids_0 VALUES (1),(2),(3);
+ *
+ * SELECT
+ *   t.id as parent_id,
+ *   jsonb_agg(
+ *     jsonb_build_object('id', p.id, 'title', p.title)
+ *     ORDER BY p.views DESC
+ *   ) as data
+ * FROM tmp_parent_ids_0 t
+ * LEFT JOIN posts p ON p.user_id = t.id AND p.views > $1
+ * GROUP BY t.id;
+ * ```
+ */
+class TempTableCollectionStrategy {
+    getType() {
+        return 'temptable';
+    }
+    requiresParentIds() {
+        // Temp table strategy requires parent IDs to be fetched first
+        return true;
+    }
+    async buildAggregation(config, context, client) {
+        if (!config.parentIds || config.parentIds.length === 0) {
+            // No parent IDs means we'll return empty results
+            // We can still create an empty temp table for consistency
+            return this.buildEmptyAggregation(config, context);
+        }
+        // Check if client supports multi-statement queries for optimization
+        if (client.supportsMultiStatementQueries()) {
+            return this.buildAggregationMultiStatement(config, context, client);
+        }
+        else {
+            return this.buildAggregationLegacy(config, context, client);
+        }
+    }
+    /**
+     * Build aggregation using multi-statement query (single round trip)
+     * Supported by postgres.js using .simple() mode
+     *
+     * For JSONB/array collections: fetches raw rows and groups in JavaScript (fast!)
+     * For scalar aggregations: uses database aggregation (necessary)
+     */
+    async buildAggregationMultiStatement(config, context, client) {
+        const tempTableName = `tmp_parent_ids_${config.counter}`;
+        // Build aggregation SQL with WHERE parameters interpolated
+        const aggregationSQL = this.buildAggregationSQLWithInterpolatedParams(config, tempTableName);
+        // Build the value placeholders for INSERT (interpolate integer parent IDs - safe)
+        const valuePlaceholders = config.parentIds.map(id => `(${id})`).join(',');
+        // Determine if we're doing client-side grouping (JSONB/array) or server-side (scalar)
+        const isClientSideGrouping = config.aggregationType === 'jsonb' || config.aggregationType === 'array';
+        // Combine everything into a single multi-statement query
+        const multiStatementSQL = `
+-- Create temporary table for parent IDs
+CREATE TEMP TABLE ${tempTableName} (
+  id integer PRIMARY KEY
+) ON COMMIT DROP;
+
+-- Insert parent IDs
+INSERT INTO ${tempTableName} VALUES ${valuePlaceholders};
+
+-- Query and return the data
+${aggregationSQL};
+
+-- Cleanup
+DROP TABLE IF EXISTS ${tempTableName};
+    `.trim();
+        // Execute multi-statement query using querySimple (no parameters)
+        const executor = context.executor || client;
+        // Use querySimple if available (for proper logging)
+        let result;
+        if ('querySimple' in executor && typeof executor.querySimple === 'function') {
+            // Use querySimple for true single round-trip execution with logging
+            result = await executor.querySimple(multiStatementSQL);
+        }
+        else if ('querySimple' in client && typeof client.querySimple === 'function') {
+            // Fallback: call client directly (no logging)
+            result = await client.querySimple(multiStatementSQL);
+        }
+        else {
+            // Final fallback: regular query
+            result = await executor.query(multiStatementSQL, []);
+        }
+        // Group results by parent_id
+        const dataMap = new Map();
+        if (isClientSideGrouping) {
+            // Client-side grouping for JSONB/array - much faster than jsonb_agg!
+            if (config.aggregationType === 'jsonb') {
+                // Group rows by parent_id and build objects
+                for (const row of result.rows) {
+                    const parentId = row.parent_id;
+                    if (!dataMap.has(parentId)) {
+                        dataMap.set(parentId, []);
+                    }
+                    // Extract the actual data (everything except parent_id)
+                    const { parent_id, ...rowData } = row;
+                    dataMap.get(parentId).push(rowData);
+                }
+            }
+            else if (config.aggregationType === 'array') {
+                // Group rows by parent_id and extract array field
+                const arrayField = config.arrayField;
+                for (const row of result.rows) {
+                    const parentId = row.parent_id;
+                    if (!dataMap.has(parentId)) {
+                        dataMap.set(parentId, []);
+                    }
+                    dataMap.get(parentId).push(row[arrayField]);
+                }
+            }
+        }
+        else {
+            // Server-side aggregation (scalar) - data already aggregated
+            for (const row of result.rows) {
+                dataMap.set(row.parent_id, row.data);
+            }
+        }
+        // Return result with fetched data
+        return {
+            sql: aggregationSQL,
+            params: [], // Params already used in execution
+            tableName: `${tempTableName}_result`,
+            joinClause: '', // Not needed - data already fetched
+            selectExpression: '', // Not needed - data already fetched
+            isCTE: false,
+            dataFetched: true,
+            data: dataMap,
+        };
+    }
+    /**
+     * Build aggregation using legacy approach (multiple queries)
+     * Used for clients that don't support multi-statement queries
+     */
+    async buildAggregationLegacy(config, context, client) {
+        const tempTableName = `tmp_parent_ids_${config.counter}`;
+        // Create temp table (without ON COMMIT DROP to persist across queries in the same session)
+        const createTableSQL = `
+CREATE TEMP TABLE IF NOT EXISTS ${tempTableName} (
+  id integer PRIMARY KEY
+)
+    `.trim();
+        // Use executor from context if available for query logging
+        if (context.executor) {
+            await context.executor.query(createTableSQL);
+        }
+        else {
+            await client.query(createTableSQL);
+        }
+        // Insert parent IDs
+        const valuePlaceholders = config.parentIds.map((_, idx) => `($${idx + 1})`).join(',');
+        const insertSQL = `INSERT INTO ${tempTableName} VALUES ${valuePlaceholders}`;
+        // Use executor from context if available for query logging
+        if (context.executor) {
+            await context.executor.query(insertSQL, config.parentIds);
+        }
+        else {
+            await client.query(insertSQL, config.parentIds);
+        }
+        // Build aggregation query based on type
+        const aggregationSQL = this.buildAggregationSQLByType(config, tempTableName);
+        const aggregationParams = config.whereParams || [];
+        const selectExpression = `"${tempTableName}_agg".data`;
+        // Execute aggregation query and store results in another temp table
+        const aggTempTableName = `${tempTableName}_agg`;
+        const createAggTableSQL = `
+CREATE TEMP TABLE ${aggTempTableName} AS
+${aggregationSQL}
+    `.trim();
+        // Use executor from context if available for query logging
+        if (context.executor) {
+            await context.executor.query(createAggTableSQL, aggregationParams);
+        }
+        else {
+            await client.query(createAggTableSQL, aggregationParams);
+        }
+        // Cleanup SQL
+        const cleanupSQL = `DROP TABLE IF EXISTS ${tempTableName}, ${aggTempTableName}`;
+        return {
+            sql: aggregationSQL,
+            params: [], // Params already used in execution
+            tableName: aggTempTableName,
+            joinClause: `LEFT JOIN "${aggTempTableName}" ON "${config.sourceTable}"."id" = "${aggTempTableName}".parent_id`,
+            selectExpression: `COALESCE(${selectExpression}, ${config.defaultValue})`,
+            isCTE: false, // Not a CTE - already executed
+            cleanupSql: cleanupSQL,
+        };
+    }
+    /**
+     * Build aggregation SQL based on aggregation type
+     */
+    buildAggregationSQLByType(config, tempTableName) {
+        switch (config.aggregationType) {
+            case 'jsonb':
+                return this.buildJsonbAggregationSQL(config, tempTableName);
+            case 'array':
+                return this.buildArrayAggregationSQL(config, tempTableName);
+            case 'count':
+            case 'min':
+            case 'max':
+            case 'sum':
+                return this.buildScalarAggregationSQL(config, tempTableName);
+            default:
+                throw new Error(`Unknown aggregation type: ${config.aggregationType}`);
+        }
+    }
+    /**
+     * Build aggregation SQL with WHERE parameters interpolated
+     * Used for multi-statement queries with .simple() mode
+     *
+     * For JSONB/array aggregations, this returns a simple SELECT without aggregation
+     * so we can group in JavaScript (much faster than jsonb_agg)
+     */
+    buildAggregationSQLWithInterpolatedParams(config, tempTableName) {
+        // Clone config and interpolate WHERE parameters
+        const configWithInterpolatedParams = { ...config };
+        if (config.whereClause && config.whereParams && config.whereParams.length > 0) {
+            // Replace $1, $2, etc. with actual values
+            let interpolatedWhere = config.whereClause;
+            config.whereParams.forEach((param, idx) => {
+                const placeholder = `$${idx + 1}`;
+                const value = this.escapeValue(param);
+                interpolatedWhere = interpolatedWhere.replace(placeholder, value);
+            });
+            configWithInterpolatedParams.whereClause = interpolatedWhere;
+            configWithInterpolatedParams.whereParams = []; // Clear params since they're now interpolated
+        }
+        // For multi-statement optimization: use simple SELECT instead of aggregation
+        // This allows us to group in JavaScript which is much faster than jsonb_agg
+        switch (config.aggregationType) {
+            case 'jsonb':
+            case 'array':
+                return this.buildSimpleSelectSQL(configWithInterpolatedParams, tempTableName);
+            case 'count':
+            case 'min':
+            case 'max':
+            case 'sum':
+                // Scalar aggregations still need database aggregation
+                return this.buildScalarAggregationSQL(configWithInterpolatedParams, tempTableName);
+            default:
+                throw new Error(`Unknown aggregation type: ${config.aggregationType}`);
+        }
+    }
+    /**
+     * Build a simple SELECT query without aggregation
+     * Results will be grouped in JavaScript for better performance
+     */
+    buildSimpleSelectSQL(config, tempTableName) {
+        const { selectedFields, targetTable, foreignKey, whereClause, orderByClause, limitValue, offsetValue } = config;
+        // Build SELECT fields
+        const selectFields = selectedFields
+            .map(f => `${f.expression} as "${f.alias}"`)
+            .join(', ');
+        // Build WHERE clause
+        const additionalWhere = whereClause ? ` AND ${whereClause}` : '';
+        // Build ORDER BY clause
+        const orderBySQL = orderByClause ? ` ORDER BY ${orderByClause}` : ` ORDER BY "id" DESC`;
+        // Build LIMIT/OFFSET
+        let limitOffsetClause = '';
+        if (limitValue !== undefined) {
+            limitOffsetClause = ` LIMIT ${limitValue}`;
+        }
+        if (offsetValue !== undefined) {
+            limitOffsetClause += ` OFFSET ${offsetValue}`;
+        }
+        // Simple SELECT with foreign key for grouping
+        const sql = `
+SELECT
+  "${foreignKey}" as parent_id,
+  ${selectFields}
+FROM "${targetTable}"
+WHERE "${foreignKey}" IN (SELECT id FROM ${tempTableName})${additionalWhere}
+${orderBySQL}
+${limitOffsetClause}
+    `.trim();
+        return sql;
+    }
+    /**
+     * Safely escape a value for SQL interpolation
+     * Used only in multi-statement queries with .simple() mode
+     */
+    escapeValue(value) {
+        if (value === null || value === undefined) {
+            return 'NULL';
+        }
+        if (typeof value === 'number') {
+            return String(value);
+        }
+        if (typeof value === 'boolean') {
+            return value ? 'TRUE' : 'FALSE';
+        }
+        if (typeof value === 'string') {
+            // Escape single quotes by doubling them (PostgreSQL standard)
+            return `'${value.replace(/'/g, "''")}'`;
+        }
+        if (value instanceof Date) {
+            return `'${value.toISOString()}'`;
+        }
+        // For arrays, objects, etc., convert to JSON string
+        return `'${JSON.stringify(value).replace(/'/g, "''")}'`;
+    }
+    /**
+     * Build aggregation for when there are no parent IDs
+     */
+    buildEmptyAggregation(config, context) {
+        // Return a result that will always give empty/default values
+        const dummyTableName = `empty_agg_${config.counter}`;
+        return {
+            sql: '',
+            params: [],
+            tableName: dummyTableName,
+            joinClause: '', // No join needed
+            selectExpression: config.defaultValue, // Just use default value
+            isCTE: false,
+        };
+    }
+    /**
+     * Build JSONB aggregation using temp table
+     */
+    buildJsonbAggregationSQL(config, tempTableName) {
+        const { selectedFields, targetTable, foreignKey, whereClause, orderByClause, limitValue, offsetValue, isDistinct } = config;
+        // Build the JSONB fields for jsonb_build_object
+        const jsonbFields = selectedFields
+            .map(f => `'${f.alias}', t.${f.expression}`)
+            .join(', ');
+        // Build WHERE clause (combine temp table join with additional filters)
+        const additionalWhere = whereClause ? ` AND ${whereClause}` : '';
+        // Build ORDER BY clause (use primary key DESC as default for consistent ordering matching JSONB)
+        const orderBySQL = orderByClause ? ` ORDER BY ${orderByClause}` : ` ORDER BY "id" DESC`;
+        // Build LIMIT/OFFSET (applied globally to match JSONB strategy behavior)
+        let limitOffsetClause = '';
+        if (limitValue !== undefined) {
+            limitOffsetClause = ` LIMIT ${limitValue}`;
+        }
+        if (offsetValue !== undefined) {
+            limitOffsetClause += ` OFFSET ${offsetValue}`;
+        }
+        // Build jsonb_agg ORDER BY clause
+        const jsonbAggOrderBy = orderByClause ? ` ORDER BY ${orderByClause}` : '';
+        // Build the SQL - matching JSONB strategy approach
+        const sql = `
+SELECT
+  t."${foreignKey}" as parent_id,
+  jsonb_agg(
+    jsonb_build_object(${jsonbFields})${jsonbAggOrderBy}
+  ) as data
+FROM (
+  SELECT *
+  FROM "${targetTable}"
+  WHERE "${foreignKey}" IN (SELECT id FROM ${tempTableName})${additionalWhere}
+  ${orderBySQL}
+  ${limitOffsetClause}
+) t
+GROUP BY t."${foreignKey}"
+    `.trim();
+        return sql;
+    }
+    /**
+     * Build array aggregation using temp table
+     */
+    buildArrayAggregationSQL(config, tempTableName) {
+        const { arrayField, targetTable, foreignKey, whereClause, orderByClause, limitValue, offsetValue } = config;
+        if (!arrayField) {
+            throw new Error('arrayField is required for array aggregation');
+        }
+        // Build WHERE clause
+        const additionalWhere = whereClause ? ` AND ${whereClause}` : '';
+        // Build ORDER BY clause (use primary key DESC as default for consistent ordering matching JSONB)
+        const orderBySQL = orderByClause ? ` ORDER BY ${orderByClause}` : ` ORDER BY "id" DESC`;
+        // Build LIMIT/OFFSET (applied globally to match JSONB strategy behavior)
+        let limitOffsetClause = '';
+        if (limitValue !== undefined) {
+            limitOffsetClause = ` LIMIT ${limitValue}`;
+        }
+        if (offsetValue !== undefined) {
+            limitOffsetClause += ` OFFSET ${offsetValue}`;
+        }
+        // Build array_agg ORDER BY clause
+        const arrayAggOrderBy = orderByClause ? ` ORDER BY ${orderByClause}` : '';
+        // Build the SQL - matching JSONB strategy approach
+        const sql = `
+SELECT
+  t."${foreignKey}" as parent_id,
+  array_agg(t."${arrayField}"${arrayAggOrderBy}) as data
+FROM (
+  SELECT "${foreignKey}", "${arrayField}"
+  FROM "${targetTable}"
+  WHERE "${foreignKey}" IN (SELECT id FROM ${tempTableName})${additionalWhere}
+  ${orderBySQL}
+  ${limitOffsetClause}
+) t
+GROUP BY t."${foreignKey}"
+    `.trim();
+        return sql;
+    }
+    /**
+     * Build scalar aggregation using temp table
+     */
+    buildScalarAggregationSQL(config, tempTableName) {
+        const { aggregationType, aggregateField, targetTable, foreignKey, whereClause } = config;
+        // Build WHERE clause
+        const additionalWhere = whereClause ? ` AND ${whereClause}` : '';
+        // Build aggregation expression
+        let aggregateExpression;
+        switch (aggregationType) {
+            case 'count':
+                // Count only rows where there's an actual join match (not the temp table row)
+                aggregateExpression = `COUNT(t."${foreignKey}")`;
+                break;
+            case 'min':
+            case 'max':
+            case 'sum':
+                if (!aggregateField) {
+                    throw new Error(`${aggregationType.toUpperCase()} requires an aggregate field`);
+                }
+                aggregateExpression = `${aggregationType.toUpperCase()}(t."${aggregateField}")`;
+                break;
+            default:
+                throw new Error(`Unknown aggregation type: ${aggregationType}`);
+        }
+        const sql = `
+SELECT
+  tmp.id as parent_id,
+  COALESCE(${aggregateExpression}, ${config.defaultValue}) as data
+FROM ${tempTableName} tmp
+LEFT JOIN "${targetTable}" t ON t."${foreignKey}" = tmp.id${additionalWhere}
+GROUP BY tmp.id
+    `.trim();
+        return sql;
+    }
+}
+exports.TempTableCollectionStrategy = TempTableCollectionStrategy;
+//# sourceMappingURL=temptable-collection-strategy.js.map

package/dist/query/strategies/temptable-collection-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temptable-collection-strategy.js","sourceRoot":"","sources":["../../../src/query/strategies/temptable-collection-strategy.ts"],"names":[],"mappings":"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"}

package/dist/query/subquery.d.ts

@@ -0,0 +1,152 @@
+import { WhereConditionBase, SqlBuildContext, FieldRef } from './conditions';
+/**
+ * Represents a subquery that can be used in various contexts
+ * TResult: The type of data the subquery returns
+ * TMode: 'scalar' | 'array' | 'table' - determines how the subquery can be used
+ */
+export declare class Subquery<TResult = any, TMode extends 'scalar' | 'array' | 'table' = 'table'> {
+    /**
+     * The SQL generator function - called with context to build SQL
+     */
+    private sqlBuilder;
+    /**
+     * Optional alias for the subquery when used as a table source
+     */
+    private alias?;
+    /**
+     * Selection metadata - preserves SqlFragments with mappers for table subqueries
+     */
+    private selectionMetadata?;
+    /**
+     * Phantom type marker for type checking
+     */
+    private __resultType?;
+    private __mode?;
+    constructor(sqlBuilder: (context: SqlBuildContext & {
+        tableAlias?: string;
+    }) => string, mode?: TMode, selectionMetadata?: Record<string, any>);
+    /**
+     * Set an alias for this subquery (used when subquery is a table source)
+     */
+    as(alias: string): Subquery<TResult, TMode>;
+    /**
+     * Build the SQL for this subquery
+     */
+    buildSql(context: SqlBuildContext & {
+        tableAlias?: string;
+    }): string;
+    /**
+     * Get the alias for this subquery
+     */
+    getAlias(): string | undefined;
+    /**
+     * Get the selection metadata (preserves SqlFragments with mappers)
+     */
+    getSelectionMetadata(): Record<string, any> | undefined;
+    /**
+     * Check if this is a scalar subquery
+     */
+    isScalar(): this is Subquery<TResult, 'scalar'>;
+    /**
+     * Check if this is an array subquery
+     */
+    isArray(): this is Subquery<TResult, 'array'>;
+    /**
+     * Check if this is a table subquery
+     */
+    isTable(): this is Subquery<TResult, 'table'>;
+}
+/**
+ * Subquery reference - used to reference columns from a subquery in a FROM clause
+ * This is similar to FieldRef but for subquery columns
+ */
+export interface SubqueryFieldRef<TName extends string = string, TValueType = any> extends FieldRef<TName, TValueType> {
+    readonly __isSubqueryField: true;
+}
+/**
+ * Helper to check if something is a Subquery
+ */
+export declare function isSubquery(value: any): value is Subquery;
+/**
+ * Condition: EXISTS (subquery)
+ */
+export declare class ExistsCondition extends WhereConditionBase {
+    private subquery;
+    constructor(subquery: Subquery);
+    buildSql(context: SqlBuildContext): string;
+}
+/**
+ * Condition: NOT EXISTS (subquery)
+ */
+export declare class NotExistsCondition extends WhereConditionBase {
+    private subquery;
+    constructor(subquery: Subquery);
+    buildSql(context: SqlBuildContext): string;
+}
+/**
+ * Condition: field IN (subquery)
+ * The subquery must return a single column
+ */
+export declare class InSubqueryCondition<T> extends WhereConditionBase {
+    private field;
+    private subquery;
+    constructor(field: FieldRef<any, T>, subquery: Subquery<T[], 'array'>);
+    buildSql(context: SqlBuildContext): string;
+}
+/**
+ * Condition: field NOT IN (subquery)
+ */
+export declare class NotInSubqueryCondition<T> extends WhereConditionBase {
+    private field;
+    private subquery;
+    constructor(field: FieldRef<any, T>, subquery: Subquery<T[], 'array'>);
+    buildSql(context: SqlBuildContext): string;
+}
+/**
+ * Comparison with scalar subquery
+ * Example: field = (SELECT ...)
+ */
+export declare class ScalarSubqueryComparison<T> extends WhereConditionBase {
+    private field;
+    private operator;
+    private subquery;
+    constructor(field: FieldRef<any, T>, operator: '=' | '!=' | '>' | '>=' | '<' | '<=', subquery: Subquery<T, 'scalar'>);
+    buildSql(context: SqlBuildContext): string;
+}
+/**
+ * Helper functions to create subquery conditions
+ */
+/**
+ * EXISTS condition
+ */
+export declare function exists(subquery: Subquery): ExistsCondition;
+/**
+ * NOT EXISTS condition
+ */
+export declare function notExists(subquery: Subquery): NotExistsCondition;
+/**
+ * IN subquery condition
+ */
+export declare function inSubquery<T>(field: FieldRef<any, T>, subquery: Subquery<T[], 'array'>): InSubqueryCondition<T>;
+/**
+ * NOT IN subquery condition
+ */
+export declare function notInSubquery<T>(field: FieldRef<any, T>, subquery: Subquery<T[], 'array'>): NotInSubqueryCondition<T>;
+/**
+ * Scalar subquery comparison helpers
+ */
+export declare function eqSubquery<T>(field: FieldRef<any, T>, subquery: Subquery<T, 'scalar'>): ScalarSubqueryComparison<T>;
+export declare function neSubquery<T>(field: FieldRef<any, T>, subquery: Subquery<T, 'scalar'>): ScalarSubqueryComparison<T>;
+export declare function gtSubquery<T>(field: FieldRef<any, T>, subquery: Subquery<T, 'scalar'>): ScalarSubqueryComparison<T>;
+export declare function gteSubquery<T>(field: FieldRef<any, T>, subquery: Subquery<T, 'scalar'>): ScalarSubqueryComparison<T>;
+export declare function ltSubquery<T>(field: FieldRef<any, T>, subquery: Subquery<T, 'scalar'>): ScalarSubqueryComparison<T>;
+export declare function lteSubquery<T>(field: FieldRef<any, T>, subquery: Subquery<T, 'scalar'>): ScalarSubqueryComparison<T>;
+/**
+ * Type helper: Extract result type from a subquery
+ */
+export type SubqueryResult<T> = T extends Subquery<infer R, any> ? R : never;
+/**
+ * Type helper: Extract mode from a subquery
+ */
+export type SubqueryMode<T> = T extends Subquery<any, infer M> ? M : never;
+//# sourceMappingURL=subquery.d.ts.map

package/dist/query/subquery.d.ts.map

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