@subsquid/solana-stream 1.0.0-portal-api.19316d → 1.0.0

package/lib/builder.d.ts

@@ -0,0 +1,92 @@
+import { PortalClient, PortalClientOptions } from '@subsquid/portal-client';
+import { Range } from '@subsquid/util-internal-range';
+import { DEFAULT_FIELDS, FieldSelection } from './data/model';
+import { BalanceRequest, InstructionRequest, LogRequest, RewardRequest, TokenBalanceRequest, TransactionRequest } from './data/request';
+import { type Query, QueryBuilder } from './query';
+import type { SolanaDataSource } from './source';
+interface BlockRange {
+    range?: Range;
+}
+export declare class DataSourceBuilder<F extends FieldSelection = typeof DEFAULT_FIELDS> {
+    private requests;
+    private fields?;
+    private blockRange?;
+    private portal?;
+    /**
+     * Set SQD Network Portal endpoint.
+     *
+     * SQD Network allows to get data from blocks up to
+     * infinite times faster and more efficient than via regular RPC.
+     *
+     * @example
+     * source.setPortal('https://portal.sqd.dev/datasets/solana-mainnet')
+     */
+    setPortal(portal: string | PortalClientOptions | PortalClient): this;
+    /**
+     * Limits the range of blocks to fetch.
+     *
+     * Note, that block heights should be used instead of slots.
+     */
+    setBlockRange(range?: Range): this;
+    /**
+     * Configure a set of fetched fields
+     */
+    setFields<F extends FieldSelection>(fields: F): DataSourceBuilder<F>;
+    /**
+     * Add a portal query - a set of item filters that share a block range.
+     *
+     * Accepts either a prebuilt {@link Query} object or a
+     * {@link QueryBuilder}, in which case {@link QueryBuilder#build} is
+     * invoked automatically.
+     *
+     * @example
+     * ```ts
+     * source.addQuery(new QueryBuilder()
+     *     .setRange({from: 250_000_000})
+     *     .addInstruction({where: {programId: [PROGRAM_ID]}, include: {logs: true}})
+     *     .addTransaction({where: {feePayer: [FEE_PAYER]}})
+     * )
+     * ```
+     */
+    addQuery(query: Query | QueryBuilder): this;
+    /**
+     * Shorthand for {@link DataSourceBuilder#addQuery} with a query that
+     * only sets {@link QueryBuilder#includeAllBlocks} (and optionally a
+     * range).
+     */
+    includeAllBlocks(range?: Range): this;
+    /**
+     * Shorthand for {@link DataSourceBuilder#addQuery} with a query that
+     * contains a single transaction filter.
+     */
+    addTransaction(options: TransactionRequest & BlockRange): this;
+    /**
+     * Shorthand for {@link DataSourceBuilder#addQuery} with a query that
+     * contains a single instruction filter.
+     */
+    addInstruction(options: InstructionRequest & BlockRange): this;
+    /**
+     * Shorthand for {@link DataSourceBuilder#addQuery} with a query that
+     * contains a single log filter.
+     */
+    addLog(options: LogRequest & BlockRange): this;
+    /**
+     * Shorthand for {@link DataSourceBuilder#addQuery} with a query that
+     * contains a single balance filter.
+     */
+    addBalance(options: BalanceRequest & BlockRange): this;
+    /**
+     * Shorthand for {@link DataSourceBuilder#addQuery} with a query that
+     * contains a single token balance filter.
+     */
+    addTokenBalance(options: TokenBalanceRequest & BlockRange): this;
+    /**
+     * Shorthand for {@link DataSourceBuilder#addQuery} with a query that
+     * contains a single reward filter.
+     */
+    addReward(options: RewardRequest & BlockRange): this;
+    private getRequests;
+    build(): SolanaDataSource<F>;
+}
+export {};
+//# sourceMappingURL=builder.d.ts.map

package/lib/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,mBAAmB,EAAC,MAAM,yBAAyB,CAAA;AAEzE,OAAO,EAAsC,KAAK,EAAiC,MAAM,+BAA+B,CAAA;AAExH,OAAO,EAAC,cAAc,EAAE,cAAc,EAAC,MAAM,cAAc,CAAA;AAC3D,OAAO,EACH,cAAc,EAEd,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EACrB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAC,KAAK,KAAK,EAAE,YAAY,EAAC,MAAM,SAAS,CAAA;AAChD,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,UAAU,CAAA;AAE9C,UAAU,UAAU;IAChB,KAAK,CAAC,EAAE,KAAK,CAAA;CAChB;AAED,qBAAa,iBAAiB,CAAC,CAAC,SAAS,cAAc,GAAG,OAAO,cAAc;IAC3E,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,MAAM,CAAC,CAAgB;IAC/B,OAAO,CAAC,UAAU,CAAC,CAAO;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAoC;IAEnD;;;;;;;;OAQG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,GAAG,YAAY,GAAG,IAAI;IASpE;;;;OAIG;IACH,aAAa,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAKlC;;OAEG;IACH,SAAS,CAAC,CAAC,SAAS,cAAc,EAAE,MAAM,EAAE,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC;IAKpE;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,GAAG,IAAI;IAK3C;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAOrC;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,UAAU,GAAG,IAAI;IAQ9D;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,UAAU,GAAG,IAAI;IAQ9D;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI;IAQ9C;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU,GAAG,IAAI;IAQtD;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,UAAU,GAAG,IAAI;IAQhE;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,UAAU,GAAG,IAAI;IAQpD,OAAO,CAAC,WAAW;IA2BnB,KAAK,IAAI,gBAAgB,CAAC,CAAC,CAAC;CAQ/B"}

package/lib/builder.js

@@ -0,0 +1,182 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataSourceBuilder = void 0;
+const portal_client_1 = require("@subsquid/portal-client");
+const util_internal_processor_tools_1 = require("@subsquid/util-internal-processor-tools");
+const util_internal_range_1 = require("@subsquid/util-internal-range");
+const assert_1 = __importDefault(require("assert"));
+const model_1 = require("./data/model");
+const source_1 = require("./portal/source");
+const query_1 = require("./query");
+class DataSourceBuilder {
+    constructor() {
+        this.requests = [];
+    }
+    /**
+     * Set SQD Network Portal endpoint.
+     *
+     * SQD Network allows to get data from blocks up to
+     * infinite times faster and more efficient than via regular RPC.
+     *
+     * @example
+     * source.setPortal('https://portal.sqd.dev/datasets/solana-mainnet')
+     */
+    setPortal(portal) {
+        if (typeof portal == 'string') {
+            this.portal = { url: portal };
+        }
+        else {
+            this.portal = portal;
+        }
+        return this;
+    }
+    /**
+     * Limits the range of blocks to fetch.
+     *
+     * Note, that block heights should be used instead of slots.
+     */
+    setBlockRange(range) {
+        this.blockRange = range;
+        return this;
+    }
+    /**
+     * Configure a set of fetched fields
+     */
+    setFields(fields) {
+        this.fields = fields;
+        return this;
+    }
+    /**
+     * Add a portal query - a set of item filters that share a block range.
+     *
+     * Accepts either a prebuilt {@link Query} object or a
+     * {@link QueryBuilder}, in which case {@link QueryBuilder#build} is
+     * invoked automatically.
+     *
+     * @example
+     * ```ts
+     * source.addQuery(new QueryBuilder()
+     *     .setRange({from: 250_000_000})
+     *     .addInstruction({where: {programId: [PROGRAM_ID]}, include: {logs: true}})
+     *     .addTransaction({where: {feePayer: [FEE_PAYER]}})
+     * )
+     * ```
+     */
+    addQuery(query) {
+        this.requests.push(query instanceof query_1.QueryBuilder ? query.build() : query);
+        return this;
+    }
+    /**
+     * Shorthand for {@link DataSourceBuilder#addQuery} with a query that
+     * only sets {@link QueryBuilder#includeAllBlocks} (and optionally a
+     * range).
+     */
+    includeAllBlocks(range) {
+        return this.addQuery({
+            range: range ?? { from: 0 },
+            request: { includeAllBlocks: true },
+        });
+    }
+    /**
+     * Shorthand for {@link DataSourceBuilder#addQuery} with a query that
+     * contains a single transaction filter.
+     */
+    addTransaction(options) {
+        let { range, ...req } = options;
+        return this.addQuery({
+            range: range ?? { from: 0 },
+            request: { transactions: [req] },
+        });
+    }
+    /**
+     * Shorthand for {@link DataSourceBuilder#addQuery} with a query that
+     * contains a single instruction filter.
+     */
+    addInstruction(options) {
+        let { range, ...req } = options;
+        return this.addQuery({
+            range: range ?? { from: 0 },
+            request: { instructions: [req] },
+        });
+    }
+    /**
+     * Shorthand for {@link DataSourceBuilder#addQuery} with a query that
+     * contains a single log filter.
+     */
+    addLog(options) {
+        let { range, ...req } = options;
+        return this.addQuery({
+            range: range ?? { from: 0 },
+            request: { logs: [req] },
+        });
+    }
+    /**
+     * Shorthand for {@link DataSourceBuilder#addQuery} with a query that
+     * contains a single balance filter.
+     */
+    addBalance(options) {
+        let { range, ...req } = options;
+        return this.addQuery({
+            range: range ?? { from: 0 },
+            request: { balances: [req] },
+        });
+    }
+    /**
+     * Shorthand for {@link DataSourceBuilder#addQuery} with a query that
+     * contains a single token balance filter.
+     */
+    addTokenBalance(options) {
+        let { range, ...req } = options;
+        return this.addQuery({
+            range: range ?? { from: 0 },
+            request: { tokenBalances: [req] },
+        });
+    }
+    /**
+     * Shorthand for {@link DataSourceBuilder#addQuery} with a query that
+     * contains a single reward filter.
+     */
+    addReward(options) {
+        let { range, ...req } = options;
+        return this.addQuery({
+            range: range ?? { from: 0 },
+            request: { rewards: [req] },
+        });
+    }
+    getRequests() {
+        function concat(a, b) {
+            let result = [];
+            if (a) {
+                result.push(...a);
+            }
+            if (b) {
+                result.push(...b);
+            }
+            return result.length == 0 ? undefined : result;
+        }
+        let requests = (0, util_internal_range_1.mergeRangeRequests)(this.requests, (a, b) => {
+            return {
+                includeAllBlocks: a.includeAllBlocks || b.includeAllBlocks,
+                transactions: concat(a.transactions, b.transactions),
+                instructions: concat(a.instructions, b.instructions),
+                logs: concat(a.logs, b.logs),
+                balances: concat(a.balances, b.balances),
+                tokenBalances: concat(a.tokenBalances, b.tokenBalances),
+                rewards: concat(a.rewards, b.rewards),
+            };
+        });
+        return (0, util_internal_range_1.applyRangeBound)(requests, this.blockRange);
+    }
+    build() {
+        (0, assert_1.default)(this.portal, 'Portal settings not set');
+        let portal = this.portal instanceof portal_client_1.PortalClient ? this.portal : new portal_client_1.PortalClient(this.portal);
+        return new source_1.PortalSolanaDataSource(portal, this.fields ?? model_1.DEFAULT_FIELDS, () => this.getRequests(), {
+            squidId: (0, util_internal_processor_tools_1.getOrGenerateSquidId)(),
+        });
+    }
+}
+exports.DataSourceBuilder = DataSourceBuilder;
+//# sourceMappingURL=builder.js.map

package/lib/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":";;;;;;AAAA,2DAAyE;AACzE,2FAA4E;AAC5E,uEAAwH;AACxH,oDAA2B;AAC3B,wCAA2D;AAU3D,4CAAsD;AACtD,mCAAgD;AAOhD,MAAa,iBAAiB;IAA9B;QACY,aAAQ,GAAgC,EAAE,CAAA;IAqLtD,CAAC;IAhLG;;;;;;;;OAQG;IACH,SAAS,CAAC,MAAmD;QACzD,IAAI,OAAO,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,GAAG,EAAC,GAAG,EAAE,MAAM,EAAC,CAAA;QAC/B,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACxB,CAAC;QACD,OAAO,IAAI,CAAA;IACf,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,KAAa;QACvB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAA;QACvB,OAAO,IAAI,CAAA;IACf,CAAC;IAED;;OAEG;IACH,SAAS,CAA2B,MAAS;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,OAAO,IAAW,CAAA;IACtB,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,KAA2B;QAChC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,YAAY,oBAAY,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QACzE,OAAO,IAAI,CAAA;IACf,CAAC;IAED;;;;OAIG;IACH,gBAAgB,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC;YACjB,KAAK,EAAE,KAAK,IAAI,EAAC,IAAI,EAAE,CAAC,EAAC;YACzB,OAAO,EAAE,EAAC,gBAAgB,EAAE,IAAI,EAAC;SACpC,CAAC,CAAA;IACN,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,OAAwC;QACnD,IAAI,EAAC,KAAK,EAAE,GAAG,GAAG,EAAC,GAAG,OAAO,CAAA;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC;YACjB,KAAK,EAAE,KAAK,IAAI,EAAC,IAAI,EAAE,CAAC,EAAC;YACzB,OAAO,EAAE,EAAC,YAAY,EAAE,CAAC,GAAG,CAAC,EAAC;SACjC,CAAC,CAAA;IACN,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,OAAwC;QACnD,IAAI,EAAC,KAAK,EAAE,GAAG,GAAG,EAAC,GAAG,OAAO,CAAA;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC;YACjB,KAAK,EAAE,KAAK,IAAI,EAAC,IAAI,EAAE,CAAC,EAAC;YACzB,OAAO,EAAE,EAAC,YAAY,EAAE,CAAC,GAAG,CAAC,EAAC;SACjC,CAAC,CAAA;IACN,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,OAAgC;QACnC,IAAI,EAAC,KAAK,EAAE,GAAG,GAAG,EAAC,GAAG,OAAO,CAAA;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC;YACjB,KAAK,EAAE,KAAK,IAAI,EAAC,IAAI,EAAE,CAAC,EAAC;YACzB,OAAO,EAAE,EAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAC;SACzB,CAAC,CAAA;IACN,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,OAAoC;QAC3C,IAAI,EAAC,KAAK,EAAE,GAAG,GAAG,EAAC,GAAG,OAAO,CAAA;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC;YACjB,KAAK,EAAE,KAAK,IAAI,EAAC,IAAI,EAAE,CAAC,EAAC;YACzB,OAAO,EAAE,EAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAC;SAC7B,CAAC,CAAA;IACN,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,OAAyC;QACrD,IAAI,EAAC,KAAK,EAAE,GAAG,GAAG,EAAC,GAAG,OAAO,CAAA;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC;YACjB,KAAK,EAAE,KAAK,IAAI,EAAC,IAAI,EAAE,CAAC,EAAC;YACzB,OAAO,EAAE,EAAC,aAAa,EAAE,CAAC,GAAG,CAAC,EAAC;SAClC,CAAC,CAAA;IACN,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,OAAmC;QACzC,IAAI,EAAC,KAAK,EAAE,GAAG,GAAG,EAAC,GAAG,OAAO,CAAA;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC;YACjB,KAAK,EAAE,KAAK,IAAI,EAAC,IAAI,EAAE,CAAC,EAAC;YACzB,OAAO,EAAE,EAAC,OAAO,EAAE,CAAC,GAAG,CAAC,EAAC;SAC5B,CAAC,CAAA;IACN,CAAC;IAEO,WAAW;QACf,SAAS,MAAM,CAAI,CAAO,EAAE,CAAO;YAC/B,IAAI,MAAM,GAAQ,EAAE,CAAA;YACpB,IAAI,CAAC,EAAE,CAAC;gBACJ,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;YACrB,CAAC;YACD,IAAI,CAAC,EAAE,CAAC;gBACJ,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;YACrB,CAAC;YACD,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAA;QAClD,CAAC;QAED,IAAI,QAAQ,GAAG,IAAA,wCAAkB,EAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACtD,OAAO;gBACH,gBAAgB,EAAE,CAAC,CAAC,gBAAgB,IAAI,CAAC,CAAC,gBAAgB;gBAC1D,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC;gBACpD,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC;gBACpD,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;gBAC5B,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC;gBACxC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC;gBACvD,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC;aACxC,CAAA;QACL,CAAC,CAAC,CAAA;QAEF,OAAO,IAAA,qCAAe,EAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;IACrD,CAAC;IAED,KAAK;QACD,IAAA,gBAAM,EAAC,IAAI,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAA;QAE9C,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,YAAY,4BAAY,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,4BAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC9F,OAAO,IAAI,+BAAsB,CAAI,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,sBAAc,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE;YAClG,OAAO,EAAE,IAAA,oDAAoB,GAAE;SAClC,CAAC,CAAA;IACN,CAAC;CACJ;AAtLD,8CAsLC"}

package/lib/data/fields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/data/fields.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,QAAQ,EAAC,MAAM,aAAa,CAAA;AAsBpC,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAUpF"}
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/data/fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,aAAa,CAAA;AAGpC,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAUpF"}

package/lib/data/fields.js

@@ -1,20 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.project = project;
-function merge(def, requested = {}) {
-    let fields = {};
-    for (let key in def) {
-        if (requested[key] !== false) {
-            fields[key] = def[key];
-        }
-    }
-    for (let key in requested) {
-        if (requested[key]) {
-            fields[key] = true;
-        }
-    }
-    return fields;
-}
 function project(fields, obj) {
     if (fields == null)
         return {};

package/lib/data/fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/data/fields.ts"],"names":[],"mappings":";;AAuBA,0BAUC;AA7BD,SAAS,KAAK,CAAsB,GAAmB,EAAE,YAA4B,EAAE;IACnF,IAAI,MAAM,GAAmB,EAAE,CAAA;IAE/B,KAAK,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;QAClB,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;QAC1B,CAAC;IACL,CAAC;IAED,KAAK,IAAI,GAAG,IAAI,SAAS,EAAE,CAAC;QACxB,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;QACtB,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAA;AACjB,CAAC;AAGD,SAAgB,OAAO,CAAI,MAAqC,EAAE,GAAM;IACpE,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,EAAE,CAAA;IAC7B,IAAI,MAAM,GAAe,EAAE,CAAA;IAC3B,IAAI,GAAY,CAAA;IAChB,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;QAC1B,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAA;AACjB,CAAC"}
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/data/fields.ts"],"names":[],"mappings":";;AAGA,0BAUC;AAVD,SAAgB,OAAO,CAAI,MAAqC,EAAE,GAAM;IACpE,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,EAAE,CAAA;IAC7B,IAAI,MAAM,GAAe,EAAE,CAAA;IAC3B,IAAI,GAAY,CAAA;IAChB,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;QAC1B,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAA;AACjB,CAAC"}

package/lib/data/model.d.ts

@@ -1,14 +1,14 @@
 import type * as data from '@subsquid/solana-normalization';
 import type { BalanceRequiredFields, BlockRequiredFields, InstructionRequiredFields, LogRequiredFields, RewardRequiredFields, TokenBalanceRequiredFields, TransactionRequiredFields } from './partial';
 import type { GetFields, Select, Selector, Simplify } from './type-util';
-/**
- * Hex encoded binary string
- */
+/** Hex encoded binary string. */
 export type Bytes = string;
+/** Base58 encoded binary string. */
+export type Base58Bytes = string;
 /**
- * Base58 encoded binary string
+ * User-facing field selection. Each section is an optional `Selector`
+ * over that section's non-required fields.
  */
-export type Base58Bytes = string;
 export interface FieldSelection {
     block?: Selector<Exclude<keyof data.BlockHeader, BlockRequiredFields>>;
     transaction?: Selector<Exclude<keyof data.Transaction, TransactionRequiredFields>>;
@@ -18,6 +18,12 @@ export interface FieldSelection {
     tokenBalance?: Selector<Exclude<keyof data.TokenBalance, TokenBalanceRequiredFields>>;
     reward?: Selector<Exclude<keyof data.Reward, RewardRequiredFields>>;
 }
+export type FieldKey = keyof FieldSelection;
+/**
+ * Default field set applied when {@link DataSourceBuilder#setFields} is not
+ * called.  `as const` preserves the literal `true` values so they feed through
+ * {@link GetFields} correctly.
+ */
 export declare const DEFAULT_FIELDS: {
     readonly block: {
         readonly timestamp: true;
@@ -56,7 +62,11 @@ export declare const DEFAULT_FIELDS: {
         readonly rewardType: true;
     };
 };
-type Item<Data, RequiredFields extends keyof Data, F extends FieldSelection, K extends keyof FieldSelection> = Simplify<Pick<Data, RequiredFields> & Select<Data, GetFields<FieldSelection, typeof DEFAULT_FIELDS, F, K>>>;
+/**
+ * A concrete item type derived from a raw data shape, the always-present
+ * required keys, and a per-section field selection.
+ */
+type Item<Data, Required extends keyof Data, F extends FieldSelection, K extends FieldKey> = Simplify<Pick<Data, Required> & Select<Data, GetFields<F, K>>>;
 export type BlockHeader<F extends FieldSelection = {}> = Item<data.BlockHeader, BlockRequiredFields, F, 'block'>;
 export type Transaction<F extends FieldSelection = {}> = Item<data.Transaction, TransactionRequiredFields, F, 'transaction'>;
 export type Instruction<F extends FieldSelection = {}> = Item<data.Instruction, InstructionRequiredFields, F, 'instruction'>;

package/lib/data/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/data/model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/data/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,IAAI,MAAM,gCAAgC,CAAA;AAC3D,OAAO,KAAK,EACR,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EAC5B,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAC,MAAM,aAAa,CAAA;AAEtE,iCAAiC;AACjC,MAAM,MAAM,KAAK,GAAG,MAAM,CAAA;AAE1B,oCAAoC;AACpC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAA;AAEhC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B,KAAK,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC,CAAA;IACtE,WAAW,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,yBAAyB,CAAC,CAAC,CAAA;IAClF,WAAW,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,yBAAyB,CAAC,CAAC,CAAA;IAClF,GAAG,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAA;IACjE,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAA;IACtE,YAAY,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAC,CAAA;IACrF,MAAM,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAA;CACtE;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAA;AAE3C;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCQ,CAAA;AAEnC;;;GAGG;AACH,KAAK,IAAI,CAAC,IAAI,EAAE,QAAQ,SAAS,MAAM,IAAI,EAAE,CAAC,SAAS,cAAc,EAAE,CAAC,SAAS,QAAQ,IAAI,QAAQ,CACjG,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CACvD,CAAA;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,cAAc,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,mBAAmB,EAAE,CAAC,EAAE,OAAO,CAAC,CAAA;AAEhH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,cAAc,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,yBAAyB,EAAE,CAAC,EAAE,aAAa,CAAC,CAAA;AAE5H,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,cAAc,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,yBAAyB,EAAE,CAAC,EAAE,aAAa,CAAC,CAAA;AAE5H,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,cAAc,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,iBAAiB,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;AAE1G,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,qBAAqB,EAAE,CAAC,EAAE,SAAS,CAAC,CAAA;AAE5G,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,cAAc,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,0BAA0B,EAAE,CAAC,EAAE,cAAc,CAAC,CAAA;AAEhI,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,cAAc,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAA;AAExG,MAAM,WAAW,KAAK,CAAC,CAAC,SAAS,cAAc,GAAG,EAAE;IAChD,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;IACtB,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9B,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9B,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAA;IACrB,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;IACtB,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAA;IAChC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;CACvB"}

package/lib/data/model.js

@@ -1,6 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_FIELDS = void 0;
+/**
+ * Default field set applied when {@link DataSourceBuilder#setFields} is not
+ * called.  `as const` preserves the literal `true` values so they feed through
+ * {@link GetFields} correctly.
+ */
 exports.DEFAULT_FIELDS = {
     block: {
         timestamp: true,

package/lib/data/model.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/data/model.ts"],"names":[],"mappings":";;;AAgCa,QAAA,cAAc,GAAG;IAC1B,KAAK,EAAE;QACH,SAAS,EAAE,IAAI;KAClB;IACD,WAAW,EAAE;QACT,UAAU,EAAE,IAAI;QAChB,GAAG,EAAE,IAAI;KACZ;IACD,WAAW,EAAE;QACT,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,IAAI;KACpB;IACD,GAAG,EAAE;QACD,SAAS,EAAE,IAAI;QACf,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,IAAI;KAChB;IACD,OAAO,EAAE;QACL,GAAG,EAAE,IAAI;QACT,IAAI,EAAE,IAAI;KACb;IACD,YAAY,EAAE;QACV,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,IAAI;KACnB;IACD,MAAM,EAAE;QACJ,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,IAAI;KACnB;CACK,CAAA"}
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/data/model.ts"],"names":[],"mappings":";;;AAkCA;;;;GAIG;AACU,QAAA,cAAc,GAAG;IAC1B,KAAK,EAAE;QACH,SAAS,EAAE,IAAI;KAClB;IACD,WAAW,EAAE;QACT,UAAU,EAAE,IAAI;QAChB,GAAG,EAAE,IAAI;KACZ;IACD,WAAW,EAAE;QACT,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,IAAI;KACpB;IACD,GAAG,EAAE;QACD,SAAS,EAAE,IAAI;QACf,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,IAAI;KAChB;IACD,OAAO,EAAE;QACL,GAAG,EAAE,IAAI;QACT,IAAI,EAAE,IAAI;KACb;IACD,YAAY,EAAE;QACV,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,IAAI;KACnB;IACD,MAAM,EAAE;QACJ,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,IAAI;KACnB;CAC8B,CAAA"}

package/lib/data/request.d.ts

@@ -1,7 +1,6 @@
 import { LogMessage } from '@subsquid/solana-normalization';
-import { Base58Bytes, FieldSelection } from './model';
-export interface DataRequest<F extends FieldSelection> {
-    fields?: F;
+import { Base58Bytes } from './model';
+export interface DataRequest {
     includeAllBlocks?: boolean;
     transactions?: TransactionRequest[];
     instructions?: InstructionRequest[];

package/lib/data/request.d.ts.map

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

package/lib/data/type-util.d.ts

@@ -1,20 +1,42 @@
+/**
+ * Flattens an intersection type into a single object shape for nicer IDE hover
+ * output. The trailing `& {}` is a no-op at the type level but forces the
+ * compiler to normalize the representation.
+ */
 export type Simplify<T> = {
     [K in keyof T]: T[K];
 } & {};
-export type ExcludeUndefined<T> = {
-    [K in keyof T as undefined extends T[K] ? never : K]: T[K];
-} & {};
-export type GetFields<FieldSelectionType, Defaults extends FieldSelectionType, Selection extends FieldSelectionType, K extends keyof FieldSelectionType> = TrueFields<MergeDefault<Selection[K], Defaults[K]>>;
-type MergeDefault<T, D> = Simplify<undefined extends T ? D : Omit<D, keyof ExcludeUndefined<T>> & ExcludeUndefined<T>>;
-type TrueFields<F> = keyof {
-    [K in keyof F as true extends F[K] ? K : never]: true;
-};
+/**
+ * Extracts the string keys of `F` whose values include the literal `true`.
+ *
+ * @example
+ * type Keys = TrueFields<{a: true; b: false; c?: boolean}>
+ * // "a" | "c"  -- `c`'s type includes `true` through `boolean`
+ */
+export type TrueFields<F> = {
+    [K in keyof F]-?: true extends F[K] ? K : never;
+}[keyof F];
+/**
+ * Picks the set of truthy field keys for a given section `K` of a
+ * `FieldSelection`-shaped type `F`.
+ */
+export type GetFields<F, K extends keyof F> = TrueFields<F[K]>;
+/**
+ * Picks `Fields` from `T` while distributing over unions, so members of a
+ * discriminated union are narrowed independently.
+ */
 export type Select<T, Fields> = T extends any ? Simplify<Pick<T, Extract<keyof T, Fields>>> : never;
-export type Selector<Fields extends string | number | symbol> = {
+/**
+ * Optional boolean flag map over a finite set of string keys.
+ *
+ * Shape: `{[K in Fields]?: boolean}` - equivalent to `Partial<Record<Fields, boolean>>`.
+ */
+export type Selector<Fields extends PropertyKey> = {
     [P in Fields]?: boolean;
 };
-export type MakePartial<T, Required extends keyof T> = Simplify<Pick<T, Required> & {
-    [K in keyof T as K extends Required ? never : K]+?: T[K];
-}>;
-export {};
+/**
+ * Produces a type with `Required` keys kept as-is and all other keys made
+ * optional.
+ */
+export type MakePartial<T, Required extends keyof T> = Simplify<Pick<T, Required> & Partial<Omit<T, Required>>>;
 //# sourceMappingURL=type-util.d.ts.map

package/lib/data/type-util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type-util.d.ts","sourceRoot":"","sources":["../../src/data/type-util.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KACrB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACvB,GAAG,EAAE,CAAA;AAGN,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;KAC7B,CAAC,IAAI,MAAM,CAAC,IAAI,SAAS,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC7D,GAAG,EAAE,CAAA;AAGN,MAAM,MAAM,SAAS,CACjB,kBAAkB,EAClB,QAAQ,SAAS,kBAAkB,EACnC,SAAS,SAAS,kBAAkB,EACpC,CAAC,SAAS,MAAM,kBAAkB,IAClC,UAAU,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAGvD,KAAK,YAAY,CAAC,CAAC,EAAE,CAAC,IAAI,QAAQ,CAC9B,SAAS,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,MAAM,gBAAgB,CAAC,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CACrF,CAAA;AAGD,KAAK,UAAU,CAAC,CAAC,IAAI,MAAM;KACtB,CAAC,IAAI,MAAM,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,IAAI;CACxD,CAAA;AAGD,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,SAAS,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAA;AAGnG,MAAM,MAAM,QAAQ,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,IAAI;KAC3D,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,OAAO;CAC1B,CAAA;AAGD,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,QAAQ,SAAS,MAAM,CAAC,IAAI,QAAQ,CAC3D,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,GACjB;KACK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC3D,CACJ,CAAA"}
+{"version":3,"file":"type-util.d.ts","sourceRoot":"","sources":["../../src/data/type-util.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KAAE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAC,GAAG,EAAE,CAAA;AAErD;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;KACvB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;CAClD,CAAC,MAAM,CAAC,CAAC,CAAA;AAEV;;;GAGG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAE9D;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,SAAS,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAA;AAEnG;;;;GAIG;AACH,MAAM,MAAM,QAAQ,CAAC,MAAM,SAAS,WAAW,IAAI;KAC9C,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,OAAO;CAC1B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,QAAQ,SAAS,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA"}

package/lib/index.d.ts

@@ -1,4 +1,7 @@
 export * from './data/model';
 export * from './instruction';
+export * from './builder';
+export * from './query';
 export * from './source';
+export * from './portal/source';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA"}

package/lib/index.js

@@ -16,5 +16,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./data/model"), exports);
 __exportStar(require("./instruction"), exports);
+__exportStar(require("./builder"), exports);
+__exportStar(require("./query"), exports);
 __exportStar(require("./source"), exports);
+__exportStar(require("./portal/source"), exports);
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA4B;AAC5B,gDAA6B;AAC7B,2CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA4B;AAC5B,gDAA6B;AAC7B,4CAAyB;AACzB,0CAAuB;AACvB,2CAAwB;AACxB,kDAA+B"}

package/lib/{merge.test.d.ts.map → portal/merge.test.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"merge.test.d.ts","sourceRoot":"","sources":["../src/merge.test.ts"],"names":[],"mappings":""}
+{"version":3,"file":"merge.test.d.ts","sourceRoot":"","sources":["../../src/portal/merge.test.ts"],"names":[],"mappings":""}