@tanstack/db/dist/cjs/live-query-options.cjs

A reactive client store for building super fast apps on sync

"use strict";
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
const index = require("./query/builder/index.cjs");
const ir = require("./query/ir.cjs");
const liveQueryAdapter = require("./live-query-adapter.cjs");
const liveQueryCollection = require("./query/live-query-collection.cjs");
const pooledLiveQuery = require("./query/pooled-live-query.cjs");
const irStableIdentity = require("./query/ir-stable-identity.cjs");
const runtimeReferenceIdentity = require("./query/runtime-reference-identity.cjs");
const errorMessage = require("./error-message.cjs");
function resumeDeferredLiveQueryCollections(collections) {
  const pending = Array.from(collections);
  collections.clear();
  let firstFailure;
  for (const collection of pending) {
    try {
      collection._resumeSyncStart();
    } catch (error) {
      firstFailure ??= { error };
    }
  }
  if (firstFailure) throw firstFailure.error;
}
function createInitialQueryBuilder() {
  return new index.BaseQueryBuilder();
}
function createCollectionResolver(dbClient, deferredCollections) {
  if (!dbClient) return void 0;
  return (options) => {
    if (!deferredCollections) {
      return dbClient.collection(
        options
      );
    }
    const collection = dbClient._materializeCollectionForRender(
      options
    );
    if (collection._deferSyncStart()) deferredCollections.add(collection);
    return collection;
  };
}
function prepareLiveQueryValue(value, dbClient, deferredCollections) {
  if (typeof value === `function`) {
    return prepareLiveQueryValue(
      value(createInitialQueryBuilder()),
      dbClient,
      deferredCollections
    );
  }
  if (value instanceof index.BaseQueryBuilder) {
    return value._bindCollectionSources(
      createCollectionResolver(dbClient, deferredCollections)
    );
  }
  if (value && typeof value === `object` && !liveQueryAdapter.isCollection(value) && !(value instanceof index.BaseQueryBuilder) && `query` in value) {
    const {
      query,
      queryKey: _queryKey,
      client: _client,
      ...config
    } = value;
    const preparedQuery = prepareLiveQueryValue(
      query,
      dbClient,
      deferredCollections
    );
    if (preparedQuery === void 0 || preparedQuery === null) {
      return preparedQuery;
    }
    return {
      ...config,
      query: preparedQuery
    };
  }
  return value;
}
function getPreparedLiveQuerySources(value, onUnboundDescriptor) {
  if (liveQueryAdapter.isCollection(value)) return [value];
  const query = value instanceof index.BaseQueryBuilder ? value : value && typeof value === `object` && `query` in value ? value.query : value;
  if (query instanceof index.BaseQueryBuilder) {
    return ir.collectSourceRefs(query._getQuery()).map(
      (source) => source.type === `descriptorRef` ? onUnboundDescriptor ? onUnboundDescriptor(source.alias) : ir.requireCollectionSource(source) : source.collection
    );
  }
  return liveQueryAdapter.isCollection(query) ? [query] : [];
}
function getPreparedLiveQueryIdentity(value) {
  if (liveQueryAdapter.isCollection(value)) return [`collection`, value.id];
  if (value instanceof index.BaseQueryBuilder) {
    const pooled = pooledLiveQuery.getPooledQueryIdentity(value);
    return pooled === void 0 ? [`query`, irStableIdentity.getStableQueryBuilderHash(value)] : [`pooled`, pooled];
  }
  if (value && typeof value === `object` && `query` in value) {
    const config = value;
    return [
      `config`,
      getPreparedLiveQueryIdentity(config.query),
      [`getKey`, config.getKey],
      [`schema`, config.schema],
      [`singleResult`, config.singleResult === true],
      [
        `defaultStringCollation`,
        runtimeReferenceIdentity.getStringCollationIdentity(config.defaultStringCollation)
      ]
    ];
  }
  if (value === void 0 || value === null) return [`disabled`];
  return [`value`, value];
}
function getLiveQueryHash(preparedValue, queryKey) {
  const identity = queryKey?.length ? [`queryKey`, queryKey] : liveQueryAdapter.isCollection(preparedValue) ? [`collection`, preparedValue.id] : [`derived`, getPreparedLiveQueryIdentity(preparedValue)];
  return irStableIdentity.getStableValueHash(identity, `queryKey`);
}
function poolConfig(config, gcTime) {
  if (!(config.query instanceof index.BaseQueryBuilder) || !Object.keys(config).every((key) => key === `query` || key === `gcTime`)) {
    return void 0;
  }
  return pooledLiveQuery.createPooledLiveQuery(config.query, {
    gcTime: config.gcTime ?? gcTime
  });
}
function resolveLiveQueryValue(value, {
  gcTime,
  pool = true,
  startSync = true
} = {}) {
  if (value === void 0 || value === null) return null;
  if (liveQueryAdapter.isCollection(value)) {
    value.startSyncImmediate();
    return value;
  }
  if (value instanceof index.BaseQueryBuilder) {
    return (pool ? pooledLiveQuery.createPooledLiveQuery(value, { gcTime }) : void 0) ?? liveQueryCollection.createLiveQueryCollection({ query: value, startSync, gcTime });
  }
  if (typeof value === `object`) {
    const config = value;
    return (pool ? poolConfig(config, gcTime) : void 0) ?? liveQueryCollection.createLiveQueryCollection({ startSync, gcTime, ...config });
  }
  throw new Error(
    errorMessage.devBuild() && process.env.NODE_ENV !== `production` ? `A live query must be a QueryBuilder, LiveQueryCollectionConfig, Collection, undefined, or null. Got: ${typeof value}` : errorMessage.codedMessage(102, { type: typeof value })
  );
}
exports.getLiveQueryHash = getLiveQueryHash;
exports.getPreparedLiveQueryIdentity = getPreparedLiveQueryIdentity;
exports.getPreparedLiveQuerySources = getPreparedLiveQuerySources;
exports.prepareLiveQueryValue = prepareLiveQueryValue;
exports.resolveLiveQueryValue = resolveLiveQueryValue;
exports.resumeDeferredLiveQueryCollections = resumeDeferredLiveQueryCollections;
//# sourceMappingURL=live-query-options.cjs.map