kysely-rizzolver 0.0.2 → 0.0.3

package/README.md

@@ -4,19 +4,21 @@ Complex Kysely queries, maximum rizz, type-safe every time.
 
 ## Overview
 
-Kysely Rizzolver is a utility library for building complex, type-safe queries.
+Kysely Rizzolver is a utility library for building complex, type-safe queries
+across multiple tables with Kysely.
 
-There are already a bunch of [awesome
-tools](https://github.com/kysely-org/awesome-kysely) for working with Kysely out
+There are already a bunch of [awesome tools](https://github.com/kysely-org/awesome-kysely)
+for working with Kysely out
 there, but none strike the balance I'm looking for:
-- [kysely-orm](https://github.com/seeeden/kysely-orm) is a full-fledged ORM.
-  It's a really cool project, but like all ORMs it works until it doesn't. If
-  you need fine control over your queries, it gets very cumbersome.
+- [kysely-orm](https://github.com/seeden/kysely-orm) is a full-fledged ORM. It's
+  a really cool project, but like all ORMs it works until it doesn't. If you
+  need fine control over your queries, it gets very cumbersome.
 - [kysely-mapper](https://github.com/jtlapp/kysely-mapper) is a bit more
-  lightweight than an ORM, but it still wraps Kysely with a "hatch" to an
-  underlying Kysely instance. It is also quite verbose and rigid in my opinion.
+  lightweight than an ORM, but it's focus is still on mapping tables to other
+  classes. It doesn't offer much value in the way of writing complex queries, or
+  working with multiple tables.
 
-Kysely Rizzolver in constast, works *with* Kysely. It does not replace, wrap,
+Kysely Rizzolver in constast, works *inside* Kysely. It does not replace, wrap,
 abstract or hide it and can be incrementally added to an existing Kysely
 project.
 
@@ -44,7 +46,9 @@ const rizzolver = KyselyRizzolver.builderNoSchema()
     .build();
 ```
 
-or if you have a schema, for example from [kysely-codegen](https://github.com/RobinBlomberg/kysely-codegen), you can use it like this:
+or if you have a schema, for example from
+[kysely-codegen](https://github.com/RobinBlomberg/kysely-codegen), you can use
+it like this:
 
 ```typescript
 import { KyselyRizzolver } from 'kysely-rizzolver';

package/dist/cjs/fetch-result-factory.js

@@ -86,3 +86,4 @@ function newFetchResultFactory() {
         }
     };
 }
+//# sourceMappingURL=fetch-result-factory.js.map

package/dist/cjs/fetch-result-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-result-factory.js","sourceRoot":"","sources":["../../src/fetch-result-factory.ts"],"names":[],"mappings":";;AAyBA,sDA8HC;AAtJD,uDAa2B;AAC3B,+DAAiF;AAUjF,SAAgB,qBAAqB;IACpC,OAAO;QACN;;WAEG;QACH,WAAW,CACV,KAAQ,EACR,MAAqC,EACrC,MAA4B;YAE5B,MAAM,KAAK,IAAA,wCAAkB,GAAM,CAAC;YACpC,IAAI,MAAM,EAAE,CAAC;gBACZ,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC3B,CAAC;YAED,OAAO,IAAA,mCAAiB,EAA2B,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3E,CAAC;QAED;;;;;;WAMG;QACH,YAAY,CACX,KAAQ,EACR,MAAqC,EACrC,MAA4B;YAE5B,MAAM,KAAK,IAAA,wCAAkB,GAAM,CAAC;YACpC,IAAI,MAAM,EAAE,CAAC;gBACZ,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC3B,CAAC;YAED,OAAO,IAAA,oCAAkB,EAA2B,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5E,CAAC;QAED;;WAEG;QACH,YAAY,CACX,KAAQ,EACR,MAA2B,EAC3B,MAA4B;YAE5B,MAAM,KAAK,IAAA,wCAAkB,GAAM,CAAC;YACpC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACzB,CAAC;YAED,OAAO,IAAA,oCAAkB,EAA2B,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5E,CAAC;QAED;;WAEG;QACH,UAAU,CACT,KAAQ,EACR,MAAe;YAEf,OAAO,IAAA,kCAAgB,EAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC;QAC3D,CAAC;QAED;;WAEG;QACH,WAAW,CACV,KAAQ,EACR,MAAe;YAEf,OAAO,IAAA,mCAAiB,EAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC;QAC5D,CAAC;QAED;;WAEG;QACH,WAAW,CACV,KAAQ,EACR,MAAe;YAEf,OAAO,IAAA,mCAAiB,EAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC;QAC5D,CAAC;QAED;;WAEG;QACH,gBAAgB,CACf,KAAQ,EACR,MAAe;YAEf,IAAA,wCAAsB,EAAC,MAAM,CAAC,CAAC;YAE/B,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,wCAAwC,KAAK,EAAE,CAAC,CAAC;YAClE,CAAC;QACF,CAAC;QAED;;WAEG;QACH,iBAAiB,CAChB,KAAQ,EACR,MAAe;YAEf,IAAA,yCAAuB,EAAC,MAAM,CAAC,CAAC;YAEhC,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,4DAA4D,KAAK,EAAE,CAAC,CAAC;YACtF,CAAC;QACF,CAAC;QAED;;WAEG;QACH,iBAAiB,CAChB,KAAQ,EACR,MAAe;YAEf,IAAA,yCAAuB,EAAC,MAAM,CAAC,CAAC;YAEhC,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,yCAAyC,KAAK,EAAE,CAAC,CAAC;YACnE,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/cjs/fetch-result.d.ts

@@ -1,5 +1,5 @@
 import type { Selectable } from 'kysely';
-import type { ModelCollection } from './model-collection.js';
+import { type ModelCollection } from './model-collection.js';
 /**
  * A {@link FetchResult} is a result of a fetch operation. It can be one of
  * three types:
@@ -10,16 +10,19 @@ import type { ModelCollection } from './model-collection.js';
  * - {@link FetchSomeResult} - A result of a fetch operation that is expected to
  *   return any number of rows.
  */
-export type FetchResult<DB, T extends keyof DB & string, R extends Partial<Selectable<DB[T]>>> = FetchOneResult<DB, T, R> | FetchOneXResult<DB, T, R> | FetchSomeResult<DB, T, R>;
+export type FetchResult<DB, T extends keyof DB & string, R extends Partial<Selectable<DB[T]>> = Selectable<DB[T]>> = FetchOneResult<DB, T, R> | FetchOneXResult<DB, T, R> | FetchSomeResult<DB, T, R>;
 /**
  * A {@link FetchOneResult} is a result of a fetch operation that is expected to
  * return up to one row.
  */
-export type FetchOneResult<DB, T extends keyof DB & string, R extends Partial<Selectable<DB[T]>> | undefined> = {
+export type FetchOneResult<DB, T extends keyof DB & string, R extends Partial<Selectable<DB[T]>> = Selectable<DB[T]>> = {
     fetchType: 'fetchOne';
     table: T;
     result: R | undefined;
-    models?: ModelCollection<DB>;
+    /**
+     * The {@link ModelCollection} that contains the fetched models.
+     */
+    models: ModelCollection<DB>;
     /**
      * Returns this result as a {@link FetchOneXResult}.
      *
@@ -31,11 +34,11 @@ export type FetchOneResult<DB, T extends keyof DB & string, R extends Partial<Se
  * A {@link FetchOneXResult} is a result of a fetch operation that is expected
  * to return exactly one row.
  */
-export type FetchOneXResult<DB, T extends keyof DB & string, R extends Partial<Selectable<DB[T]>>> = {
+export type FetchOneXResult<DB, T extends keyof DB & string, R extends Partial<Selectable<DB[T]>> = Selectable<DB[T]>> = {
     fetchType: 'fetchOne';
     table: T;
     result: R;
-    models?: ModelCollection<DB>;
+    models: ModelCollection<DB>;
     /**
      * Returns self. This is a no-op, but it's here to make it possible to
      * cast this object back to a {@link FetchOneXResult}.
@@ -46,11 +49,11 @@ export type FetchOneXResult<DB, T extends keyof DB & string, R extends Partial<S
  * A {@link FetchSomeResult} is a result of a fetch operation that is expected
  * to return any number of rows.
  */
-export type FetchSomeResult<DB, T extends keyof DB & string, R extends Partial<Selectable<DB[T]>>> = {
+export type FetchSomeResult<DB, T extends keyof DB & string, R extends Partial<Selectable<DB[T]>> = Selectable<DB[T]>> = {
     fetchType: 'fetchSome';
     table: T;
     result: R[];
-    models?: ModelCollection<DB>;
+    models: ModelCollection<DB>;
 };
 /**
  * Used to type juggle between {@link FetchResult} and its subtypes.

package/dist/cjs/fetch-result.js

@@ -10,11 +10,13 @@ exports.isFetchSomeResult = isFetchSomeResult;
 exports.assertIsFetchOneResult = assertIsFetchOneResult;
 exports.assertIsFetchOneXResult = assertIsFetchOneXResult;
 exports.assertIsFetchSomeResult = assertIsFetchSomeResult;
+const model_collection_js_1 = require("./model-collection.js");
 /**
  * Creates a new {@link FetchOneResult} instance.
  */
 function newFetchOneResult(table, result, models) {
     const ref = { value: null };
+    models ??= (0, model_collection_js_1.newModelCollection)();
     const me = {
         fetchType: 'fetchOne',
         table,
@@ -41,6 +43,7 @@ function newFetchOneXResult(table, result, models) {
     if (!result) {
         throw new Error('Expected a fetchOneX result');
     }
+    models ??= (0, model_collection_js_1.newModelCollection)();
     const ref = { value: null };
     const me = {
         fetchType: 'fetchOne',
@@ -58,6 +61,7 @@ function newFetchOneXResult(table, result, models) {
  * Creates a new {@link FetchSomeResult} instance.
  */
 function newFetchSomeResult(table, result, models) {
+    models ??= (0, model_collection_js_1.newModelCollection)();
     return {
         fetchType: 'fetchSome',
         table,
@@ -115,3 +119,4 @@ function assertIsFetchSomeResult(value) {
         throw new Error('Expected a fetchSome result');
     }
 }
+//# sourceMappingURL=fetch-result.js.map

package/dist/cjs/fetch-result.js.map

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

package/dist/cjs/fk-gather-result-factory.d.ts

@@ -0,0 +1,69 @@
+import { type FkGatherOneResult, type FkGatherOneXResult, type FkGatherSomeResult } from './fk-gather-result.js';
+import type { DBWithFk, ModelFkExtractSelectable, ModelFkInstance, ValidFkDepth } from './fks.js';
+import type { KyselyRizzolverFKs } from './kysely-rizzolver.js';
+import { type ModelCollection } from './model-collection.js';
+/**
+ * A {@link FkGatherResultFactory} exposes variants of gather-related functions, but
+ * with the `DB` type parameter already set.
+ *
+ * This makes it less verbose to work with gather results in a type-safe way.
+ */
+export type FkGatherResultFactory<DB, FKDefs extends KyselyRizzolverFKs<DB>> = ReturnType<typeof newFkGatherResultFactory<DB, FKDefs>>;
+export declare function newFkGatherResultFactory<DB, FKDefs extends KyselyRizzolverFKs<DB>>(): {
+    /**
+     * Creates a new {@link GatherOneResult} instance.
+     */
+    newGatherOne<K extends (keyof DB & string) & string, Depth extends ValidFkDepth>(table: K, depth: Depth, result: ModelFkInstance<DBWithFk<DB, FKDefs>, K, Depth> | undefined, models?: ModelCollection<DB>): FkGatherOneResult<DBWithFk<DB, FKDefs>, K, Depth>;
+    /**
+     * Creates a new {@link GatherOneXResult} instance.
+     *
+     * Note: it may be counterintuitive, but this function accepts `undefined` as
+     * input. I found it is way more convenient to assert the type once in this
+     * funciton rather than in every caller.
+     */
+    newGatherOneX<K extends (keyof DB & string) & string, Depth extends ValidFkDepth>(table: K, depth: Depth, result: ModelFkInstance<DBWithFk<DB, FKDefs>, K, Depth> | undefined, models?: ModelCollection<DB>): FkGatherOneXResult<DBWithFk<DB, FKDefs>, K, Depth>;
+    /**
+     * Creates a new {@link GatherSomeResult} instance.
+     */
+    newGatherSome<K extends (keyof DB & string) & string, Depth extends ValidFkDepth>(table: K, depth: Depth, result: ModelFkInstance<DBWithFk<DB, FKDefs>, K, Depth>[], models?: ModelCollection<DB>): FkGatherSomeResult<DBWithFk<DB, FKDefs>, K, Depth>;
+    /**
+     * Checks if a {@link GatherResult} is a {@link GatherOneResult}.
+     */
+    isGatherOne<K extends (keyof DB & string) & string, Depth extends ValidFkDepth>(table: K, depth: Depth, result: unknown): result is FkGatherOneResult<DBWithFk<DB, FKDefs>, K, Depth>;
+    /**
+     * Checks if a {@link GatherResult} is a {@link GatherOneXResult}.
+     */
+    isGatherOneX<K extends (keyof DB & string) & string, Depth extends ValidFkDepth>(table: K, depth: Depth, result: unknown): result is FkGatherOneXResult<DBWithFk<DB, FKDefs>, K, Depth>;
+    /**
+     * Checks if a {@link GatherResult} is a {@link GatherSomeResult}.
+     */
+    isGatherSome<K extends (keyof DB & string) & string, Depth extends ValidFkDepth>(table: K, depth: Depth, result: unknown): result is FkGatherSomeResult<DBWithFk<DB, FKDefs>, K, Depth>;
+    /**
+     * Asserts that a {@link GatherResult} is a {@link GatherOneResult}.
+     */
+    assertIsGatherOne<K extends (keyof DB & string) & string, Depth extends ValidFkDepth>(table: K, depth: Depth, result: unknown): asserts result is FkGatherOneResult<DBWithFk<DB, FKDefs>, K, Depth>;
+    /**
+     * Asserts that a {@link GatherResult} is a {@link GatherOneXResult}.
+     */
+    assertIsGatherOneX<K extends (keyof DB & string) & string, Depth extends ValidFkDepth>(table: K, depth: Depth, result: unknown): asserts result is FkGatherOneXResult<DBWithFk<DB, FKDefs>, K, Depth>;
+    /**
+     * Asserts that a {@link GatherResult} is a {@link GatherSomeResult}.
+     */
+    assertIsGatherSome<K extends (keyof DB & string) & string, Depth extends ValidFkDepth>(table: K, depth: Depth, result: unknown): asserts result is FkGatherSomeResult<DBWithFk<DB, FKDefs>, K, Depth>;
+    /**
+     * Extracts a Kysely {@link Selectable} instance from a gathered model.
+     *
+     * This is useful because Selectables are the lowest common denominators
+     * for any representation of a DB model, so this allows you to convert
+     * any gather result to anything else that might build upon Kysely.
+     *
+     * For example, to convert a gather result to a fetch result:
+     * ```
+     * const userGather: FkGatherOneXResult<DB, 'user'>;
+     * const userModel = userGather.result;
+     * const userSelectable = rizzolver.gatherObjs.toSelectable(userModel);
+     * ```
+     *
+     */
+    toSelectable<Model>(model: Model): ModelFkExtractSelectable<DB, Model>;
+};

package/dist/cjs/fk-gather-result-factory.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.newFkGatherResultFactory = newFkGatherResultFactory;
+const fk_gather_result_js_1 = require("./fk-gather-result.js");
+function newFkGatherResultFactory() {
+    return {
+        /**
+         * Creates a new {@link GatherOneResult} instance.
+         */
+        newGatherOne(table, depth, result, models) {
+            return (0, fk_gather_result_js_1.newGatherOneResult)(table, depth, result, models);
+        },
+        /**
+         * Creates a new {@link GatherOneXResult} instance.
+         *
+         * Note: it may be counterintuitive, but this function accepts `undefined` as
+         * input. I found it is way more convenient to assert the type once in this
+         * funciton rather than in every caller.
+         */
+        newGatherOneX(table, depth, result, models) {
+            return (0, fk_gather_result_js_1.newGatherOneXResult)(table, depth, result, models);
+        },
+        /**
+         * Creates a new {@link GatherSomeResult} instance.
+         */
+        newGatherSome(table, depth, result, models) {
+            return (0, fk_gather_result_js_1.newGatherSomeResult)(table, depth, result, models);
+        },
+        /**
+         * Checks if a {@link GatherResult} is a {@link GatherOneResult}.
+         */
+        isGatherOne(table, depth, result) {
+            return (0, fk_gather_result_js_1.isGatherOneResult)(result) && result.table === table && result.depth === depth;
+        },
+        /**
+         * Checks if a {@link GatherResult} is a {@link GatherOneXResult}.
+         */
+        isGatherOneX(table, depth, result) {
+            return (0, fk_gather_result_js_1.isGatherOneXResult)(result) && result.table === table && result.depth === depth;
+        },
+        /**
+         * Checks if a {@link GatherResult} is a {@link GatherSomeResult}.
+         */
+        isGatherSome(table, depth, result) {
+            return (0, fk_gather_result_js_1.isGatherSomeResult)(result) && result.table === table && result.depth === depth;
+        },
+        /**
+         * Asserts that a {@link GatherResult} is a {@link GatherOneResult}.
+         */
+        assertIsGatherOne(table, depth, result) {
+            (0, fk_gather_result_js_1.assertIsGatherOneResult)(result);
+            if (result.table !== table) {
+                throw new Error(`Expected a gatherOne result for table ${table}`);
+            }
+            if (result.depth !== depth) {
+                throw new Error(`Expected a gatherOne result for table ${table} of depth ${depth}`);
+            }
+        },
+        /**
+         * Asserts that a {@link GatherResult} is a {@link GatherOneXResult}.
+         */
+        assertIsGatherOneX(table, depth, result) {
+            (0, fk_gather_result_js_1.assertIsGatherOneXResult)(result);
+            if (result.table !== table) {
+                throw new Error(`Expected a gatherOne result with a non-null value for table ${table}`);
+            }
+            if (result.depth !== depth) {
+                throw new Error(`Expected a gatherOne result with a non-null value for table ${table} of depth ${depth}`);
+            }
+        },
+        /**
+         * Asserts that a {@link GatherResult} is a {@link GatherSomeResult}.
+         */
+        assertIsGatherSome(table, depth, result) {
+            (0, fk_gather_result_js_1.assertIsGatherSomeResult)(result);
+            if (result.table !== table) {
+                throw new Error(`Expected a gatherSome result for table ${table}`);
+            }
+            if (result.depth !== depth) {
+                throw new Error(`Expected a gatherSome result for table ${table} of depth ${depth}`);
+            }
+        },
+        /**
+         * Extracts a Kysely {@link Selectable} instance from a gathered model.
+         *
+         * This is useful because Selectables are the lowest common denominators
+         * for any representation of a DB model, so this allows you to convert
+         * any gather result to anything else that might build upon Kysely.
+         *
+         * For example, to convert a gather result to a fetch result:
+         * ```
+         * const userGather: FkGatherOneXResult<DB, 'user'>;
+         * const userModel = userGather.result;
+         * const userSelectable = rizzolver.gatherObjs.toSelectable(userModel);
+         * ```
+         *
+         */
+        toSelectable(model) {
+            if (model === undefined || model === null) {
+                return model;
+            }
+            const selectable = {
+                ...model
+            };
+            delete selectable['__fkDepth'];
+            delete selectable['__table'];
+            return selectable;
+        }
+    };
+}
+//# sourceMappingURL=fk-gather-result-factory.js.map

package/dist/cjs/fk-gather-result-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fk-gather-result-factory.js","sourceRoot":"","sources":["../../src/fk-gather-result-factory.ts"],"names":[],"mappings":"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"}

package/dist/cjs/fk-gather-result.d.ts

@@ -0,0 +1,115 @@
+import type { DBWithoutFk, ModelFkInstance, ValidFkDepth } from './fks.js';
+import { MAX_FK_GATHER_DEPTH } from './fks.js';
+import type { ModelCollection } from './model-collection.js';
+/**
+ * A {@link FkGatherResult} is a result of a gather operation. It can be one of
+ * three types:
+ * - {@link FkGatherOneResult} - A result of a gather operation that is expected to
+ *   return up to one row,
+ * - {@link FkGatherOneXResult} - A result of a gather operation that is expected to
+ *   return exactly one row,
+ * - {@link FkGatherSomeResult} - A result of a gather operation that is expected to
+ *   return any number of rows.
+ */
+export type FkGatherResult<DBFk, Table extends keyof DBFk & string, Depth extends ValidFkDepth = typeof MAX_FK_GATHER_DEPTH> = FkGatherOneResult<DBFk, Table, Depth> | FkGatherOneXResult<DBFk, Table, Depth> | FkGatherSomeResult<DBFk, Table, Depth>;
+/**
+ * A {@link FkGatherOneResult} is a result of a gather operation that is expected to
+ * return up to one row.
+ */
+export type FkGatherOneResult<DBFk, Table extends keyof DBFk & string, Depth extends ValidFkDepth = typeof MAX_FK_GATHER_DEPTH> = {
+    gatherType: 'gatherOne';
+    table: Table;
+    depth: Depth;
+    result: ModelFkInstance<DBFk, Table, Depth> | undefined;
+    models?: ModelCollection<DBWithoutFk<DBFk>>;
+    /**
+     * Returns this result as a {@link FkGatherOneXResult}.
+     *
+     * @throws If the result is null or undefined.
+     */
+    asGatherOneX(): FkGatherOneXResult<DBFk, Table, Depth>;
+};
+/**
+ * A {@link FkGatherOneXResult} is a result of a gather operation that is expected
+ * to return exactly one row.
+ */
+export type FkGatherOneXResult<DBFk, Table extends keyof DBFk & string, Depth extends ValidFkDepth = typeof MAX_FK_GATHER_DEPTH> = {
+    gatherType: 'gatherOne';
+    table: Table;
+    depth: Depth;
+    result: ModelFkInstance<DBFk, Table, Depth>;
+    models?: ModelCollection<DBWithoutFk<DBFk>>;
+    /**
+     * Returns self. This is a no-op, but it's here to make it possible to
+     * cast this object back to a {@link FkGatherOneXResult}.
+     */
+    asGatherOneX(): FkGatherOneXResult<DBFk, Table, Depth>;
+};
+/**
+ * A {@link FkGatherSomeResult} is a result of a gather operation that is expected
+ * to return any number of rows.
+ */
+export type FkGatherSomeResult<DBFk, Table extends keyof DBFk & string, Depth extends ValidFkDepth = typeof MAX_FK_GATHER_DEPTH> = {
+    gatherType: 'gatherSome';
+    table: Table;
+    depth: Depth;
+    result: ModelFkInstance<DBFk, Table, Depth>[];
+    models?: ModelCollection<DBWithoutFk<DBFk>>;
+};
+/**
+ * Used to type juggle between {@link FkGatherResult} and its subtypes.
+ */
+export type AsGatherOneResult<T extends FkGatherResult<any, string, ValidFkDepth>> = T extends FkGatherResult<infer DBFk, infer Table, infer D> ? FkGatherOneResult<DBFk, Table, D> : never;
+/**
+ * Used to type juggle between {@link FkGatherResult} and its subtypes.
+ */
+export type AsGatherOneXResult<T extends FkGatherResult<any, string, ValidFkDepth>> = T extends FkGatherResult<infer DBFk, infer Table, infer D> ? FkGatherOneXResult<DBFk, Table, D> : never;
+/**
+ * Used to type juggle between {@link FkGatherResult} and its subtypes.
+ */
+export type AsGatherSomeResult<T extends FkGatherResult<any, string, ValidFkDepth>> = T extends FkGatherResult<infer DBFk, infer Table, infer D> ? FkGatherSomeResult<DBFk, Table, D> : never;
+/**
+ * Creates a new {@link FkGatherOneResult} instance.
+ */
+export declare function newGatherOneResult<DBFk, Table extends keyof DBFk & string, Depth extends ValidFkDepth>(table: Table, depth: Depth, result: ModelFkInstance<DBFk, Table, Depth> | undefined, models?: ModelCollection<DBWithoutFk<DBFk>>): FkGatherOneResult<DBFk, Table, Depth>;
+/**
+ * Creates a new {@link FkGatherOneXResult} instance.
+ *
+ * Note: it may be counterintuitive, but this function accepts `undefined` as
+ * input. I found it is way more convenient to assert the type once in this
+ * funciton rather than in every caller.
+ */
+export declare function newGatherOneXResult<DBFk, Table extends keyof DBFk & string, Depth extends ValidFkDepth>(table: Table, depth: Depth, result: ModelFkInstance<DBFk, Table, Depth> | undefined, models?: ModelCollection<DBWithoutFk<DBFk>>): FkGatherOneXResult<DBFk, Table, Depth>;
+/**
+ * Creates a new {@link FkGatherSomeResult} instance.
+ */
+export declare function newGatherSomeResult<DBFk, Table extends keyof DBFk & string, Depth extends ValidFkDepth>(table: Table, depth: Depth, result: ModelFkInstance<DBFk, Table, Depth>[], models?: ModelCollection<DBWithoutFk<DBFk>>): FkGatherSomeResult<DBFk, Table, Depth>;
+export declare function isGatherResult(result: unknown): result is FkGatherResult<any, any, ValidFkDepth>;
+/**
+ * Checks if `value` is a {@link FkGatherOneResult}.
+ */
+export declare function isGatherOneResult<DBFk, Table extends keyof DBFk & string, Depth extends ValidFkDepth>(value: FkGatherOneResult<DBFk, Table, Depth> | FkGatherOneXResult<DBFk, Table, Depth>): value is typeof value;
+export declare function isGatherOneResult(value: unknown): value is FkGatherOneResult<any, any, ValidFkDepth>;
+/**
+ * Checks if `value` is a {@link FkGatherOneXResult}.
+ */
+export declare function isGatherOneXResult<DBFk, Table extends keyof DBFk & string, Depth extends ValidFkDepth>(value: FkGatherOneResult<DBFk, Table, Depth>): value is FkGatherOneXResult<DBFk, Table, Depth>;
+export declare function isGatherOneXResult<DBFk, Table extends keyof DBFk & string, Depth extends ValidFkDepth>(value: FkGatherOneXResult<DBFk, Table, Depth>): value is typeof value;
+export declare function isGatherOneXResult(value: unknown): value is FkGatherOneXResult<any, any, ValidFkDepth>;
+/**
+ * Checks if `value` is a {@link FkGatherSomeResult}.
+ */
+export declare function isGatherSomeResult<DBFk, Table extends keyof DBFk & string, Depth extends ValidFkDepth>(value: FkGatherSomeResult<DBFk, Table, Depth>): value is typeof value;
+export declare function isGatherSomeResult(value: unknown): value is FkGatherSomeResult<any, any, ValidFkDepth>;
+/**
+ * Asserts that `value` is a {@link FkGatherOneResult}.
+ */
+export declare function assertIsGatherOneResult(value: unknown): asserts value is FkGatherOneResult<any, any, ValidFkDepth>;
+/**
+ * Asserts that `value` is a {@link FkGatherOneXResult}.
+ */
+export declare function assertIsGatherOneXResult(value: unknown): asserts value is FkGatherOneXResult<any, any, ValidFkDepth>;
+/**
+ * Asserts that `value` is a {@link FkGatherSomeResult}.
+ */
+export declare function assertIsGatherSomeResult(value: unknown): asserts value is FkGatherSomeResult<any, any, ValidFkDepth>;

package/dist/cjs/fk-gather-result.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.newGatherOneResult = newGatherOneResult;
+exports.newGatherOneXResult = newGatherOneXResult;
+exports.newGatherSomeResult = newGatherSomeResult;
+exports.isGatherResult = isGatherResult;
+exports.isGatherOneResult = isGatherOneResult;
+exports.isGatherOneXResult = isGatherOneXResult;
+exports.isGatherSomeResult = isGatherSomeResult;
+exports.assertIsGatherOneResult = assertIsGatherOneResult;
+exports.assertIsGatherOneXResult = assertIsGatherOneXResult;
+exports.assertIsGatherSomeResult = assertIsGatherSomeResult;
+const fks_js_1 = require("./fks.js");
+/**
+ * Creates a new {@link FkGatherOneResult} instance.
+ */
+function newGatherOneResult(table, depth, result, models) {
+    const ref = { value: null };
+    const me = {
+        gatherType: 'gatherOne',
+        table,
+        depth,
+        result,
+        models,
+        asGatherOneX() {
+            if (!me.result) {
+                throw new Error('Expected a gatherOneX result');
+            }
+            return ref.value;
+        }
+    };
+    ref.value = me;
+    return me;
+}
+/**
+ * Creates a new {@link FkGatherOneXResult} instance.
+ *
+ * Note: it may be counterintuitive, but this function accepts `undefined` as
+ * input. I found it is way more convenient to assert the type once in this
+ * funciton rather than in every caller.
+ */
+function newGatherOneXResult(table, depth, result, models) {
+    if (!result) {
+        throw new Error('Expected a gatherOneX result');
+    }
+    const ref = { value: null };
+    const me = {
+        gatherType: 'gatherOne',
+        table,
+        depth,
+        result,
+        models,
+        asGatherOneX() {
+            return ref.value;
+        }
+    };
+    ref.value = me;
+    return me;
+}
+/**
+ * Creates a new {@link FkGatherSomeResult} instance.
+ */
+function newGatherSomeResult(table, depth, result, models) {
+    return {
+        gatherType: 'gatherSome',
+        table,
+        depth,
+        result,
+        models
+    };
+}
+function isGatherResult(result) {
+    return (!!result &&
+        typeof result === 'object' &&
+        'gatherType' in result &&
+        !!result.gatherType &&
+        typeof result.gatherType === 'string' &&
+        'table' in result &&
+        !!result.table &&
+        typeof result.table === 'string' &&
+        'depth' in result &&
+        typeof result.depth === 'number' &&
+        Number.isInteger(result.depth) &&
+        result.depth >= 0 &&
+        result.depth <= fks_js_1.MAX_FK_GATHER_DEPTH &&
+        'result' in result &&
+        (result.result === undefined ||
+            typeof result.result === 'object' ||
+            (Array.isArray(result.result) && result.result.every((r) => !!r && typeof r === 'object'))));
+}
+function isGatherOneResult(value) {
+    return isGatherResult(value) && value.gatherType === 'gatherOne' && !Array.isArray(value.result);
+}
+function isGatherOneXResult(value) {
+    return (isGatherResult(value) &&
+        value.gatherType === 'gatherOne' &&
+        !Array.isArray(value.result) &&
+        !!value.result);
+}
+function isGatherSomeResult(value) {
+    return isGatherResult(value) && value.gatherType === 'gatherSome' && Array.isArray(value.result);
+}
+/**
+ * Asserts that `value` is a {@link FkGatherOneResult}.
+ */
+function assertIsGatherOneResult(value) {
+    if (!isGatherOneResult(value)) {
+        throw new Error('Expected a gatherOne result');
+    }
+}
+/**
+ * Asserts that `value` is a {@link FkGatherOneXResult}.
+ */
+function assertIsGatherOneXResult(value) {
+    if (!isGatherOneXResult(value)) {
+        throw new Error('Expected a gatherOne result with a non-null, non undefined result');
+    }
+}
+/**
+ * Asserts that `value` is a {@link FkGatherSomeResult}.
+ */
+function assertIsGatherSomeResult(value) {
+    if (!isGatherSomeResult(value)) {
+        throw new Error('Expected a gatherSome result');
+    }
+}
+//# sourceMappingURL=fk-gather-result.js.map

package/dist/cjs/fk-gather-result.js.map

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