@meghjs/core 0.5.1 → 0.5.3

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.
Files changed (65) hide show
  1. package/README.md +31 -32
  2. package/dist/collection/pagination.d.ts +9 -0
  3. package/dist/collection/pagination.js +11 -1
  4. package/dist/collection/pagination.js.map +1 -1
  5. package/dist/core/application.js +23 -2
  6. package/dist/core/application.js.map +1 -1
  7. package/dist/core/router.js +40 -4
  8. package/dist/core/router.js.map +1 -1
  9. package/dist/openapi/branding.d.ts +1 -1
  10. package/dist/openapi/branding.js.map +1 -1
  11. package/dist/openapi/index.d.ts +1 -0
  12. package/dist/openapi/index.js +4 -0
  13. package/dist/openapi/index.js.map +1 -1
  14. package/dist/openapi/openapi.d.ts +122 -21
  15. package/dist/openapi/openapi.js.map +1 -1
  16. package/dist/openapi/responses.d.ts +89 -0
  17. package/dist/openapi/responses.js +275 -0
  18. package/dist/openapi/responses.js.map +1 -0
  19. package/dist/openapi/swagger-schema.d.ts +5 -0
  20. package/dist/openapi/swagger-schema.js +5 -0
  21. package/dist/openapi/swagger-schema.js.map +1 -1
  22. package/dist/orm/connect.d.ts +12 -1
  23. package/dist/orm/connect.js +72 -1
  24. package/dist/orm/connect.js.map +1 -1
  25. package/dist/orm/connection.d.ts +7 -0
  26. package/dist/orm/connection.js +27 -3
  27. package/dist/orm/connection.js.map +1 -1
  28. package/dist/orm/core.d.ts +2 -0
  29. package/dist/orm/core.js +3 -1
  30. package/dist/orm/core.js.map +1 -1
  31. package/dist/orm/db.js +15 -10
  32. package/dist/orm/db.js.map +1 -1
  33. package/dist/orm/decorators.d.ts +4 -4
  34. package/dist/orm/decorators.js +3 -3
  35. package/dist/orm/decorators.js.map +1 -1
  36. package/dist/orm/factories.d.ts +59 -0
  37. package/dist/orm/factories.js +145 -0
  38. package/dist/orm/factories.js.map +1 -0
  39. package/dist/orm/index.d.ts +3 -0
  40. package/dist/orm/index.js +16 -1
  41. package/dist/orm/index.js.map +1 -1
  42. package/dist/orm/migrations.d.ts +6 -0
  43. package/dist/orm/migrations.js +1 -0
  44. package/dist/orm/migrations.js.map +1 -1
  45. package/dist/orm/model.d.ts +2 -8
  46. package/dist/orm/model.js.map +1 -1
  47. package/dist/orm/openapi.d.ts +8 -0
  48. package/dist/orm/openapi.js +75 -0
  49. package/dist/orm/openapi.js.map +1 -0
  50. package/dist/orm/paging.d.ts +22 -0
  51. package/dist/orm/paging.js +32 -0
  52. package/dist/orm/paging.js.map +1 -0
  53. package/dist/orm/query.js +8 -9
  54. package/dist/orm/query.js.map +1 -1
  55. package/dist/orm/schema.d.ts +2 -0
  56. package/dist/orm/schema.js +21 -0
  57. package/dist/orm/schema.js.map +1 -1
  58. package/dist/orm/seeders.d.ts +66 -0
  59. package/dist/orm/seeders.js +173 -0
  60. package/dist/orm/seeders.js.map +1 -0
  61. package/dist/orm/state.d.ts +2 -2
  62. package/dist/orm/state.js +13 -3
  63. package/dist/orm/state.js.map +1 -1
  64. package/dist/orm/types.d.ts +39 -15
  65. package/package.json +11 -2
@@ -11,6 +11,23 @@ import type { Generated } from "kysely";
11
11
  import type { Cast } from "./casts";
12
12
  import type { AnyRelation, BelongsToMany, RELATION } from "./relations";
13
13
  type Fn = (...args: any[]) => any;
14
+ type IsAny<T> = 0 extends 1 & T ? true : false;
15
+ /**
16
+ * A model instance, recognised by methods every model has. (A full
17
+ * `extends Model` check would compare `this`-typed methods and recurse
18
+ * through the related model's own relations.)
19
+ */
20
+ type ModelLike = {
21
+ isPersisted(): boolean;
22
+ isTrashed(): boolean;
23
+ };
24
+ /**
25
+ * Whether a field holds a relation: typed with a marker (`HasMany<Post>`,
26
+ * `BelongsTo<User>`), as the related model (`role?: Role | null`) or as an
27
+ * array of it (`posts?: Post[]`). `?`, `| null` and `| undefined` don't
28
+ * matter; an `any` field stays a column.
29
+ */
30
+ type IsRelation<T> = IsAny<T> extends true ? false : [NonNullable<T>] extends [never] ? false : NonNullable<T> extends AnyRelation | ModelLike | readonly ModelLike[] ? true : false;
14
31
  type IsReadonly<T, K extends keyof T> = (<X>() => X extends {
15
32
  [Q in K]: T[K];
16
33
  } ? 1 : 2) extends <X>() => X extends {
@@ -22,11 +39,11 @@ type IsReadonly<T, K extends keyof T> = (<X>() => X extends {
22
39
  * visible in error messages.
23
40
  */
24
41
  export type Columns<M> = {
25
- [K in keyof M as K extends string ? M[K] extends Fn ? never : M[K] extends AnyRelation ? never : IsReadonly<M, K> extends true ? never : K : never]: M[K];
42
+ [K in keyof M as K extends string ? M[K] extends Fn ? never : IsRelation<M[K]> extends true ? never : IsReadonly<M, K> extends true ? never : K : never]: M[K];
26
43
  };
27
44
  export type ColumnKeys<M> = keyof Columns<M> & string;
28
45
  type Relations<M> = {
29
- [K in keyof M as K extends string ? M[K] extends AnyRelation ? K : never : never]: M[K];
46
+ [K in keyof M as K extends string ? IsRelation<M[K]> extends true ? K : never : never]: M[K];
30
47
  };
31
48
  export type RelationKeys<M> = keyof Relations<M> & string;
32
49
  /** Methods and getters: kept on query results, which are model instances. */
@@ -35,21 +52,32 @@ type Members<M> = {
35
52
  };
36
53
  /** Keys of `belongsToMany` relations. */
37
54
  export type BelongsToManyKeys<M> = keyof {
38
- [K in keyof M as M[K] extends BelongsToMany<any, any> ? K : never]: 0;
55
+ [K in keyof M as NonNullable<M[K]> extends BelongsToMany<any, any> ? K : never]: 0;
39
56
  } & string;
40
- /** Keys of `hasMany` and `hasOne` relations. */
57
+ /**
58
+ * Keys of `hasMany` and `hasOne` relations. A field typed as a model
59
+ * (`Profile | null`, `Post[]`) counts too: its type can't tell `hasOne`
60
+ * from `belongsTo`, and `related()` checks the real kind when it runs.
61
+ */
41
62
  export type HasRelationKeys<M> = keyof {
42
- [K in keyof M as M[K] extends {
63
+ [K in keyof M as IsAny<M[K]> extends true ? never : NonNullable<M[K]> extends {
43
64
  readonly [RELATION]: {
44
65
  type: "hasMany" | "hasOne";
45
66
  };
46
- } ? K : never]: 0;
67
+ } | ModelLike | readonly ModelLike[] ? K : never]: 0;
47
68
  } & string;
48
- export type RelatedModel<R> = R extends {
69
+ /** The model a relation field points to: `Post` for `HasMany<Post>`, `Post[]` or `Post | null`. */
70
+ export type RelatedModel<R> = NonNullable<R> extends {
49
71
  readonly [RELATION]: {
50
72
  model: infer T;
51
73
  };
52
- } ? T : never;
74
+ } ? T : NonNullable<R> extends readonly (infer T)[] ? T : NonNullable<R>;
75
+ /** Whether a relation field loads a list (`HasMany<Post>`, `Post[]`, `BelongsToMany<Tag>`). */
76
+ export type IsManyRelation<R> = NonNullable<R> extends {
77
+ readonly [RELATION]: {
78
+ kind: "many";
79
+ };
80
+ } | readonly unknown[] ? true : false;
53
81
  /** Relation paths for `with()`, up to 3 levels: "posts" | "posts.comments" | … */
54
82
  export type RelationPaths<M, Depth extends unknown[] = []> = Depth["length"] extends 3 ? never : {
55
83
  [K in RelationKeys<M>]: K | `${K}.${RelationPaths<RelatedModel<M[K]>, [...Depth, unknown]>}`;
@@ -57,18 +85,14 @@ export type RelationPaths<M, Depth extends unknown[] = []> = Depth["length"] ext
57
85
  type Head<P> = P extends `${infer H}.${string}` ? H : P;
58
86
  type Tail<P, H extends string> = P extends `${H}.${infer R}` ? R : never;
59
87
  /** Pivot columns of a `belongsToMany` relation. */
60
- export type PivotOf<R> = R extends {
88
+ export type PivotOf<R> = NonNullable<R> extends {
61
89
  readonly [RELATION]: {
62
90
  pivot: infer Pivot;
63
91
  };
64
92
  } ? Pivot : never;
65
- type Resolve<R, Shape> = R extends BelongsToMany<any, infer Pivot> ? (Shape & {
93
+ type Resolve<R, Shape> = NonNullable<R> extends BelongsToMany<any, infer Pivot> ? (Shape & {
66
94
  readonly pivot: Pivot;
67
- })[] : R extends {
68
- readonly [RELATION]: {
69
- kind: "many";
70
- };
71
- } ? Shape[] : Shape | null;
95
+ })[] : IsManyRelation<R> extends true ? Shape[] : Shape | null;
72
96
  /** Eager-loaded relations for the path union `P`. */
73
97
  type Loaded<M, P extends string> = {
74
98
  [H in Head<P> & RelationKeys<M>]: Resolve<M[H], Row<RelatedModel<M[H]>, Tail<P, H>>>;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@meghjs/core",
3
- "version": "0.5.1",
3
+ "version": "0.5.3",
4
4
  "description": "TypeScript-first web framework built on Fastify",
5
5
  "author": "Tareq Hossain",
6
6
  "license": "MIT",
@@ -52,6 +52,7 @@
52
52
  "reflect-metadata": "^0.2.2"
53
53
  },
54
54
  "peerDependencies": {
55
+ "@faker-js/faker": ">=9.0.0",
55
56
  "@fastify/compress": "^9.0.0",
56
57
  "@fastify/cors": "^11.0.0",
57
58
  "@fastify/helmet": "^13.0.0",
@@ -74,6 +75,9 @@
74
75
  "socket.io": ">=4.0.0"
75
76
  },
76
77
  "peerDependenciesMeta": {
78
+ "@faker-js/faker": {
79
+ "optional": true
80
+ },
77
81
  "@fastify/compress": {
78
82
  "optional": true
79
83
  },
@@ -130,6 +134,7 @@
130
134
  }
131
135
  },
132
136
  "devDependencies": {
137
+ "@faker-js/faker": "^10.6.0",
133
138
  "@fastify/compress": "^9.3.0",
134
139
  "@fastify/cors": "^11.0.0",
135
140
  "@fastify/helmet": "^13.2.0",
@@ -156,10 +161,14 @@
156
161
  "fastify-socket.io": "^4.0.0",
157
162
  "ioredis": "^5.10.1",
158
163
  "kafkajs": "^2.2.4",
164
+ "mysql2": "^3.24.6",
165
+ "pg": "^8.23.1",
159
166
  "pino-pretty": "^13.1.3",
160
167
  "prettier": "^3.6.2",
161
168
  "sharp": "^0.35.5",
162
169
  "socket.io": "^4.8.3",
170
+ "tarn": "^3.1.2",
171
+ "tedious": "^20.3.8",
163
172
  "typescript": "^5.7.2",
164
173
  "unplugin-swc": "^2.0.0",
165
174
  "vitest": "^4.1.12"
@@ -177,5 +186,5 @@
177
186
  "publishConfig": {
178
187
  "access": "public"
179
188
  },
180
- "gitHead": "77cdb018997e7907d58d4877aa855e5e3bd2be3c"
189
+ "gitHead": "65437cf19a7f0ac6d6ed61ab8c69e10ef148dab0"
181
190
  }