@fjell/lib-sequelize 4.4.69 → 4.4.71
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/dist/RowProcessor.d.ts.map +1 -1
- package/dist/index.js +320 -71
- package/dist/index.js.map +4 -4
- package/dist/ops/all.d.ts.map +1 -1
- package/dist/ops/create.d.ts.map +1 -1
- package/dist/ops/find.d.ts.map +1 -1
- package/dist/ops/remove.d.ts.map +1 -1
- package/dist/ops/update.d.ts.map +1 -1
- package/dist/ops/upsert.d.ts.map +1 -1
- package/dist/processing/AggsAdapter.d.ts +47 -0
- package/dist/processing/AggsAdapter.d.ts.map +1 -0
- package/dist/processing/ReferenceBuilder.d.ts.map +1 -1
- package/dist/processing/RefsAdapter.d.ts +84 -0
- package/dist/processing/RefsAdapter.d.ts.map +1 -0
- package/dist/processing/index.d.ts +2 -0
- package/dist/processing/index.d.ts.map +1 -1
- package/package.json +6 -6
package/dist/ops/all.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"all.d.ts","sourceRoot":"","sources":["../../src/ops/all.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,
|
|
1
|
+
{"version":3,"file":"all.d.ts","sourceRoot":"","sources":["../../src/ops/all.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAoD,MAAM,aAAa,CAAC;AAK1F,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,IAAI,EAA0B,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAM,MAAM,WAAW,CAAC;AAgC5C,eAAO,MAAM,eAAe,GAC1B,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACrC,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EAEzB,QAAQ,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAC/B,YAAY,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAChD,UAAU,OAAO,CAAC,QAAQ,KACzB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAuLpC,CAAA"}
|
package/dist/ops/create.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/ops/create.ts"],"names":[],"mappings":"AACA,OAAO,EAA+B,YAAY,EAAsB,IAAI,EAAuB,MAAM,aAAa,CAAC;AAGvH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;
|
|
1
|
+
{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/ops/create.ts"],"names":[],"mappings":"AACA,OAAO,EAA+B,YAAY,EAAsB,IAAI,EAAuB,MAAM,aAAa,CAAC;AAGvH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AA4DxC,eAAO,MAAM,kBAAkB,GAC7B,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACrC,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EAEzB,QAAQ,WAAW,CAAC,GAAG,CAAC,EAAE,EAC1B,YAAY,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAEhD,UAAU,OAAO,CAAC,QAAQ,KACzB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAqLvC,CAAA"}
|
package/dist/ops/find.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../src/ops/find.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,UAAU,
|
|
1
|
+
{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../src/ops/find.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,UAAU,EAAoC,IAAI,EAAe,MAAM,aAAa,CAAC;AAGjH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AAMtC,eAAO,MAAM,gBAAgB,GAC3B,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACrC,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EAEzB,QAAQ,WAAW,CAAC,GAAG,CAAC,EAAE,EAC1B,YAAY,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAChD,UAAU,OAAO,CAAC,QAAQ,KACzB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAuFrC,CAAA"}
|
package/dist/ops/remove.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../src/ops/remove.ts"],"names":[],"mappings":"AACA,OAAO,EAAwD,IAAI,EAAU,YAAY,EAAuB,MAAM,aAAa,CAAC;AAEpI,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAI3C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;
|
|
1
|
+
{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../src/ops/remove.ts"],"names":[],"mappings":"AACA,OAAO,EAAwD,IAAI,EAAU,YAAY,EAAuB,MAAM,aAAa,CAAC;AAEpI,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAI3C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAgDxC,eAAO,MAAM,kBAAkB,GAC7B,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACrC,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EAEzB,QAAQ,WAAW,CAAC,GAAG,CAAC,EAAE,EAC1B,YAAY,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAChD,WAAW,OAAO,YAAY,EAAE,QAAQ,KACvC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CA2FvC,CAAA"}
|
package/dist/ops/update.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/ops/update.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,IAAI,EAEJ,YAAY,EAEb,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAM3C,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAM,MAAM,WAAW,CAAC;
|
|
1
|
+
{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/ops/update.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,IAAI,EAEJ,YAAY,EAEb,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAM3C,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAM,MAAM,WAAW,CAAC;AAgC5C,eAAO,MAAM,kBAAkB,GAC7B,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACrC,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EAEzB,QAAQ,WAAW,CAAC,GAAG,CAAC,EAAE,EAC1B,YAAY,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAEhD,UAAU,OAAO,CAAC,QAAQ,KACzB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAmIvC,CAAA"}
|
package/dist/ops/upsert.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"upsert.d.ts","sourceRoot":"","sources":["../../src/ops/upsert.ts"],"names":[],"mappings":"AACA,OAAO,EAA+C,IAAI,
|
|
1
|
+
{"version":3,"file":"upsert.d.ts","sourceRoot":"","sources":["../../src/ops/upsert.ts"],"names":[],"mappings":"AACA,OAAO,EAA+C,IAAI,EAAqD,YAAY,EAAE,MAAM,aAAa,CAAC;AAEjJ,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAQxC,eAAO,MAAM,kBAAkB,GAC7B,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACrC,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EAEzB,QAAQ,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAC/B,YAAY,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAChD,UAAU,OAAO,CAAC,QAAQ,KACzB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CA6DvC,CAAA"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AggsAdapter: Transparent wrapper for aggregations
|
|
3
|
+
*
|
|
4
|
+
* This module provides transparent conversion between direct aggregation properties
|
|
5
|
+
* and a unified aggs structure pattern. The wrapper is completely confined to the
|
|
6
|
+
* library boundaries - items are automatically wrapped when leaving libraries and
|
|
7
|
+
* unwrapped when entering.
|
|
8
|
+
*
|
|
9
|
+
* Key Principles:
|
|
10
|
+
* - Transparency: Users never need to think about wrapping/unwrapping
|
|
11
|
+
* - Boundary Confinement: All complexity stays within library boundaries
|
|
12
|
+
* - Automatic: Wrapping happens on output, unwrapping happens on input
|
|
13
|
+
* - Unified API: External code always sees aggs structure, regardless of backend
|
|
14
|
+
*/
|
|
15
|
+
import { Item } from "@fjell/core";
|
|
16
|
+
import { AggregationDefinition } from "@fjell/lib";
|
|
17
|
+
/**
|
|
18
|
+
* Converts an item to include an aggs structure.
|
|
19
|
+
* Aggregation properties are moved from direct properties to aggs[name].
|
|
20
|
+
*
|
|
21
|
+
* This is called automatically when items leave libraries (e.g., returned
|
|
22
|
+
* from operations). The aggs structure is added transparently - external
|
|
23
|
+
* code always sees items with aggs structure.
|
|
24
|
+
*
|
|
25
|
+
* @param item - The item (plain object)
|
|
26
|
+
* @param aggregationDefinitions - Array of AggregationDefinition configs
|
|
27
|
+
* @returns The item with an aggs structure added
|
|
28
|
+
*/
|
|
29
|
+
export declare function addAggsToItem<T extends Item<any, any, any, any, any, any>>(item: T, aggregationDefinitions: AggregationDefinition[]): T & {
|
|
30
|
+
aggs: Record<string, any>;
|
|
31
|
+
};
|
|
32
|
+
/**
|
|
33
|
+
* Removes the aggs structure from an item, converting it back to
|
|
34
|
+
* direct properties. This is mainly for consistency since aggregations
|
|
35
|
+
* are read-only and typically not written back.
|
|
36
|
+
*
|
|
37
|
+
* This is called automatically when items enter libraries (e.g., passed
|
|
38
|
+
* to create/update operations). The aggs structure is removed transparently.
|
|
39
|
+
*
|
|
40
|
+
* @param item - The item with aggs structure
|
|
41
|
+
* @param aggregationDefinitions - Array of AggregationDefinition configs
|
|
42
|
+
* @returns The item without aggs structure, with aggregations as direct properties
|
|
43
|
+
*/
|
|
44
|
+
export declare function removeAggsFromItem<T extends Partial<Item<any, any, any, any, any, any>> & {
|
|
45
|
+
aggs?: Record<string, any>;
|
|
46
|
+
}>(item: T, aggregationDefinitions: AggregationDefinition[]): T;
|
|
47
|
+
//# sourceMappingURL=AggsAdapter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"AggsAdapter.d.ts","sourceRoot":"","sources":["../../src/processing/AggsAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAKnD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACxE,IAAI,EAAE,CAAC,EACP,sBAAsB,EAAE,qBAAqB,EAAE,GAC9C,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,CAqCnC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,EACvH,IAAI,EAAE,CAAC,EACP,sBAAsB,EAAE,qBAAqB,EAAE,GAC9C,CAAC,CAuBH"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ReferenceBuilder.d.ts","sourceRoot":"","sources":["../../src/processing/ReferenceBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,IAAI,EAAU,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,GAAG,EACT,qBAAqB,4BAA4B,EACjD,UAAU,QAAQ,EAClB,UAAU,gBAAgB,
|
|
1
|
+
{"version":3,"file":"ReferenceBuilder.d.ts","sourceRoot":"","sources":["../../src/processing/ReferenceBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,IAAI,EAAU,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,GAAG,EACT,qBAAqB,4BAA4B,EACjD,UAAU,QAAQ,EAClB,UAAU,gBAAgB,iBA2K3B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,GACvC,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EAEvB,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAC1C,sBAAsB,4BAA4B,EAAE,KACnD,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAWvC,CAAC"}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* RefsAdapter: Transparent wrapper for Sequelize items
|
|
3
|
+
*
|
|
4
|
+
* This module provides transparent conversion between Sequelize's foreign key column pattern
|
|
5
|
+
* and Firestore's refs structure pattern. The wrapper is completely confined to the Sequelize
|
|
6
|
+
* library - items are automatically wrapped when leaving the library and unwrapped when entering.
|
|
7
|
+
*
|
|
8
|
+
* Key Principles:
|
|
9
|
+
* - Transparency: Users never need to think about wrapping/unwrapping
|
|
10
|
+
* - Boundary Confinement: All complexity stays within @fjell/lib-sequelize
|
|
11
|
+
* - Automatic: Wrapping happens on output, unwrapping happens on input
|
|
12
|
+
* - Unified API: External code always sees refs structure, regardless of backend
|
|
13
|
+
*/
|
|
14
|
+
import { ComKey, Item, PriKey } from "@fjell/core";
|
|
15
|
+
import { SequelizeReferenceDefinition } from "./ReferenceBuilder";
|
|
16
|
+
/**
|
|
17
|
+
* Type for a reference structure with flattened item properties.
|
|
18
|
+
* When populated, item properties are merged directly onto the reference object.
|
|
19
|
+
* This allows access via refs.name.property instead of refs.name.item.property.
|
|
20
|
+
*/
|
|
21
|
+
export type ItemReference = {
|
|
22
|
+
key: PriKey<any> | ComKey<any, any, any, any, any, any>;
|
|
23
|
+
} & Partial<Omit<Item<any, any, any, any, any, any>, 'key'>>;
|
|
24
|
+
/**
|
|
25
|
+
* Builds a key structure (PriKey or ComKey) from a foreign key value and reference definition.
|
|
26
|
+
* This converts Sequelize's foreign key column pattern to Fjell's key structure.
|
|
27
|
+
*/
|
|
28
|
+
export declare function buildKeyFromForeignKey(refDef: SequelizeReferenceDefinition, foreignKeyValue: any, item: any): PriKey<any> | ComKey<any, any, any, any, any, any>;
|
|
29
|
+
/**
|
|
30
|
+
* Converts a Sequelize item to include a flattened refs structure.
|
|
31
|
+
* Foreign key columns are moved to refs[name].key, and populated references
|
|
32
|
+
* have their properties merged directly onto refs[name] (not nested under item).
|
|
33
|
+
*
|
|
34
|
+
* This is called automatically when items leave the Sequelize library (e.g., returned
|
|
35
|
+
* from operations). The refs structure is added transparently - external code always
|
|
36
|
+
* sees items with refs structure, regardless of the underlying storage pattern.
|
|
37
|
+
*
|
|
38
|
+
* @param item - The Sequelize item (plain object)
|
|
39
|
+
* @param referenceDefinitions - Array of SequelizeReferenceDefinition configs
|
|
40
|
+
* @returns The item with a refs structure added
|
|
41
|
+
*/
|
|
42
|
+
export declare function addRefsToSequelizeItem<T extends Item<any, any, any, any, any, any>>(item: T, referenceDefinitions: SequelizeReferenceDefinition[]): T & {
|
|
43
|
+
refs: Record<string, ItemReference>;
|
|
44
|
+
};
|
|
45
|
+
/**
|
|
46
|
+
* Updates foreign key columns in a Sequelize item based on refs structure.
|
|
47
|
+
* This is used when writing items that have been modified via the refs structure.
|
|
48
|
+
*
|
|
49
|
+
* With flattened references, item properties are directly on the reference object,
|
|
50
|
+
* so we reconstruct the item if properties beyond 'key' are present.
|
|
51
|
+
*
|
|
52
|
+
* @param item - The Sequelize item to update
|
|
53
|
+
* @param refs - The refs structure containing updated reference keys
|
|
54
|
+
* @param referenceDefinitions - Array of SequelizeReferenceDefinition configs
|
|
55
|
+
*/
|
|
56
|
+
export declare function updateForeignKeysFromRefs(item: any, refs: Record<string, ItemReference>, referenceDefinitions: SequelizeReferenceDefinition[]): void;
|
|
57
|
+
/**
|
|
58
|
+
* Removes the refs structure from a Sequelize item, converting it back to
|
|
59
|
+
* the standard Sequelize format with foreign key columns.
|
|
60
|
+
*
|
|
61
|
+
* This is called automatically when items enter the Sequelize library (e.g., passed
|
|
62
|
+
* to create/update operations). The refs structure is removed transparently and
|
|
63
|
+
* foreign key columns are updated from the refs structure if present.
|
|
64
|
+
*
|
|
65
|
+
* @param item - The item with refs structure
|
|
66
|
+
* @param referenceDefinitions - Array of SequelizeReferenceDefinition configs
|
|
67
|
+
* @returns The item without refs structure, with foreign keys updated from refs if present
|
|
68
|
+
*/
|
|
69
|
+
export declare function removeRefsFromSequelizeItem<T extends Item<any, any, any, any, any, any>>(item: Partial<T> & {
|
|
70
|
+
refs?: Record<string, ItemReference>;
|
|
71
|
+
}, referenceDefinitions: SequelizeReferenceDefinition[]): Partial<T>;
|
|
72
|
+
/**
|
|
73
|
+
* Creates a Proxy wrapper around a Sequelize item that provides dynamic refs access.
|
|
74
|
+
* This allows reading and writing refs structure while maintaining compatibility
|
|
75
|
+
* with the underlying Sequelize item.
|
|
76
|
+
*
|
|
77
|
+
* @param item - The Sequelize item to wrap
|
|
78
|
+
* @param referenceDefinitions - Array of SequelizeReferenceDefinition configs
|
|
79
|
+
* @returns A proxied item with dynamic refs property
|
|
80
|
+
*/
|
|
81
|
+
export declare function createRefsProxy<T extends Item<any, any, any, any, any, any>>(item: T, referenceDefinitions: SequelizeReferenceDefinition[]): T & {
|
|
82
|
+
refs: Record<string, ItemReference>;
|
|
83
|
+
};
|
|
84
|
+
//# sourceMappingURL=RefsAdapter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"RefsAdapter.d.ts","sourceRoot":"","sources":["../../src/processing/RefsAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAsB,IAAI,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAKlE;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;CACzD,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,4BAA4B,EACpC,eAAe,EAAE,GAAG,EACpB,IAAI,EAAE,GAAG,GACR,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CA2CpD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACjF,IAAI,EAAE,CAAC,EACP,oBAAoB,EAAE,4BAA4B,EAAE,GACnD,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CAAE,CA2C7C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,GAAG,EACT,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACnC,oBAAoB,EAAE,4BAA4B,EAAE,GACnD,IAAI,CAiDN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACtF,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CAAE,EAC3D,oBAAoB,EAAE,4BAA4B,EAAE,GACnD,OAAO,CAAC,CAAC,CAAC,CAYZ;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC1E,IAAI,EAAE,CAAC,EACP,oBAAoB,EAAE,4BAA4B,EAAE,GACnD,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CAAE,CAyC7C"}
|
|
@@ -1,3 +1,5 @@
|
|
|
1
1
|
export type { SequelizeReferenceDefinition } from './ReferenceBuilder';
|
|
2
2
|
export { buildSequelizeReference, stripSequelizeReferenceItems } from './ReferenceBuilder';
|
|
3
|
+
export type { ItemReference } from './RefsAdapter';
|
|
4
|
+
export { addRefsToSequelizeItem, removeRefsFromSequelizeItem, buildKeyFromForeignKey, updateForeignKeysFromRefs, createRefsProxy } from './RefsAdapter';
|
|
3
5
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/processing/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/processing/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAC3F,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,EACtB,yBAAyB,EACzB,eAAe,EAChB,MAAM,eAAe,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fjell/lib-sequelize",
|
|
3
|
-
"version": "4.4.
|
|
3
|
+
"version": "4.4.71",
|
|
4
4
|
"license": "Apache-2.0",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"library",
|
|
@@ -41,10 +41,10 @@
|
|
|
41
41
|
"docs:test": "cd docs && npm run test"
|
|
42
42
|
},
|
|
43
43
|
"dependencies": {
|
|
44
|
-
"@fjell/core": "^4.4.
|
|
45
|
-
"@fjell/lib": "^4.4.
|
|
46
|
-
"@fjell/logging": "^4.4.
|
|
47
|
-
"@fjell/registry": "^4.4.
|
|
44
|
+
"@fjell/core": "^4.4.66",
|
|
45
|
+
"@fjell/lib": "^4.4.75",
|
|
46
|
+
"@fjell/logging": "^4.4.59",
|
|
47
|
+
"@fjell/registry": "^4.4.72",
|
|
48
48
|
"dayjs": "^1.11.13",
|
|
49
49
|
"deepmerge": "^4.3.1",
|
|
50
50
|
"sequelize": "^6.37.7",
|
|
@@ -53,7 +53,7 @@
|
|
|
53
53
|
"devDependencies": {
|
|
54
54
|
"@eslint/eslintrc": "^3.3.1",
|
|
55
55
|
"@eslint/js": "^9.32.0",
|
|
56
|
-
"@fjell/common-config": "^1.1.
|
|
56
|
+
"@fjell/common-config": "^1.1.31",
|
|
57
57
|
"@swc/core": "^1.13.2",
|
|
58
58
|
"@tsconfig/recommended": "^1.0.10",
|
|
59
59
|
"@types/node": "^24.1.0",
|