@zintrust/core 0.1.22 → 0.1.23

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 (229) hide show
  1. package/bin/z.d.ts +1 -1
  2. package/bin/z.js +1 -1
  3. package/bin/zin.d.ts +1 -1
  4. package/bin/zin.js +1 -1
  5. package/bin/zintrust-main.d.ts +1 -1
  6. package/bin/zintrust-main.js +2 -2
  7. package/bin/zintrust-microservices.d.ts +1 -1
  8. package/bin/zintrust-microservices.js +1 -1
  9. package/bin/zintrust.d.ts +1 -1
  10. package/bin/zintrust.js +1 -1
  11. package/bin/zt.d.ts +1 -1
  12. package/bin/zt.js +1 -1
  13. package/package.json +2 -3
  14. package/public/index.html +3 -3
  15. package/routes/api.js +1 -1
  16. package/routes/health.d.ts +3 -4
  17. package/routes/health.d.ts.map +1 -1
  18. package/routes/health.js +3 -125
  19. package/src/boot/Application.d.ts.map +1 -1
  20. package/src/boot/Application.js +11 -22
  21. package/src/boot/bootstrap.d.ts +1 -1
  22. package/src/boot/bootstrap.js +48 -7
  23. package/src/builder/BundleOptimizer.d.ts +1 -1
  24. package/src/builder/BundleOptimizer.js +1 -1
  25. package/src/cache/drivers/KVRemoteDriver.d.ts +1 -1
  26. package/src/cache/drivers/KVRemoteDriver.js +1 -1
  27. package/src/cli/CLI.d.ts.map +1 -1
  28. package/src/cli/CLI.js +15 -1
  29. package/src/cli/ErrorHandler.js +3 -3
  30. package/src/cli/commands/AddCommand.d.ts +1 -1
  31. package/src/cli/commands/AddCommand.d.ts.map +1 -1
  32. package/src/cli/commands/AddCommand.js +1 -1
  33. package/src/cli/commands/DbSeedCommand.js +1 -1
  34. package/src/cli/commands/MakeMailTemplateCommand.js +2 -1
  35. package/src/cli/commands/MakeNotificationTemplateCommand.js +2 -1
  36. package/src/cli/commands/MigrateWorkerCommand.d.ts +9 -0
  37. package/src/cli/commands/MigrateWorkerCommand.d.ts.map +1 -0
  38. package/src/cli/commands/MigrateWorkerCommand.js +182 -0
  39. package/src/cli/commands/NewCommand.d.ts +1 -1
  40. package/src/cli/commands/NewCommand.d.ts.map +1 -1
  41. package/src/cli/commands/NewCommand.js +21 -7
  42. package/src/cli/commands/PublishCommand.d.ts +5 -0
  43. package/src/cli/commands/PublishCommand.d.ts.map +1 -0
  44. package/src/cli/commands/PublishCommand.js +54 -0
  45. package/src/cli/commands/QACommand.js +4 -4
  46. package/src/cli/commands/ResourceControlCommand.d.ts +6 -0
  47. package/src/cli/commands/ResourceControlCommand.d.ts.map +1 -0
  48. package/src/cli/commands/ResourceControlCommand.js +43 -0
  49. package/src/cli/commands/SimulateCommand.d.ts +1 -1
  50. package/src/cli/commands/SimulateCommand.js +4 -4
  51. package/src/cli/commands/StartCommand.d.ts.map +1 -1
  52. package/src/cli/commands/StartCommand.js +19 -7
  53. package/src/cli/commands/UpgradeCommand.d.ts +1 -1
  54. package/src/cli/commands/UpgradeCommand.js +2 -2
  55. package/src/cli/commands/WorkerCommands.d.ts +17 -0
  56. package/src/cli/commands/WorkerCommands.d.ts.map +1 -0
  57. package/src/cli/commands/WorkerCommands.js +264 -0
  58. package/src/cli/commands/index.d.ts +2 -0
  59. package/src/cli/commands/index.d.ts.map +1 -1
  60. package/src/cli/commands/index.js +2 -0
  61. package/src/cli/config/ConfigSchema.d.ts +1 -1
  62. package/src/cli/config/ConfigSchema.d.ts.map +1 -1
  63. package/src/cli/config/ConfigSchema.js +4 -3
  64. package/src/cli/scaffolding/ProjectScaffolder.js +5 -5
  65. package/src/cli/scaffolding/RouteGenerator.d.ts.map +1 -1
  66. package/src/cli/scaffolding/RouteGenerator.js +21 -2
  67. package/src/cli/scaffolding/TemplateEngine.js +1 -1
  68. package/src/cli/utils/EnvFileLoader.d.ts.map +1 -1
  69. package/src/common/ExternalServiceUtils.d.ts +63 -0
  70. package/src/common/ExternalServiceUtils.d.ts.map +1 -0
  71. package/src/common/ExternalServiceUtils.js +116 -0
  72. package/src/common/HealthRoutes.d.ts +10 -0
  73. package/src/common/HealthRoutes.d.ts.map +1 -0
  74. package/src/common/HealthRoutes.js +114 -0
  75. package/src/config/SecretsManager.d.ts.map +1 -1
  76. package/src/config/SecretsManager.js +2 -1
  77. package/src/config/app.d.ts +2 -1
  78. package/src/config/app.d.ts.map +1 -1
  79. package/src/config/app.js +98 -52
  80. package/src/config/broadcast.d.ts.map +1 -1
  81. package/src/config/broadcast.js +1 -1
  82. package/src/config/cache.d.ts.map +1 -1
  83. package/src/config/cache.js +2 -2
  84. package/src/config/database.d.ts.map +1 -1
  85. package/src/config/database.js +24 -5
  86. package/src/config/env.d.ts +43 -1
  87. package/src/config/env.d.ts.map +1 -1
  88. package/src/config/env.js +68 -21
  89. package/src/config/index.d.ts +10 -1
  90. package/src/config/index.d.ts.map +1 -1
  91. package/src/config/index.js +1 -0
  92. package/src/config/mail.d.ts.map +1 -1
  93. package/src/config/mail.js +3 -3
  94. package/src/config/middleware.d.ts.map +1 -1
  95. package/src/config/middleware.js +1 -1
  96. package/src/config/notification.d.ts.map +1 -1
  97. package/src/config/notification.js +2 -2
  98. package/src/config/queue.d.ts +14 -0
  99. package/src/config/queue.d.ts.map +1 -1
  100. package/src/config/queue.js +61 -36
  101. package/src/config/security.js +2 -2
  102. package/src/config/storage.d.ts.map +1 -1
  103. package/src/config/storage.js +1 -1
  104. package/src/config/type.d.ts +111 -0
  105. package/src/config/type.d.ts.map +1 -1
  106. package/src/config/workers.d.ts +13 -0
  107. package/src/config/workers.d.ts.map +1 -0
  108. package/src/config/workers.js +173 -0
  109. package/src/database/Paginator.d.ts +37 -0
  110. package/src/database/Paginator.d.ts.map +1 -0
  111. package/src/database/Paginator.js +81 -0
  112. package/src/exceptions/ZintrustError.d.ts +5 -2
  113. package/src/exceptions/ZintrustError.d.ts.map +1 -1
  114. package/src/exceptions/ZintrustError.js +6 -2
  115. package/src/features/Auth.d.ts +1 -1
  116. package/src/features/Auth.d.ts.map +1 -1
  117. package/src/features/Auth.js +3 -2
  118. package/src/features/Queue.d.ts.map +1 -1
  119. package/src/features/Queue.js +0 -2
  120. package/src/index.d.ts +15 -5
  121. package/src/index.d.ts.map +1 -1
  122. package/src/index.js +24 -3
  123. package/src/microservices/MicroserviceBootstrap.d.ts.map +1 -1
  124. package/src/microservices/MicroserviceBootstrap.js +3 -1
  125. package/src/microservices/MicroserviceGenerator.js +4 -4
  126. package/src/microservices/MicroserviceManager.d.ts +1 -1
  127. package/src/microservices/MicroserviceManager.js +1 -1
  128. package/src/middleware/RateLimiter.d.ts.map +1 -1
  129. package/src/middleware/RateLimiter.js +4 -3
  130. package/src/node-singletons/crypto.d.ts +1 -1
  131. package/src/node-singletons/crypto.d.ts.map +1 -1
  132. package/src/node-singletons/crypto.js +1 -1
  133. package/src/node-singletons/os.d.ts +10 -1
  134. package/src/node-singletons/os.d.ts.map +1 -1
  135. package/src/node-singletons/os.js +10 -1
  136. package/src/openapi/OpenApiGenerator.js +2 -2
  137. package/src/orm/ConnectionManager.d.ts +1 -1
  138. package/src/orm/ConnectionManager.d.ts.map +1 -1
  139. package/src/orm/ConnectionManager.js +37 -19
  140. package/src/orm/Model.d.ts +8 -1
  141. package/src/orm/Model.d.ts.map +1 -1
  142. package/src/orm/Model.js +85 -24
  143. package/src/orm/QueryBuilder.d.ts +12 -2
  144. package/src/orm/QueryBuilder.d.ts.map +1 -1
  145. package/src/orm/QueryBuilder.js +438 -38
  146. package/src/orm/Relationships.d.ts +61 -1
  147. package/src/orm/Relationships.d.ts.map +1 -1
  148. package/src/orm/Relationships.js +190 -0
  149. package/src/orm/adapters/D1RemoteAdapter.d.ts +1 -1
  150. package/src/orm/adapters/D1RemoteAdapter.js +1 -1
  151. package/src/performance/Optimizer.d.ts.map +1 -1
  152. package/src/performance/Optimizer.js +2 -4
  153. package/src/routing/CoreRoutes.d.ts +1 -1
  154. package/src/routing/CoreRoutes.d.ts.map +1 -1
  155. package/src/routing/CoreRoutes.js +2 -116
  156. package/src/routing/error.d.ts.map +1 -1
  157. package/src/routing/error.js +3 -2
  158. package/src/routing/publicRoot.d.ts.map +1 -1
  159. package/src/routing/publicRoot.js +4 -2
  160. package/src/runtime/PluginAutoImports.d.ts.map +1 -1
  161. package/src/runtime/PluginAutoImports.js +20 -4
  162. package/src/runtime/PluginManager.d.ts.map +1 -1
  163. package/src/runtime/PluginManager.js +23 -6
  164. package/src/runtime/RuntimeAdapter.d.ts +3 -3
  165. package/src/runtime/RuntimeAdapter.d.ts.map +1 -1
  166. package/src/runtime/StartupConfigFileRegistry.d.ts +2 -1
  167. package/src/runtime/StartupConfigFileRegistry.d.ts.map +1 -1
  168. package/src/runtime/StartupConfigFileRegistry.js +2 -1
  169. package/src/runtime/adapters/CloudflareAdapter.d.ts.map +1 -1
  170. package/src/runtime/adapters/CloudflareAdapter.js +1 -1
  171. package/src/runtime/adapters/DenoAdapter.d.ts.map +1 -1
  172. package/src/runtime/adapters/DenoAdapter.js +1 -1
  173. package/src/runtime/adapters/FargateAdapter.d.ts +2 -2
  174. package/src/runtime/adapters/FargateAdapter.d.ts.map +1 -1
  175. package/src/runtime/adapters/FargateAdapter.js +1 -1
  176. package/src/runtime/adapters/LambdaAdapter.d.ts +1 -1
  177. package/src/runtime/adapters/LambdaAdapter.d.ts.map +1 -1
  178. package/src/runtime/adapters/LambdaAdapter.js +6 -4
  179. package/src/runtime/adapters/NodeServerAdapter.js +1 -1
  180. package/src/scripts/GenerateEnvArtifacts.js +1 -1
  181. package/src/security/SignedRequest.js +1 -1
  182. package/src/security/StartupSecretValidation.d.ts.map +1 -1
  183. package/src/security/StartupSecretValidation.js +7 -1
  184. package/src/start.d.ts.map +1 -1
  185. package/src/start.js +0 -2
  186. package/src/templates/features/Auth.ts.tpl +4 -4
  187. package/src/templates/project/basic/README.md.tpl +1 -1
  188. package/src/templates/project/basic/app/Middleware/index.ts.tpl +1 -1
  189. package/src/templates/project/basic/config/notification.ts.tpl +1 -1
  190. package/src/templates/project/basic/routes/api.ts.tpl +1 -3
  191. package/src/templates/project/basic/src/index.ts.tpl +1 -1
  192. package/src/templates/project/basic/src/zintrust.plugins.ts.tpl +1 -1
  193. package/src/templates/project/basic/template.json +1 -1
  194. package/src/toolkit/Secrets/index.d.ts.map +1 -1
  195. package/src/toolkit/Secrets/index.js +13 -9
  196. package/src/toolkit/Secrets/providers/AwsSecretsManager.d.ts.map +1 -1
  197. package/src/toolkit/Secrets/providers/AwsSecretsManager.js +20 -7
  198. package/src/toolkit/Secrets/providers/CloudflareKv.d.ts.map +1 -1
  199. package/src/toolkit/Secrets/providers/CloudflareKv.js +19 -6
  200. package/src/tools/http/Http.js +1 -1
  201. package/src/tools/mail/drivers/Ses.d.ts.map +1 -1
  202. package/src/tools/mail/drivers/Ses.js +5 -4
  203. package/src/tools/mail/templates/index.js +2 -2
  204. package/src/tools/notification/drivers/Termii.d.ts.map +1 -1
  205. package/src/tools/notification/drivers/Termii.js +6 -17
  206. package/src/tools/notification/testingHelpers.d.ts.map +1 -1
  207. package/src/tools/queue/Queue.d.ts.map +1 -1
  208. package/src/tools/queue/Queue.js +3 -5
  209. package/src/tools/queue/drivers/Redis.d.ts.map +1 -1
  210. package/src/tools/queue/drivers/Redis.js +7 -1
  211. package/src/tools/storage/drivers/S3.d.ts.map +1 -1
  212. package/src/tools/storage/drivers/S3.js +16 -3
  213. package/src/routes/health.d.ts +0 -2
  214. package/src/routes/health.d.ts.map +0 -1
  215. package/src/routes/health.js +0 -1
  216. package/src/runtime/RuntimeDetector.d.ts +0 -15
  217. package/src/runtime/RuntimeDetector.d.ts.map +0 -1
  218. package/src/runtime/RuntimeDetector.js +0 -271
  219. package/src/templates/project/basic/routes/health.ts.tpl +0 -143
  220. package/src/templates/project/basic/routes/metrics.ts.tpl +0 -22
  221. package/src/workers/BroadcastWorker.d.ts +0 -22
  222. package/src/workers/BroadcastWorker.d.ts.map +0 -1
  223. package/src/workers/BroadcastWorker.js +0 -24
  224. package/src/workers/NotificationWorker.d.ts +0 -22
  225. package/src/workers/NotificationWorker.d.ts.map +0 -1
  226. package/src/workers/NotificationWorker.js +0 -23
  227. package/src/workers/createQueueWorker.d.ts +0 -24
  228. package/src/workers/createQueueWorker.d.ts.map +0 -1
  229. package/src/workers/createQueueWorker.js +0 -114
package/src/orm/Model.js CHANGED
@@ -6,7 +6,7 @@ import { DEFAULTS } from '../config/constants.js';
6
6
  import { ErrorFactory } from '../exceptions/ZintrustError.js';
7
7
  import { useDatabase } from './Database.js';
8
8
  import { QueryBuilder } from './QueryBuilder.js';
9
- import { BelongsTo, BelongsToMany, HasMany, HasOne } from './Relationships.js';
9
+ import { BelongsTo, BelongsToMany, HasMany, HasManyThrough, HasOne, HasOneThrough, MorphMany, MorphOne, MorphTo, } from './Relationships.js';
10
10
  const getRelatedTableName = (relatedModel) => {
11
11
  if (typeof relatedModel.getTable === 'function') {
12
12
  return relatedModel.getTable();
@@ -97,19 +97,33 @@ const createModelJSON = (config, attrs) => {
97
97
  }
98
98
  return json;
99
99
  };
100
+ const createHasOneFactory = (config) => (relatedModel, foreignKey) => HasOne.create(relatedModel, foreignKey ?? `${config.table.slice(0, -1)}_id`, 'id');
101
+ const createHasManyFactory = (config) => (relatedModel, foreignKey) => HasMany.create(relatedModel, foreignKey ?? `${config.table.slice(0, -1)}_id`, 'id');
102
+ const createBelongsToFactory = () => (relatedModel, foreignKey) => {
103
+ const relatedTable = getRelatedTableName(relatedModel);
104
+ return BelongsTo.create(relatedModel, foreignKey ?? `${relatedTable.slice(0, -1)}_id`, 'id');
105
+ };
106
+ const createBelongsToManyFactory = (config) => (relatedModel, throughTable, foreignKey, relatedKey) => {
107
+ const relatedTable = getRelatedTableName(relatedModel);
108
+ const table = throughTable ?? [config.table, relatedTable].sort((a, b) => a.localeCompare(b)).join('_');
109
+ return BelongsToMany.create(relatedModel, table, foreignKey ?? `${config.table.slice(0, -1)}_id`, relatedKey ?? `${relatedTable.slice(0, -1)}_id`);
110
+ };
111
+ const createMorphOneFactory = () => (relatedModel, morphName, morphType, morphId, localKey) => MorphOne.create(relatedModel, morphName, morphType, morphId, localKey);
112
+ const createMorphManyFactory = () => (relatedModel, morphName, morphType, morphId, localKey) => MorphMany.create(relatedModel, morphName, morphType, morphId, localKey);
113
+ const createMorphToFactory = () => (morphName, morphMap, morphType, morphId) => MorphTo.create(morphName, morphMap, morphType, morphId);
114
+ const createHasOneThroughFactory = () => (relatedModel, through, foreignKey, throughForeignKey, localKey, secondLocalKey) => HasOneThrough.create(relatedModel, through, foreignKey, throughForeignKey, localKey, secondLocalKey);
115
+ const createHasManyThroughFactory = () => (relatedModel, through, foreignKey, throughForeignKey, localKey, secondLocalKey) => HasManyThrough.create(relatedModel, through, foreignKey, throughForeignKey, localKey, secondLocalKey);
100
116
  const createModelRelationships = (config) => {
101
117
  return {
102
- hasOne: (relatedModel, foreignKey) => HasOne.create(relatedModel, foreignKey ?? `${config.table.slice(0, -1)}_id`, 'id'),
103
- hasMany: (relatedModel, foreignKey) => HasMany.create(relatedModel, foreignKey ?? `${config.table.slice(0, -1)}_id`, 'id'),
104
- belongsTo: (relatedModel, foreignKey) => {
105
- const relatedTable = getRelatedTableName(relatedModel);
106
- return BelongsTo.create(relatedModel, foreignKey ?? `${relatedTable.slice(0, -1)}_id`, 'id');
107
- },
108
- belongsToMany: (relatedModel, throughTable, foreignKey, relatedKey) => {
109
- const relatedTable = getRelatedTableName(relatedModel);
110
- const table = throughTable ?? [config.table, relatedTable].sort((a, b) => a.localeCompare(b)).join('_');
111
- return BelongsToMany.create(relatedModel, table, foreignKey ?? `${config.table.slice(0, -1)}_id`, relatedKey ?? `${relatedTable.slice(0, -1)}_id`);
112
- },
118
+ hasOne: createHasOneFactory(config),
119
+ hasMany: createHasManyFactory(config),
120
+ belongsTo: createBelongsToFactory(),
121
+ belongsToMany: createBelongsToManyFactory(config),
122
+ morphOne: createMorphOneFactory(),
123
+ morphMany: createMorphManyFactory(),
124
+ morphTo: createMorphToFactory(),
125
+ hasOneThrough: createHasOneThroughFactory(),
126
+ hasManyThrough: createHasManyThroughFactory(),
113
127
  };
114
128
  };
115
129
  const performModelSave = async (model, config, attrs, getDb, context) => {
@@ -330,24 +344,70 @@ const createRelationMapping = (cfg, resolveMethods) => {
330
344
  }
331
345
  return relationMapping;
332
346
  };
347
+ const hydrateRows = (raw, hydrateModel) => {
348
+ if (!Array.isArray(raw))
349
+ return null;
350
+ const rows = raw.filter(isRecord);
351
+ return rows.map(hydrateModel);
352
+ };
353
+ const loadEagerRelations = async (eagerBuilder, models) => {
354
+ const eagerLoads = typeof eagerBuilder.getEagerLoads === 'function' ? eagerBuilder.getEagerLoads() : undefined;
355
+ const eagerLoadConstraints = typeof eagerBuilder.getEagerLoadConstraints === 'function'
356
+ ? eagerBuilder.getEagerLoadConstraints()
357
+ : undefined;
358
+ if (!Array.isArray(eagerLoads) ||
359
+ eagerLoads.length === 0 ||
360
+ typeof eagerBuilder.load !== 'function' ||
361
+ models.length === 0) {
362
+ return;
363
+ }
364
+ await Promise.all(eagerLoads.map(async (relation) => {
365
+ const constraint = eagerLoadConstraints?.[relation];
366
+ await eagerBuilder.load?.(models, relation, constraint);
367
+ }));
368
+ };
369
+ const loadEagerCounts = async (eagerBuilder, models) => {
370
+ const eagerLoadCounts = typeof eagerBuilder.getEagerLoadCounts === 'function'
371
+ ? eagerBuilder.getEagerLoadCounts()
372
+ : undefined;
373
+ if (!Array.isArray(eagerLoadCounts) ||
374
+ eagerLoadCounts.length === 0 ||
375
+ typeof eagerBuilder.loadCount !== 'function' ||
376
+ models.length === 0) {
377
+ return;
378
+ }
379
+ await Promise.all(eagerLoadCounts.map(async (relation) => eagerBuilder.loadCount?.(models, relation)));
380
+ };
381
+ const hydrateAndLoadRelations = async (raw, eagerBuilder, hydrateModel) => {
382
+ const models = hydrateRows(raw, hydrateModel);
383
+ if (!models)
384
+ return raw;
385
+ await loadEagerRelations(eagerBuilder, models);
386
+ await loadEagerCounts(eagerBuilder, models);
387
+ return models;
388
+ };
333
389
  const wrapBuilderGetForEagerLoading = (builder, hydrateModel) => {
334
390
  const eagerBuilder = builder;
335
391
  const originalGet = eagerBuilder.get.bind(builder);
336
392
  eagerBuilder.get = async () => {
337
393
  const raw = await originalGet();
338
- if (!Array.isArray(raw))
339
- return raw;
340
- const rows = raw.filter(isRecord);
341
- const models = rows.map(hydrateModel);
342
- const eagerLoads = typeof eagerBuilder.getEagerLoads === 'function' ? eagerBuilder.getEagerLoads() : undefined;
343
- if (Array.isArray(eagerLoads) &&
344
- eagerLoads.length > 0 &&
345
- typeof eagerBuilder.load === 'function' &&
346
- models.length > 0) {
347
- await Promise.all(eagerLoads.map(async (relation) => eagerBuilder.load?.(models, relation)));
348
- }
349
- return models;
394
+ return hydrateAndLoadRelations(raw, eagerBuilder, hydrateModel);
350
395
  };
396
+ if (typeof eagerBuilder.paginate === 'function') {
397
+ const originalPaginate = eagerBuilder.paginate.bind(builder);
398
+ eagerBuilder.paginate = async (page, perPage, options) => {
399
+ const result = await originalPaginate(page, perPage, options);
400
+ if (!Array.isArray(result.items))
401
+ return result;
402
+ const models = await hydrateAndLoadRelations(result.items, eagerBuilder, hydrateModel);
403
+ if (!Array.isArray(models))
404
+ return result;
405
+ return {
406
+ ...result,
407
+ items: models,
408
+ };
409
+ };
410
+ }
351
411
  };
352
412
  const createQueryBuilderMethods = (cfg, hydrateModel) => {
353
413
  const wrappedBuilder = () => {
@@ -357,6 +417,7 @@ const createQueryBuilderMethods = (cfg, hydrateModel) => {
357
417
  };
358
418
  return {
359
419
  query: () => wrappedBuilder(),
420
+ paginate: async (page, perPage, options) => wrappedBuilder().paginate(page, perPage, options),
360
421
  where: (column, operator, value) => wrappedBuilder().where(column, operator, value),
361
422
  andWhere: (column, operator, value) => wrappedBuilder().andWhere(column, operator, value),
362
423
  orWhere: (column, operator, value) => wrappedBuilder().orWhere(column, operator, value),
@@ -2,6 +2,7 @@
2
2
  * QueryBuilder - Type-Safe Query Builder
3
3
  * Build queries without raw SQL
4
4
  */
5
+ import type { PaginationQuery, Paginator } from '../database/Paginator';
5
6
  import type { IDatabase } from './Database';
6
7
  import type { IModel } from './Model';
7
8
  export interface WhereClause {
@@ -23,6 +24,12 @@ export interface QueryBuilderOptions {
23
24
  softDeleteColumn?: string;
24
25
  softDeleteMode?: SoftDeleteMode;
25
26
  }
27
+ export interface PaginationOptions {
28
+ baseUrl?: string;
29
+ query?: PaginationQuery;
30
+ }
31
+ export type EagerLoadConstraint = (builder: IQueryBuilder) => IQueryBuilder;
32
+ export type EagerLoadConstraints = Record<string, EagerLoadConstraint>;
26
33
  export interface IQueryBuilder {
27
34
  select(...columns: string[]): IQueryBuilder;
28
35
  selectAs(column: string, alias: string): IQueryBuilder;
@@ -60,8 +67,11 @@ export interface IQueryBuilder {
60
67
  firstOrFail<T>(message?: string): Promise<T>;
61
68
  get<T>(): Promise<T[]>;
62
69
  raw<T>(): Promise<T[]>;
63
- with(relation: string): IQueryBuilder;
64
- load(models: IModel[], relation: string): Promise<void>;
70
+ paginate<T>(page: number, perPage: number, options?: PaginationOptions): Promise<Paginator<T>>;
71
+ with(relation: string | EagerLoadConstraints): IQueryBuilder;
72
+ withCount(relation: string): IQueryBuilder;
73
+ load(models: IModel[], relation: string, constraint?: EagerLoadConstraint): Promise<void>;
74
+ loadCount(models: IModel[], relation: string): Promise<void>;
65
75
  insert(values: Record<string, unknown> | Array<Record<string, unknown>>): Promise<InsertResult>;
66
76
  update(values: Record<string, unknown>): Promise<void>;
67
77
  delete(): Promise<void>;
@@ -1 +1 @@
1
- {"version":3,"file":"QueryBuilder.d.ts","sourceRoot":"","sources":["../../../src/orm/QueryBuilder.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"QueryBuilder.d.ts","sourceRoot":"","sources":["../../../src/orm/QueryBuilder.ts"],"names":[],"mappings":"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"}