relatekit 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 RelateKit contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,203 @@
1
- # Temporary Holding Version
1
+ # RelateKit
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ RelateKit turns separate arrays into typed nested objects. It is synchronous, has no runtime dependencies, does not mutate its inputs, and does not depend on an ORM or database driver.
4
+
5
+ Version 0.1 is strict by default. Importing from `relatekit` and `relatekit/strict` gives the same behavior. `relatekit/loose` changes duplicate handling for `one()`.
6
+
7
+ ## Install
8
+
9
+ ```sh
10
+ npm install relatekit
11
+ ```
12
+
13
+ RelateKit requires Node.js 18 or newer and uses ESM.
14
+
15
+ Run the documentation site locally with `npm run docs:start`. See [website/README.md](website/README.md) for the build command.
16
+
17
+ ## Basic use
18
+
19
+ ```ts
20
+ import { many, one, relate } from "relatekit";
21
+
22
+ const tasks = [{ id: "t1", propertyId: "p1" }];
23
+ const properties = [{ id: "p1", name: "HQ" }];
24
+ const assignments = [{ id: "a1", taskId: "t1" }];
25
+
26
+ const result = relate(tasks, {
27
+ property: one(properties, { on: { propertyId: "id" } }),
28
+ assignments: many(assignments, { on: { id: "taskId" } }),
29
+ });
30
+ ```
31
+
32
+ `on` maps a parent field to a child field. A missing `one()` relation becomes `null`; a missing `many()` relation becomes `[]`.
33
+
34
+ `relate()` also accepts one parent object. An object input returns one related object instead of an array:
35
+
36
+ ```ts
37
+ const task = { id: "t1" };
38
+
39
+ const result = relate(task, ({ many }) => ({
40
+ assignments: many(assignments, { on: { id: "taskId" } }),
41
+ }));
42
+
43
+ result.assignments; // Assignment[]
44
+ ```
45
+
46
+ Both the callback form and relation object form accept either a single parent object or an array of parents.
47
+
48
+ Require a `one()` relation with `defined: true` when absence is a data error:
49
+
50
+ ```ts
51
+ const result = relate(tasks, ({ one }) => ({
52
+ property: one(properties, {
53
+ on: { propertyId: "id" },
54
+ defined: true,
55
+ }),
56
+ }));
57
+
58
+ result[0].property.name; // property is not nullable
59
+ ```
60
+
61
+ If no child matches, RelateKit throws `RelateKitError` with code `INVALID_CARDINALITY` and the relation path. `many()` does not accept `defined` because it always returns an array.
62
+
63
+ ## Key inference and autocomplete
64
+
65
+ Use the callback form when you want the editor to infer both sides of a relation while you type:
66
+
67
+ ```ts
68
+ const result = relate(tasks, ({ one, many }) => ({
69
+ property: one(properties, {
70
+ on: { propertyId: "id" },
71
+ }),
72
+ assignments: many(assignments, {
73
+ local: "id",
74
+ foreign: "taskId",
75
+ }),
76
+ }));
77
+ ```
78
+
79
+ The callback binds `one` and `many` to the parent row type. RelateKit therefore autocompletes `on` keys and `local` from `tasks`, then autocompletes `on` values and `foreign` from the child rows. It also excludes child keys whose value type cannot match the selected parent key.
80
+
81
+ Use another callback in `include` to repeat the same inference at a nested level:
82
+
83
+ ```ts
84
+ const result = relate(tasks, ({ many }) => ({
85
+ assignments: many(assignments, {
86
+ on: { id: "taskId" },
87
+ include: ({ one }) => ({
88
+ user: one(users, { local: "userId", foreign: "id" }),
89
+ }),
90
+ }),
91
+ }));
92
+ ```
93
+
94
+ The object form shown in the basic example remains supported. It validates the keys once TypeScript evaluates the complete relation object, but the callback form provides richer autocomplete while editing.
95
+
96
+ ## Composite keys
97
+
98
+ Add more fields to `on`. Every field must match.
99
+
100
+ ```ts
101
+ const result = relate(tasks, {
102
+ property: one(properties, {
103
+ on: {
104
+ organizationId: "organizationId",
105
+ propertyId: "id",
106
+ },
107
+ }),
108
+ });
109
+ ```
110
+
111
+ Tuple syntax is also supported. Use the callback form so `local` is inferred from the parent row keys:
112
+
113
+ ```ts
114
+ const result = relate(tasks, ({ one }) => ({
115
+ property: one(properties, {
116
+ local: ["organizationId", "propertyId"],
117
+ foreign: ["organizationId", "id"],
118
+ }),
119
+ }));
120
+ ```
121
+
122
+ Here `local` is inferred as `readonly ["organizationId", "propertyId"]`. Each item autocompletes from `keyof Task`; it is not widened to `readonly [string, ...string[]]`.
123
+
124
+ RelateKit stores composite keys in nested `Map` objects. It never joins values into a string, so values containing separators cannot collide. A `null` or `undefined` component never matches.
125
+
126
+ ## Nested relations
127
+
128
+ ```ts
129
+ const result = relate(tasks, {
130
+ assignments: many(assignments, {
131
+ on: { id: "taskId" },
132
+ include: {
133
+ user: one(users, { on: { userId: "id" } }),
134
+ },
135
+ }),
136
+ });
137
+ ```
138
+
139
+ The return type includes every nested relation. Relation names, key names, tuple lengths, and key value types are checked by TypeScript.
140
+
141
+ ### Readable result types
142
+
143
+ RelateKit prettifies every `relate()` result so editor tooltips show one readable object type instead of nested intersections. Expansion stops after 10 levels to keep TypeScript responsive.
144
+
145
+ The same utilities are available for application types:
146
+
147
+ ```ts
148
+ import type { Prettify, PrettifyDeep } from "relatekit";
149
+
150
+ type User = Prettify<UserRow & { roles: Role[] }>;
151
+ type Response = PrettifyDeep<RawResponse>; // up to 10 levels
152
+ type WiderResponse = PrettifyDeep<RawResponse, 15>;
153
+ ```
154
+
155
+ Arrays, readonly arrays, tuples, functions, `Date`, `File`, `FileList`, and objects with methods keep their behavior during expansion. This also preserves normal custom class instances.
156
+
157
+ TypeScript cannot distinguish a class containing only fields from a plain object because both have the same structural shape. Pass those classes as the third type parameter:
158
+
159
+ ```ts
160
+ type Response = PrettifyDeep<RawResponse, 10, FieldOnlyClass | AnotherValueClass>;
161
+ ```
162
+
163
+ ## Strict and loose modes
164
+
165
+ Strict mode throws `RelateKitError` with code `DUPLICATE_KEY` when a `one()` relation finds more than one child.
166
+
167
+ ```ts
168
+ import { relate } from "relatekit"; // strict
169
+ // or: import { relate } from "relatekit/strict";
170
+ ```
171
+
172
+ Loose mode keeps the first matching child. Input order decides which child wins.
173
+
174
+ ```ts
175
+ import { many, one, relate } from "relatekit/loose";
176
+ ```
177
+
178
+ Both modes preserve child order in `many()` and return new objects at every mapped level.
179
+
180
+ ## Errors
181
+
182
+ `RelateKitError` exposes `code` and `path`. Version 0.1 defines these codes:
183
+
184
+ - `DUPLICATE_KEY`
185
+ - `INVALID_KEY`
186
+ - `INVALID_CONFIGURATION`
187
+ - `INVALID_CARDINALITY`
188
+
189
+ ## Scope of 0.1
190
+
191
+ This release maps arrays already in memory. Async loading, SQL generation, flat joined-row expansion, caching, permissions, and transactions are outside the 0.1 API.
192
+
193
+ ## Performance tests
194
+
195
+ Run the dedicated performance suite separately from normal tests:
196
+
197
+ ```sh
198
+ npm run test:performance
199
+ ```
200
+
201
+ It measures single objects with 5, 50, and 500 fields, an object containing a 10,000-item array, and parent arrays containing 10, 100, 1,000, 10,000, 100,000, 1,000,000, and 4,000,000 rows. Fixture creation is excluded from the measured duration. The report includes duration, rows or operations per second, and heap delta.
202
+
203
+ Set `RELATEKIT_PERF_MAX_ROWS` to cap the largest array case during local development. The default is 4,000,000 rows.
@@ -0,0 +1,58 @@
1
+ import type { Policy } from "./engine.js";
2
+ import type { AnyRelationDescriptor, InferredRelationOptions, IsDefined, PrettifyDeep, RelationDescriptor, RelationOptions, RelationResults, ValidateRelationOptions, ValidateRelations } from "./types.js";
3
+ type Include = Readonly<Record<string, AnyRelationDescriptor>>;
4
+ type IncludeFactory<C, R extends Include = Include> = (relations: RelationBuilders<C>) => R;
5
+ type ResolvedOptionsInclude<O> = O extends {
6
+ readonly include: infer I;
7
+ } ? I : undefined;
8
+ export interface RelationBuilders<P> {
9
+ one<C, const I extends Include, const O extends InferredRelationOptions<P, C> & {
10
+ readonly defined?: true;
11
+ }>(rows: readonly C[], options: O & {
12
+ readonly include: IncludeFactory<C, I>;
13
+ } & ValidateRelationOptions<P, C, O>): RelationDescriptor<C, "one", I, O, IsDefined<O>>;
14
+ one<C, const O extends InferredRelationOptions<P, C> & {
15
+ readonly defined?: true;
16
+ readonly include?: Include;
17
+ }>(rows: readonly C[], options: O & ValidateRelationOptions<P, C, O>): RelationDescriptor<C, "one", ResolvedOptionsInclude<O>, O, IsDefined<O>>;
18
+ many<C, const I extends Include, const O extends InferredRelationOptions<P, C> & {
19
+ readonly defined?: never;
20
+ }>(rows: readonly C[], options: O & {
21
+ readonly include: IncludeFactory<C, I>;
22
+ } & ValidateRelationOptions<P, C, O>): RelationDescriptor<C, "many", I, O, false>;
23
+ many<C, const O extends InferredRelationOptions<P, C> & {
24
+ readonly defined?: never;
25
+ readonly include?: Include;
26
+ }>(rows: readonly C[], options: PrettifyDeep<O & ValidateRelationOptions<P, C, O>>): RelationDescriptor<C, "many", ResolvedOptionsInclude<O>, O, false>;
27
+ }
28
+ export declare function makeOne<C, const O extends RelationOptions<C> & {
29
+ readonly defined?: true;
30
+ readonly include?: Include;
31
+ }>(rows: readonly C[], options: O): RelationDescriptor<C, "one", ResolvedOptionsInclude<O>, O, IsDefined<O>>;
32
+ export declare function makeMany<C, const O extends RelationOptions<C> & {
33
+ readonly defined?: never;
34
+ readonly include?: Include;
35
+ }>(rows: readonly C[], options: O): RelationDescriptor<C, "many", ResolvedOptionsInclude<O>, O, false>;
36
+ export interface Relate {
37
+ <P, const R extends Readonly<Record<string, AnyRelationDescriptor>>>(parents: P[], relations: R & ValidateRelations<P, R>): PrettifyDeep<P & RelationResults<R>>[];
38
+ <P, const R extends Readonly<Record<string, AnyRelationDescriptor>>>(parents: P[], factory: (relations: RelationBuilders<P>) => R): PrettifyDeep<P & RelationResults<R>>[];
39
+ <P, const R extends Readonly<Record<string, AnyRelationDescriptor>>>(parents: readonly P[], relations: R & ValidateRelations<P, R>): readonly PrettifyDeep<P & RelationResults<R>>[];
40
+ <P, const R extends Readonly<Record<string, AnyRelationDescriptor>>>(parents: readonly P[], factory: (relations: RelationBuilders<P>) => R): readonly PrettifyDeep<P & RelationResults<R>>[];
41
+ <P, const R extends Readonly<Record<string, AnyRelationDescriptor>>>(parent: P, relations: R & ValidateRelations<P, R>): PrettifyDeep<P & RelationResults<R>>;
42
+ <P, const R extends Readonly<Record<string, AnyRelationDescriptor>>>(parent: P, factory: (relations: RelationBuilders<P>) => R): PrettifyDeep<P & RelationResults<R>>;
43
+ }
44
+ type RuntimeRelations = Readonly<Record<string, AnyRelationDescriptor>>;
45
+ type RuntimeRelationFactory = (relations: RelationBuilders<unknown>) => RuntimeRelations;
46
+ export declare function makeRelate(policy: Policy): Relate;
47
+ export declare function executeRelate(policy: Policy, parents: unknown | readonly unknown[], relationsOrFactory: RuntimeRelations | RuntimeRelationFactory): unknown | readonly unknown[];
48
+ export declare function createRelationBuilders<P>(): RelationBuilders<P>;
49
+ export declare function createOneRelation<P, C, const O extends InferredRelationOptions<P, C> & {
50
+ readonly defined?: true;
51
+ readonly include?: Include | IncludeFactory<C>;
52
+ }>(rows: readonly C[], options: O & ValidateRelationOptions<P, C, O>): RelationDescriptor<C, "one", ResolvedOptionsInclude<O>, O, IsDefined<O>>;
53
+ export declare function createManyRelation<P, C, const O extends InferredRelationOptions<P, C> & {
54
+ readonly defined?: never;
55
+ readonly include?: Include | IncludeFactory<C>;
56
+ }>(rows: readonly C[], options: O & ValidateRelationOptions<P, C, O>): RelationDescriptor<C, "many", ResolvedOptionsInclude<O>, O, false>;
57
+ export {};
58
+ //# sourceMappingURL=api.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/core/api.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,55 @@
1
+ import { runRelate } from "./engine.js";
2
+ export function makeOne(rows, options) {
3
+ const include = resolveStaticInclude(options);
4
+ return { kind: "one", rows, options, include, defined: (options.defined === true) };
5
+ }
6
+ export function makeMany(rows, options) {
7
+ const include = resolveStaticInclude(options);
8
+ return { kind: "many", rows, options, include, defined: false };
9
+ }
10
+ export function makeRelate(policy) {
11
+ return executeRelate.bind(undefined, policy);
12
+ }
13
+ export function executeRelate(policy, parents, relationsOrFactory) {
14
+ const relations = typeof relationsOrFactory === "function"
15
+ ? relationsOrFactory(createRelationBuilders())
16
+ : relationsOrFactory;
17
+ const multiple = Array.isArray(parents);
18
+ const result = runRelate(multiple ? parents : [parents], relations, policy);
19
+ return multiple ? result : result[0];
20
+ }
21
+ export function createRelationBuilders() {
22
+ return {
23
+ one: createOneRelation,
24
+ many: createManyRelation,
25
+ };
26
+ }
27
+ export function createOneRelation(rows, options) {
28
+ return {
29
+ kind: "one",
30
+ rows,
31
+ options,
32
+ include: resolveInclude(options),
33
+ defined: (options.defined === true),
34
+ };
35
+ }
36
+ export function createManyRelation(rows, options) {
37
+ return {
38
+ kind: "many",
39
+ rows,
40
+ options,
41
+ include: resolveInclude(options),
42
+ defined: false,
43
+ };
44
+ }
45
+ function resolveInclude(options) {
46
+ const includeInput = options.include;
47
+ const include = typeof includeInput === "function"
48
+ ? includeInput(createRelationBuilders())
49
+ : includeInput;
50
+ return include;
51
+ }
52
+ function resolveStaticInclude(options) {
53
+ return options.include;
54
+ }
55
+ //# sourceMappingURL=api.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/core/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAoDxC,MAAM,UAAU,OAAO,CAGrB,IAAkB,EAAE,OAAU;IAC9B,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,KAAK,IAAI,CAAiB,EAAE,CAAC;AACtG,CAAC;AAED,MAAM,UAAU,QAAQ,CAGtB,IAAkB,EAAE,OAAU;IAC9B,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAClE,CAAC;AAgCD,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAW,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,OAAqC,EACrC,kBAA6D;IAE7D,MAAM,SAAS,GAAG,OAAO,kBAAkB,KAAK,UAAU;QACxD,CAAC,CAAC,kBAAkB,CAAC,sBAAsB,EAAW,CAAC;QACvD,CAAC,CAAC,kBAAkB,CAAC;IACvB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC5E,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,GAAG,EAAE,iBAAiB;QACtB,IAAI,EAAE,kBAAkB;KACS,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAQ/B,IAAkB,EAClB,OAA6C;IAE7C,OAAO;QACL,IAAI,EAAE,KAAK;QACX,IAAI;QACJ,OAAO;QACP,OAAO,EAAE,cAAc,CAAO,OAAO,CAAC;QACtC,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,KAAK,IAAI,CAAiB;KACpD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAQhC,IAAkB,EAClB,OAA6C;IAE7C,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI;QACJ,OAAO;QACP,OAAO,EAAE,cAAc,CAAO,OAAO,CAAC;QACtC,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAGrB,OAAU;IACV,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IACrC,MAAM,OAAO,GAAG,OAAO,YAAY,KAAK,UAAU;QAChD,CAAC,CAAC,YAAY,CAAC,sBAAsB,EAAK,CAAC;QAC3C,CAAC,CAAC,YAAY,CAAC;IACjB,OAAO,OAAoC,CAAC;AAC9C,CAAC;AAED,SAAS,oBAAoB,CAA2C,OAAU;IAChF,OAAO,OAAO,CAAC,OAAoC,CAAC;AACtD,CAAC"}
@@ -0,0 +1,9 @@
1
+ import type { AnyRelationDescriptor } from "./types.js";
2
+ export interface Policy {
3
+ readonly duplicateOne: "throw" | "first";
4
+ }
5
+ type RuntimeRelation = AnyRelationDescriptor;
6
+ type RuntimeRelations = Readonly<Record<string, RuntimeRelation>>;
7
+ export declare function runRelate(parents: readonly unknown[], relations: RuntimeRelations, policy: Policy): readonly unknown[];
8
+ export {};
9
+ //# sourceMappingURL=engine.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/core/engine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAmB,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC;CAC1C;AAED,KAAK,eAAe,GAAG,qBAAqB,CAAC;AAC7C,KAAK,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;AAOlE,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,OAAO,EAAE,CAEtH"}
@@ -0,0 +1,73 @@
1
+ import { RelateKitError } from "./errors.js";
2
+ import { CompositeIndex } from "./indexer.js";
3
+ export function runRelate(parents, relations, policy) {
4
+ return mapLevel(parents, relations, policy, "$");
5
+ }
6
+ function mapLevel(parents, relations, policy, path) {
7
+ const prepared = Object.entries(relations).map(([name, relation]) => prepare(name, relation, policy, path));
8
+ return parents.map((parent, parentIndex) => {
9
+ const row = toRow(parent, `${path}[${parentIndex}]`);
10
+ const additions = {};
11
+ for (const relation of prepared)
12
+ additions[relation.name] = relation.resolve(row);
13
+ return { ...row, ...additions };
14
+ });
15
+ }
16
+ function prepare(name, relation, policy, parentPath) {
17
+ const path = `${parentPath}.${name}`;
18
+ const mapping = normalizeMapping(relation.options, path);
19
+ const index = new CompositeIndex();
20
+ relation.rows.forEach((item, itemIndex) => {
21
+ const row = toRow(item, `${path}.rows[${itemIndex}]`);
22
+ index.add(mapping.map(([, foreign]) => row[foreign]), row, path);
23
+ });
24
+ return {
25
+ name,
26
+ resolve(parent) {
27
+ const matches = index.get(mapping.map(([local]) => parent[local]), path);
28
+ if (relation.kind === "one") {
29
+ if (matches.length > 1 && policy.duplicateOne === "throw") {
30
+ throw new RelateKitError("DUPLICATE_KEY", `Expected one match at ${path}, found ${matches.length}.`, path);
31
+ }
32
+ const match = matches[0];
33
+ if (match === undefined) {
34
+ if (relation.defined) {
35
+ throw new RelateKitError("INVALID_CARDINALITY", `Expected a defined relation at ${path}, found no match.`, path);
36
+ }
37
+ return null;
38
+ }
39
+ return hydrate(match, relation.include, policy, path);
40
+ }
41
+ return matches.map(match => hydrate(match, relation.include, policy, path));
42
+ },
43
+ };
44
+ }
45
+ function hydrate(row, include, policy, path) {
46
+ if (include === undefined)
47
+ return { ...row };
48
+ return mapLevel([row], include, policy, path)[0];
49
+ }
50
+ function resolveKey(key) {
51
+ return typeof key === "string" ? [key] : key;
52
+ }
53
+ function normalizeMapping(options, path) {
54
+ if ("on" in options) {
55
+ const entries = Object.entries(options.on);
56
+ if (entries.length === 0)
57
+ throw new RelateKitError("INVALID_CONFIGURATION", "The 'on' mapping cannot be empty.", path);
58
+ return entries;
59
+ }
60
+ const local = resolveKey(options.local);
61
+ const foreign = resolveKey(options.foreign);
62
+ if (local.length !== foreign.length) {
63
+ throw new RelateKitError("INVALID_CONFIGURATION", "Local and foreign key counts must match.", path);
64
+ }
65
+ return local.map((key, index) => [key, foreign[index] ?? ""]);
66
+ }
67
+ function toRow(value, path) {
68
+ if (typeof value !== "object" || value === null || Array.isArray(value)) {
69
+ throw new RelateKitError("INVALID_KEY", `Expected an object row at ${path}.`, path);
70
+ }
71
+ return value;
72
+ }
73
+ //# sourceMappingURL=engine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/core/engine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ export type RelateKitErrorCode = "DUPLICATE_KEY" | "INVALID_KEY" | "INVALID_CONFIGURATION" | "INVALID_CARDINALITY";
2
+ export declare class RelateKitError extends Error {
3
+ readonly code: RelateKitErrorCode;
4
+ readonly path?: string | undefined;
5
+ constructor(code: RelateKitErrorCode, message: string, path?: string | undefined);
6
+ }
7
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG,aAAa,GAAG,uBAAuB,GAAG,qBAAqB,CAAC;AAEnH,qBAAa,cAAe,SAAQ,KAAK;aAErB,IAAI,EAAE,kBAAkB;aAExB,IAAI,CAAC,EAAE,MAAM;gBAFb,IAAI,EAAE,kBAAkB,EACxC,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC"}
@@ -0,0 +1,11 @@
1
+ export class RelateKitError extends Error {
2
+ code;
3
+ path;
4
+ constructor(code, message, path) {
5
+ super(message);
6
+ this.code = code;
7
+ this.path = path;
8
+ this.name = "RelateKitError";
9
+ }
10
+ }
11
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,cAAe,SAAQ,KAAK;IAErB;IAEA;IAHlB,YACkB,IAAwB,EACxC,OAAe,EACC,IAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAoB;QAExB,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}
@@ -0,0 +1,6 @@
1
+ export declare class CompositeIndex<T> {
2
+ #private;
3
+ add(keys: readonly unknown[], value: T, path: string): void;
4
+ get(keys: readonly unknown[], path: string): readonly T[];
5
+ }
6
+ //# sourceMappingURL=indexer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../src/core/indexer.ts"],"names":[],"mappings":"AAYA,qBAAa,cAAc,CAAC,CAAC;;IAG3B,GAAG,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAe3D,GAAG,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE;CAW1D"}
@@ -0,0 +1,52 @@
1
+ import { RelateKitError } from "./errors.js";
2
+ function branch() {
3
+ return { children: new Map(), values: [] };
4
+ }
5
+ export class CompositeIndex {
6
+ #root = branch();
7
+ add(keys, value, path) {
8
+ const normalized = normalizeKeys(keys, path);
9
+ if (normalized === null)
10
+ return;
11
+ let node = this.#root;
12
+ for (const key of normalized) {
13
+ let next = node.children.get(key);
14
+ if (next === undefined) {
15
+ next = branch();
16
+ node.children.set(key, next);
17
+ }
18
+ node = next;
19
+ }
20
+ node.values.push(value);
21
+ }
22
+ get(keys, path) {
23
+ const normalized = normalizeKeys(keys, path);
24
+ if (normalized === null)
25
+ return [];
26
+ let node = this.#root;
27
+ for (const key of normalized) {
28
+ const next = node.children.get(key);
29
+ if (next === undefined)
30
+ return [];
31
+ node = next;
32
+ }
33
+ return node.values;
34
+ }
35
+ }
36
+ const allowedKeys = ["string", "number", "bigint", "boolean", "symbol"];
37
+ function normalizeKeys(keys, path) {
38
+ if (keys.length === 0) {
39
+ throw new RelateKitError("INVALID_CONFIGURATION", "A relation needs at least one key.", path);
40
+ }
41
+ const result = [];
42
+ for (const key of keys) {
43
+ if (key === null || key === undefined)
44
+ return null;
45
+ if (!allowedKeys.includes(typeof key)) {
46
+ throw new RelateKitError("INVALID_KEY", `Relation key at ${path} must be a primitive value.`, path);
47
+ }
48
+ result.push(key);
49
+ }
50
+ return result;
51
+ }
52
+ //# sourceMappingURL=indexer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"indexer.js","sourceRoot":"","sources":["../../src/core/indexer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQ7C,SAAS,MAAM;IACb,OAAO,EAAE,QAAQ,EAAE,IAAI,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,OAAO,cAAc;IAChB,KAAK,GAAG,MAAM,EAAK,CAAC;IAE7B,GAAG,CAAC,IAAwB,EAAE,KAAQ,EAAE,IAAY;QAClD,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7C,IAAI,UAAU,KAAK,IAAI;YAAE,OAAO;QAChC,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;QACtB,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,IAAI,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,IAAI,GAAG,MAAM,EAAK,CAAC;gBACnB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC/B,CAAC;YACD,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,GAAG,CAAC,IAAwB,EAAE,IAAY;QACxC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7C,IAAI,UAAU,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;QACnC,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;QACtB,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,EAAE,CAAC;YAClC,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAED,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAExE,SAAS,aAAa,CAAC,IAAwB,EAAE,IAAY;IAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,cAAc,CAAC,uBAAuB,EAAE,oCAAoC,EAAE,IAAI,CAAC,CAAC;IAChG,CAAC;IACD,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACnD,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,cAAc,CAAC,aAAa,EAAE,mBAAmB,IAAI,6BAA6B,EAAE,IAAI,CAAC,CAAC;QACtG,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAkB,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
@@ -0,0 +1,97 @@
1
+ export type RelationKey = string | number | bigint | boolean | symbol;
2
+ export type Prettify<T> = {
3
+ [K in keyof T]: T[K];
4
+ } & {};
5
+ type Atomic = string | number | bigint | boolean | symbol | null | undefined | Date | RegExp | Error;
6
+ type CallableMemberKeys<T extends object> = {
7
+ [K in keyof T]-?: T[K] extends (...args: never[]) => unknown ? K : never;
8
+ }[keyof T];
9
+ type HasCallableMembers<T extends object> = [CallableMemberKeys<T>] extends [never] ? false : true;
10
+ /**
11
+ * Expands object intersections into readable object types without recursing
12
+ * forever. Ten levels are expanded by default; values below the limit keep
13
+ * their original type. Objects with methods, including File, FileList, and
14
+ * class instances, are preserved. Pass field-only class types as Preserve.
15
+ */
16
+ export type PrettifyDeep<T, MaxDepth extends number = 10, Preserve = never, Depth extends readonly unknown[] = []> = Depth["length"] extends MaxDepth ? T : T extends Atomic | Preserve ? T : T extends (...args: never[]) => unknown ? T : T extends readonly [unknown, ...unknown[]] ? {
17
+ [K in keyof T]: PrettifyDeep<T[K], MaxDepth, Preserve, readonly [...Depth, unknown]>;
18
+ } : T extends readonly (infer Item)[] ? T extends (infer MutableItem)[] ? PrettifyDeep<MutableItem, MaxDepth, Preserve, readonly [...Depth, unknown]>[] : PrettifyDeep<Item, MaxDepth, Preserve, readonly [...Depth, unknown]>[] : T extends object ? HasCallableMembers<T> extends true ? T : {
19
+ [K in keyof T]: PrettifyDeep<T[K], MaxDepth, Preserve, readonly [...Depth, unknown]>;
20
+ } & {} : T;
21
+ export type KeyName<T> = Extract<keyof T, string>;
22
+ export type RelationMap<C> = Readonly<Record<string, KeyName<C>>>;
23
+ export type SingleKeyOptions<C> = Readonly<{
24
+ local: string;
25
+ foreign: KeyName<C>;
26
+ }>;
27
+ export type CompositeKeyOptions<C> = Readonly<{
28
+ local: readonly [string, ...string[]];
29
+ foreign: readonly [KeyName<C>, ...KeyName<C>[]];
30
+ }>;
31
+ export type OnOptions<C> = Readonly<{
32
+ on: RelationMap<C>;
33
+ }>;
34
+ export type RelationOptions<C> = OnOptions<C> | SingleKeyOptions<C> | CompositeKeyOptions<C>;
35
+ export type Cardinality = "one" | "many";
36
+ export type IsDefined<O> = O extends {
37
+ readonly defined: true;
38
+ } ? true : false;
39
+ export interface RelationDescriptor<C, K extends Cardinality, I, O = RelationOptions<C>, D extends boolean = false> {
40
+ readonly kind: K;
41
+ readonly rows: readonly C[];
42
+ readonly options: O;
43
+ readonly include: I;
44
+ readonly defined: D;
45
+ }
46
+ export interface AnyRelationDescriptor {
47
+ readonly kind: Cardinality;
48
+ readonly rows: readonly unknown[];
49
+ readonly options: unknown;
50
+ readonly include: unknown;
51
+ readonly defined: boolean;
52
+ }
53
+ type NonNullish<T> = Exclude<T, null | undefined>;
54
+ type Widen<T> = T extends string ? string : T extends number ? number : T extends bigint ? bigint : T extends boolean ? boolean : T extends symbol ? symbol : T;
55
+ type Compatible<A, B> = [Widen<NonNullish<A>>] extends [Widen<NonNullish<B>>] ? [Widen<NonNullish<B>>] extends [Widen<NonNullish<A>>] ? true : false : false;
56
+ type CompatibleKeyName<Value, Row> = {
57
+ [K in KeyName<Row>]: Compatible<Value, Row[K]> extends true ? K : never;
58
+ }[KeyName<Row>];
59
+ export type InferredOnOptions<P, C> = Readonly<{
60
+ on: Readonly<Partial<{
61
+ [L in KeyName<P>]: CompatibleKeyName<P[L], C>;
62
+ }>>;
63
+ }>;
64
+ export type InferredSingleKeyOptions<P, C> = {
65
+ [L in KeyName<P>]: Readonly<{
66
+ local: L;
67
+ foreign: CompatibleKeyName<P[L], C>;
68
+ }>;
69
+ }[KeyName<P>];
70
+ export type InferredCompositeKeyOptions<P, C> = Readonly<{
71
+ local: readonly [KeyName<P>, ...KeyName<P>[]];
72
+ foreign: readonly [KeyName<C>, ...KeyName<C>[]];
73
+ }>;
74
+ export type InferredRelationOptions<P, C> = InferredOnOptions<P, C> | InferredSingleKeyOptions<P, C> | InferredCompositeKeyOptions<P, C>;
75
+ type ValidateOn<P, C, M> = M extends Readonly<Record<string, keyof C>> ? {
76
+ [L in keyof M]: L extends keyof P ? M[L] extends keyof C ? Compatible<P[L], C[M[L]]> extends true ? unknown : never : never : never;
77
+ }[keyof M] extends never ? never : unknown : never;
78
+ type ValidateTuple<P, C, L, F> = L extends readonly [infer LH, ...infer LT] ? F extends readonly [infer FH, ...infer FT] ? LH extends keyof P ? FH extends keyof C ? Compatible<P[LH], C[FH]> extends true ? LT extends readonly [] ? FT extends readonly [] ? unknown : never : ValidateTuple<P, C, LT, FT> : never : never : never : never : F extends readonly [] ? unknown : never;
79
+ export type ValidateRelationOptions<P, C, O> = O extends {
80
+ readonly on: infer M;
81
+ } ? ValidateOn<P, C, M> : O extends {
82
+ readonly local: infer L;
83
+ readonly foreign: infer F;
84
+ } ? L extends readonly [string, ...string[]] ? F extends readonly [keyof C, ...(keyof C)[]] ? ValidateTuple<P, C, L, F> : never : L extends keyof P ? F extends keyof C ? Compatible<P[L], C[F]> extends true ? unknown : never : never : never : never;
85
+ export type ValidateRelations<P, R> = R extends Readonly<Record<string, AnyRelationDescriptor>> ? {
86
+ [N in keyof R]: R[N] extends RelationDescriptor<infer C, Cardinality, infer I, infer O, boolean> ? R[N] & ValidateRelationOptions<P, C, O> & (I extends undefined ? unknown : I extends Readonly<Record<string, AnyRelationDescriptor>> ? {
87
+ readonly include: I & ValidateRelations<C, I>;
88
+ } : never) : never;
89
+ } : never;
90
+ export type Related<C, I> = I extends Readonly<Record<string, AnyRelationDescriptor>> ? C & RelationResults<I> : C;
91
+ export type RelationResults<R> = {
92
+ -readonly [N in keyof R]: R[N] extends RelationDescriptor<infer C, infer K, infer I, unknown, infer D> ? K extends "one" ? D extends true ? Related<C, I> : Related<C, I> | null : Related<C, I>[] : never;
93
+ };
94
+ export type RelateItem<P, R> = PrettifyDeep<P & RelationResults<R>>;
95
+ export type RelateResult<P, R> = readonly RelateItem<P, R>[];
96
+ export {};
97
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export * from "./strict.js";
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,2 @@
1
+ export * from "./strict.js";
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}
@@ -0,0 +1,9 @@
1
+ import { makeMany, makeOne } from "./core/api.js";
2
+ export declare const one: typeof makeOne;
3
+ export declare const many: typeof makeMany;
4
+ export declare const relate: import("./core/api.js").Relate;
5
+ export { RelateKitError } from "./core/errors.js";
6
+ export type { RelateKitErrorCode } from "./core/errors.js";
7
+ export type { RelationBuilders } from "./core/api.js";
8
+ export type { Prettify, PrettifyDeep, RelateItem, RelationKey, RelateResult } from "./core/types.js";
9
+ //# sourceMappingURL=loose.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"loose.d.ts","sourceRoot":"","sources":["../src/loose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAc,MAAM,eAAe,CAAC;AAE9D,eAAO,MAAM,GAAG,gBAAU,CAAC;AAC3B,eAAO,MAAM,IAAI,iBAAW,CAAC;AAC7B,eAAO,MAAM,MAAM,gCAAwC,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}
package/dist/loose.js ADDED
@@ -0,0 +1,6 @@
1
+ import { makeMany, makeOne, makeRelate } from "./core/api.js";
2
+ export const one = makeOne;
3
+ export const many = makeMany;
4
+ export const relate = makeRelate({ duplicateOne: "first" });
5
+ export { RelateKitError } from "./core/errors.js";
6
+ //# sourceMappingURL=loose.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"loose.js","sourceRoot":"","sources":["../src/loose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,CAAC,MAAM,GAAG,GAAG,OAAO,CAAC;AAC3B,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAC;AAC7B,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}
@@ -0,0 +1,9 @@
1
+ import { makeMany, makeOne } from "./core/api.js";
2
+ export declare const one: typeof makeOne;
3
+ export declare const many: typeof makeMany;
4
+ export declare const relate: import("./core/api.js").Relate;
5
+ export { RelateKitError } from "./core/errors.js";
6
+ export type { RelateKitErrorCode } from "./core/errors.js";
7
+ export type { RelationBuilders } from "./core/api.js";
8
+ export type { Prettify, PrettifyDeep, RelateItem, RelationKey, RelateResult } from "./core/types.js";
9
+ //# sourceMappingURL=strict.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"strict.d.ts","sourceRoot":"","sources":["../src/strict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAc,MAAM,eAAe,CAAC;AAE9D,eAAO,MAAM,GAAG,gBAAU,CAAC;AAC3B,eAAO,MAAM,IAAI,iBAAW,CAAC;AAC7B,eAAO,MAAM,MAAM,gCAAwC,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}
package/dist/strict.js ADDED
@@ -0,0 +1,6 @@
1
+ import { makeMany, makeOne, makeRelate } from "./core/api.js";
2
+ export const one = makeOne;
3
+ export const many = makeMany;
4
+ export const relate = makeRelate({ duplicateOne: "throw" });
5
+ export { RelateKitError } from "./core/errors.js";
6
+ //# sourceMappingURL=strict.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"strict.js","sourceRoot":"","sources":["../src/strict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,CAAC,MAAM,GAAG,GAAG,OAAO,CAAC;AAC3B,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAC;AAC7B,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,63 @@
1
1
  {
2
2
  "name": "relatekit",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.1.1",
4
+ "description": "Turn disconnected result sets into typed nested objects.",
5
+ "repository": {
6
+ "type": "git",
7
+ "url": "https://github.com/imteammy/relatekit.git"
8
+ },
9
+ "homepage": "https://github.com/imteammy/relatekit#readme",
10
+ "bugs": {
11
+ "url": "https://github.com/imteammy/relatekit/issues"
12
+ },
13
+ "type": "module",
14
+ "sideEffects": false,
15
+ "files": [
16
+ "dist",
17
+ "README.md"
18
+ ],
19
+ "exports": {
20
+ ".": {
21
+ "types": "./dist/index.d.ts",
22
+ "import": "./dist/index.js"
23
+ },
24
+ "./strict": {
25
+ "types": "./dist/strict.d.ts",
26
+ "import": "./dist/strict.js"
27
+ },
28
+ "./loose": {
29
+ "types": "./dist/loose.d.ts",
30
+ "import": "./dist/loose.js"
31
+ }
32
+ },
33
+ "scripts": {
34
+ "build": "tsc -p tsconfig.build.json",
35
+ "test": "vitest run",
36
+ "test:performance": "tsc -p tsconfig.performance.json && node --max-old-space-size=8192 ./node_modules/vitest/vitest.mjs run --config vitest.performance.config.ts --disableConsoleIntercept",
37
+ "test:watch": "vitest",
38
+ "test:types": "tsc -p tsconfig.types.json",
39
+ "check": "npm run build && npm run test && npm run test:types",
40
+ "docs:start": "npm run build && npm run docs:typecheck && docusaurus start website --no-open",
41
+ "docs:build": "npm run build && npm run docs:typecheck && docusaurus build website --out-dir build",
42
+ "docs:typecheck": "tsc -p website/tsconfig.json --noEmit",
43
+ "docs:serve": "docusaurus serve website --dir build --no-open"
44
+ },
45
+ "devDependencies": {
46
+ "@docusaurus/core": "^3.10.2",
47
+ "@docusaurus/module-type-aliases": "^3.10.2",
48
+ "@docusaurus/preset-classic": "^3.10.2",
49
+ "@docusaurus/theme-live-codeblock": "^3.10.2",
50
+ "@docusaurus/tsconfig": "^3.10.2",
51
+ "@docusaurus/types": "^3.10.2",
52
+ "@easyops-cn/docusaurus-search-local": "^0.55.3",
53
+ "@types/node": "^22.20.5",
54
+ "clsx": "^2.1.1",
55
+ "prism-react-renderer": "^2.4.1",
56
+ "typescript": "^5.9.3",
57
+ "vitest": "4.1.12"
58
+ },
59
+ "engines": {
60
+ "node": ">=18"
61
+ },
62
+ "license": "MIT"
63
+ }