convex-ents 0.19.0 → 0.20.0

package/dist/functions.d.ts

@@ -3,4 +3,4 @@ import 'convex/values';
 import './deletion.js';
 import './schema.js';
 import './shared.js';
-export { Y as DocRetriever, D as Ent, X as EntMutationCtx, W as EntQueryCtx, E as EntsTable, C as EntsTableWriter, G as GenericEnt, U as GenericEntWriter, z as PromiseArray, y as PromiseArrayOrNull, F as PromiseEdge, t as PromiseEdgeEnts, p as PromiseEdgeEntsOrNull, v as PromiseEdgeEntsWriter, r as PromiseEdgeEntsWriterOrNull, H as PromiseEdgeOrThrow, s as PromiseEdgeOrderedEnts, o as PromiseEdgeOrderedEntsOrNull, u as PromiseEdgeOrderedEntsWriter, q as PromiseEdgeOrderedEntsWriterOrNull, I as PromiseEdgeWriter, K as PromiseEdgeWriterOrNull, J as PromiseEdgeWriterOrThrow, x as PromiseEnt, V as PromiseEntId, w as PromiseEntOrNull, T as PromiseEntWriter, S as PromiseEntWriterOrNull, m as PromiseEnts, k as PromiseEntsOrNull, n as PromiseEntsOrNulls, N as PromiseEntsWriter, l as PromiseEntsWriterOrNull, g as PromiseOrderedQuery, f as PromiseOrderedQueryBase, P as PromiseOrderedQueryOrNull, L as PromiseOrderedQueryWriter, a as PromiseOrderedQueryWriterOrNull, j as PromisePaginationResult, i as PromisePaginationResultOrNull, Q as PromisePaginationResultWriter, O as PromisePaginationResultWriterOrNull, h as PromiseQuery, b as PromiseQueryOrNull, M as PromiseQueryWriter, c as PromiseQueryWriterOrNull, e as PromiseTable, d as PromiseTableBase, R as PromiseTableWriter, Z as addEntRules, A as entWrapper, B as entsTableFactory, a0 as getDeletionConfig, _ as getReadRule, $ as getWriteRule } from './writer.js';
+export { a2 as DocRetriever, K as Ent, a1 as EntMutationCtx, a0 as EntQueryCtx, I as EntsTable, J as EntsTableWriter, L as GenericEnt, _ as GenericEntWriter, F as PromiseArray, E as PromiseArrayOrNull, M as PromiseEdge, z as PromiseEdgeEnts, v as PromiseEdgeEntsOrNull, B as PromiseEdgeEntsWriter, x as PromiseEdgeEntsWriterOrNull, N as PromiseEdgeOrThrow, y as PromiseEdgeOrderedEnts, u as PromiseEdgeOrderedEntsOrNull, A as PromiseEdgeOrderedEntsWriter, w as PromiseEdgeOrderedEntsWriterOrNull, O as PromiseEdgeWriter, R as PromiseEdgeWriterOrNull, Q as PromiseEdgeWriterOrThrow, D as PromiseEnt, $ as PromiseEntId, C as PromiseEntOrNull, Z as PromiseEntWriter, Y as PromiseEntWriterOrNull, q as PromiseEnts, o as PromiseEntsOrNull, r as PromiseEntsOrNulls, U as PromiseEntsWriter, p as PromiseEntsWriterOrNull, t as PromiseIds, s as PromiseIdsOrNull, n as PromiseIdsPaginationResult, m as PromiseIdsPaginationResultOrNull, i as PromiseOrderedIdsQuery, a as PromiseOrderedIdsQueryOrNull, h as PromiseOrderedQuery, g as PromiseOrderedQueryBase, P as PromiseOrderedQueryOrNull, S as PromiseOrderedQueryWriter, b as PromiseOrderedQueryWriterOrNull, l as PromisePaginationResult, k as PromisePaginationResultOrNull, W as PromisePaginationResultWriter, V as PromisePaginationResultWriterOrNull, j as PromiseQuery, c as PromiseQueryOrNull, T as PromiseQueryWriter, d as PromiseQueryWriterOrNull, f as PromiseTable, e as PromiseTableBase, X as PromiseTableWriter, a3 as addEntRules, G as entWrapper, H as entsTableFactory, a6 as getDeletionConfig, a4 as getReadRule, a5 as getWriteRule } from './writer.js';

package/dist/functions.js

@@ -366,7 +366,7 @@ var PromiseQueryOrNullImpl = class _PromiseQueryOrNullImpl extends Promise {
     );
   }
   map(callbackFn) {
-    return new PromiseArrayImpl(async () => {
+    return new PromiseArrayOrNullImpl(async () => {
       const array = await this;
       if (array === null) {
         return null;
@@ -527,6 +527,90 @@ var PromiseQueryOrNullImpl = class _PromiseQueryOrNullImpl extends Promise {
     );
   }
 };
+var PromiseIdsQueryOrNullImpl = class extends Promise {
+  constructor(retrieve, field) {
+    super(() => {
+    });
+    this.retrieve = retrieve;
+    this.field = field;
+  }
+  map(callbackFn) {
+    return new PromiseArrayOrNullImpl(async () => {
+      const array = await this;
+      if (array === null) {
+        return null;
+      }
+      return await Promise.all(array.map(callbackFn));
+    });
+  }
+  paginate(paginationOpts) {
+    return new PromiseIdsPaginationResultOrNullImpl(async () => {
+      const query = await this.retrieve();
+      if (query === null) {
+        return null;
+      }
+      const result = await query.paginate(paginationOpts);
+      return {
+        ...result,
+        page: result.page.map((id) => this._getId(id))
+      };
+    });
+  }
+  take(n) {
+    return new PromiseIdsOrNullImpl(async () => {
+      const query = await this.retrieve();
+      if (query === null) {
+        return null;
+      }
+      const result = await query.take(n);
+      return result.map((id) => this._getId(id));
+    });
+  }
+  async first() {
+    const query = await this.retrieve();
+    if (query === null) {
+      return null;
+    }
+    const doc = await query.first();
+    if (doc === null) {
+      return null;
+    }
+    return this._getId(doc);
+  }
+  async firstX() {
+    const id = await this.first();
+    if (id === null) {
+      throw new Error("Expected at least one ID, but got none");
+    }
+    return id;
+  }
+  async unique() {
+    const query = await this.retrieve();
+    if (query === null) {
+      return null;
+    }
+    const result = await query.unique();
+    if (result === null) {
+      return null;
+    }
+    return this._getId(result);
+  }
+  async uniqueX() {
+    const id = await this.unique();
+    if (id === null) {
+      throw new Error("Expected one unique ID, but got none");
+    }
+    return id;
+  }
+  then(onfulfilled, onrejected) {
+    return this.retrieve().then((query) => query === null ? null : query.collect()).then(
+      (docs) => docs === null ? null : docs.map((doc) => this._getId(doc))
+    ).then(onfulfilled, onrejected);
+  }
+  _getId(doc) {
+    return doc[this.field];
+  }
+};
 var PromisePaginationResultOrNullImpl = class extends Promise {
   constructor(ctx, entDefinitions, table, retrieve) {
     super(() => {
@@ -573,6 +657,26 @@ var PromisePaginationResultOrNullImpl = class extends Promise {
     ).then(onfulfilled, onrejected);
   }
 };
+var PromiseIdsPaginationResultOrNullImpl = class extends Promise {
+  constructor(retrieve) {
+    super(() => {
+    });
+    this.retrieve = retrieve;
+  }
+  async map(callbackFn) {
+    const result = await this;
+    if (result === null) {
+      return null;
+    }
+    return {
+      ...result,
+      page: await Promise.all(result.page.map(callbackFn))
+    };
+  }
+  then(onfulfilled, onrejected) {
+    return this.retrieve().then(onfulfilled, onrejected);
+  }
+};
 var PromiseTableImpl = class extends PromiseQueryOrNullImpl {
   constructor(ctx, entDefinitions, table) {
     super(
@@ -738,7 +842,7 @@ var PromiseEntsOrNullImpl = class extends Promise {
     this.throwIfNull = throwIfNull;
   }
   map(callbackFn) {
-    return new PromiseArrayImpl(async () => {
+    return new PromiseArrayOrNullImpl(async () => {
       const array = await this;
       if (array === null) {
         return null;
@@ -840,6 +944,25 @@ var PromiseEntsOrNullImpl = class extends Promise {
     ).then(onfulfilled, onrejected);
   }
 };
+var PromiseIdsOrNullImpl = class extends Promise {
+  constructor(retrieve) {
+    super(() => {
+    });
+    this.retrieve = retrieve;
+  }
+  map(callbackFn) {
+    return new PromiseArrayOrNullImpl(async () => {
+      const array = await this;
+      if (array === null) {
+        return null;
+      }
+      return await Promise.all(array.map(callbackFn));
+    });
+  }
+  then(onfulfilled, onrejected) {
+    return this.retrieve().then(onfulfilled, onrejected);
+  }
+};
 var PromiseEdgeOrNullImpl = class _PromiseEdgeOrNullImpl extends PromiseEntsOrNullImpl {
   constructor(ctx, entDefinitions, table, edgeDefinition, retrieveSourceId, retrieveQuery, retrieveDoc = async (edgeDoc) => {
     const sourceId = edgeDoc[edgeDefinition.field];
@@ -875,6 +998,12 @@ var PromiseEdgeOrNullImpl = class _PromiseEdgeOrNullImpl extends PromiseEntsOrNu
     this.retrieveQuery = retrieveQuery;
     this.retrieveDoc = retrieveDoc;
   }
+  ids() {
+    return new PromiseIdsQueryOrNullImpl(
+      () => this.retrieveQuery(),
+      this.edgeDefinition.ref
+    );
+  }
   async has(targetId) {
     const sourceId = await this.retrieveSourceId();
     if (sourceId === null) {
@@ -1162,7 +1291,7 @@ var PromiseEntOrNullImpl = class extends Promise {
     );
   }
 };
-var PromiseArrayImpl = class extends Promise {
+var PromiseArrayOrNullImpl = class extends Promise {
   constructor(retrieve) {
     super(() => {
     });