@terreno/api 57.2.0 → 57.3.0

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 (277) hide show
  1. package/README.md +17 -7
  2. package/dist/actions.js +19 -7
  3. package/dist/api.d.ts +4 -0
  4. package/dist/api.js +12 -24
  5. package/dist/auth.d.ts +23 -10
  6. package/dist/auth.js +97 -32
  7. package/dist/authRecovery.d.ts +5 -0
  8. package/dist/authRecovery.js +350 -0
  9. package/dist/authTokens.d.ts +8 -0
  10. package/dist/authTokens.js +162 -0
  11. package/dist/betterAuth.d.ts +33 -0
  12. package/dist/betterAuthApp.d.ts +4 -0
  13. package/dist/betterAuthApp.js +26 -8
  14. package/dist/betterAuthSetup.d.ts +44 -2
  15. package/dist/betterAuthSetup.js +288 -18
  16. package/dist/collectionRegistry.d.ts +38 -0
  17. package/dist/collectionRegistry.js +72 -0
  18. package/dist/configurationApp.d.ts +11 -2
  19. package/dist/configurationApp.js +2 -4
  20. package/dist/docLoader.js +35 -6
  21. package/dist/expressServer.d.ts +26 -3
  22. package/dist/expressServer.js +79 -11
  23. package/dist/index.d.ts +16 -0
  24. package/dist/index.js +38 -2
  25. package/dist/mcp/auth.d.ts +1 -0
  26. package/dist/mcp/auth.js +47 -25
  27. package/dist/mcp/handlers.d.ts +1 -1
  28. package/dist/mcp/handlers.js +67 -233
  29. package/dist/mcp/query.d.ts +2 -2
  30. package/dist/mcp/registry.d.ts +1 -5
  31. package/dist/mcp/registry.js +31 -20
  32. package/dist/mcp/schemaGenerator.d.ts +2 -7
  33. package/dist/mcp/schemaGenerator.js +41 -116
  34. package/dist/mcp/server.d.ts +1 -0
  35. package/dist/mcp/server.js +1 -0
  36. package/dist/mcp/serviceTokens.d.ts +16 -0
  37. package/dist/mcp/serviceTokens.js +345 -0
  38. package/dist/mcp/types.d.ts +2 -2
  39. package/dist/models/mcpServiceToken.d.ts +3 -0
  40. package/dist/models/mcpServiceToken.js +208 -0
  41. package/dist/openApiBuilder.d.ts +5 -4
  42. package/dist/openApiBuilder.js +61 -8
  43. package/dist/openApiCompat.js +1 -1
  44. package/dist/openApiValidator.js +0 -2
  45. package/dist/plugins.d.ts +14 -1
  46. package/dist/plugins.js +17 -6
  47. package/dist/populate.d.ts +2 -2
  48. package/dist/populate.js +47 -42
  49. package/dist/rateLimit/applyTrustProxy.d.ts +3 -0
  50. package/dist/rateLimit/applyTrustProxy.js +17 -0
  51. package/dist/rateLimit/createStore.d.ts +2 -0
  52. package/dist/rateLimit/createStore.js +28 -0
  53. package/dist/rateLimit/memoryStore.d.ts +2 -0
  54. package/dist/rateLimit/memoryStore.js +108 -0
  55. package/dist/rateLimit/middleware.d.ts +11 -0
  56. package/dist/rateLimit/middleware.js +110 -0
  57. package/dist/rateLimit/mongoStore.d.ts +3 -0
  58. package/dist/rateLimit/mongoStore.js +122 -0
  59. package/dist/rateLimit/policies.d.ts +14 -0
  60. package/dist/rateLimit/policies.js +151 -0
  61. package/dist/rateLimit/redisStore.d.ts +3 -0
  62. package/dist/rateLimit/redisStore.js +155 -0
  63. package/dist/rateLimit/types.d.ts +54 -0
  64. package/dist/rateLimit/types.js +9 -0
  65. package/dist/rbac/access.js +5 -1
  66. package/dist/rbac/assertAllowed.d.ts +9 -0
  67. package/dist/rbac/assertAllowed.js +182 -0
  68. package/dist/rbac/modelRouterAccess.d.ts +1 -0
  69. package/dist/rbac/modelRouterAccess.js +8 -4
  70. package/dist/rbac/permissionUtils.js +3 -2
  71. package/dist/rbac/resolve.js +5 -4
  72. package/dist/rbac/routes.js +15 -6
  73. package/dist/realtime/deprecation.d.ts +12 -0
  74. package/dist/realtime/deprecation.js +32 -0
  75. package/dist/realtime/realtimeApp.d.ts +1 -1
  76. package/dist/realtime/realtimeApp.js +10 -11
  77. package/dist/realtime/registry.d.ts +0 -31
  78. package/dist/realtime/registry.js +44 -31
  79. package/dist/realtime/socketAuth.d.ts +5 -5
  80. package/dist/realtime/socketAuth.js +11 -1
  81. package/dist/realtime/socketUser.d.ts +5 -1
  82. package/dist/realtime/types.d.ts +14 -4
  83. package/dist/schemaMetadata.d.ts +56 -0
  84. package/dist/schemaMetadata.js +513 -0
  85. package/dist/seedRunner.d.ts +88 -0
  86. package/dist/seedRunner.js +627 -0
  87. package/dist/sync/executors.d.ts +12 -2
  88. package/dist/sync/executors.js +8 -10
  89. package/dist/sync/loadHarness.js +28 -19
  90. package/dist/sync/models.js +26 -24
  91. package/dist/sync/mutationHandler.d.ts +9 -0
  92. package/dist/sync/mutationHandler.js +11 -6
  93. package/dist/sync/registrationSideEffects.d.ts +35 -0
  94. package/dist/sync/registrationSideEffects.js +151 -0
  95. package/dist/sync/registry.d.ts +2 -52
  96. package/dist/sync/registry.js +38 -187
  97. package/dist/sync/routes.js +3 -2
  98. package/dist/sync/scripts/compactTombstones.js +0 -2
  99. package/dist/sync/syncApp.d.ts +3 -3
  100. package/dist/sync/syncApp.js +4 -4
  101. package/dist/sync/syncBatch.js +3 -2
  102. package/dist/sync/syncSeqPlugin.d.ts +1 -1
  103. package/dist/sync/syncSeqPlugin.js +20 -16
  104. package/dist/terrenoApp.d.ts +19 -5
  105. package/dist/terrenoApp.js +66 -18
  106. package/dist/tests/models.d.ts +2 -0
  107. package/dist/tests/models.js +6 -0
  108. package/dist/types/authToken.d.ts +33 -0
  109. package/dist/types/authToken.js +2 -0
  110. package/dist/types/mcpServiceToken.d.ts +41 -0
  111. package/dist/types/mcpServiceToken.js +2 -0
  112. package/dist/webhooks/headerValue.d.ts +2 -0
  113. package/dist/webhooks/headerValue.js +14 -0
  114. package/dist/webhooks/idempotency/memoryStore.d.ts +10 -0
  115. package/dist/webhooks/idempotency/memoryStore.js +65 -0
  116. package/dist/webhooks/idempotency/mongoStore.d.ts +4 -0
  117. package/dist/webhooks/idempotency/mongoStore.js +150 -0
  118. package/dist/webhooks/idempotency/webhookReceipt.d.ts +62 -0
  119. package/dist/webhooks/idempotency/webhookReceipt.js +39 -0
  120. package/dist/webhooks/rawBody.d.ts +14 -0
  121. package/dist/webhooks/rawBody.js +22 -0
  122. package/dist/webhooks/timingSafeEqual.d.ts +4 -0
  123. package/dist/webhooks/timingSafeEqual.js +17 -0
  124. package/dist/webhooks/verifiers/hmac.d.ts +15 -0
  125. package/dist/webhooks/verifiers/hmac.js +49 -0
  126. package/dist/webhooks/verifiers/sendgrid.d.ts +10 -0
  127. package/dist/webhooks/verifiers/sendgrid.js +56 -0
  128. package/dist/webhooks/verifiers/stripe.d.ts +9 -0
  129. package/dist/webhooks/verifiers/stripe.js +99 -0
  130. package/dist/webhooks/verifiers/twilio.d.ts +9 -0
  131. package/dist/webhooks/verifiers/twilio.js +112 -0
  132. package/dist/webhooks/webhooksApp.d.ts +33 -0
  133. package/dist/webhooks/webhooksApp.js +195 -0
  134. package/package.json +4 -5
  135. package/src/__snapshots__/openApi.test.ts.snap +270 -0
  136. package/src/__snapshots__/openApiBuilder.test.ts.snap +30 -12
  137. package/src/__snapshots__/schemaMetadata.test.ts.snap +197 -0
  138. package/src/actions.ts +20 -13
  139. package/src/adminModelRouter.test.ts +133 -0
  140. package/src/api.arrayOperations.test.ts +43 -31
  141. package/src/api.hooks.test.ts +38 -29
  142. package/src/api.query.test.ts +31 -31
  143. package/src/api.test.ts +95 -96
  144. package/src/api.ts +16 -27
  145. package/src/auth.test.ts +107 -51
  146. package/src/auth.ts +98 -29
  147. package/src/authRecovery.test.ts +281 -0
  148. package/src/authRecovery.ts +279 -0
  149. package/src/authTokens.test.ts +94 -0
  150. package/src/authTokens.ts +118 -0
  151. package/src/authVerification.test.ts +293 -0
  152. package/src/betterAuth.ts +24 -0
  153. package/src/betterAuthApp.test.ts +1 -0
  154. package/src/betterAuthApp.ts +27 -9
  155. package/src/betterAuthSetup.test.ts +568 -38
  156. package/src/betterAuthSetup.ts +260 -5
  157. package/src/collectionRegistry.test.ts +165 -0
  158. package/src/collectionRegistry.ts +115 -0
  159. package/src/configurationApp.ts +13 -7
  160. package/src/docLoader.test.ts +45 -1
  161. package/src/docLoader.ts +37 -6
  162. package/src/express.d.ts +1 -0
  163. package/src/expressServer.test.ts +130 -66
  164. package/src/expressServer.ts +75 -19
  165. package/src/githubAuth.test.ts +60 -55
  166. package/src/index.ts +58 -0
  167. package/src/mcp/auth.test.ts +47 -0
  168. package/src/mcp/auth.ts +32 -11
  169. package/src/mcp/handlers.ts +45 -172
  170. package/src/mcp/integration.test.ts +59 -9
  171. package/src/mcp/query.ts +2 -4
  172. package/src/mcp/registry.ts +29 -20
  173. package/src/mcp/schemaGenerator.test.ts +8 -0
  174. package/src/mcp/schemaGenerator.ts +49 -131
  175. package/src/mcp/server.ts +2 -0
  176. package/src/mcp/serviceTokens.test.ts +330 -0
  177. package/src/mcp/serviceTokens.ts +307 -0
  178. package/src/mcp/toolGenerator.test.ts +1 -1
  179. package/src/mcp/types.ts +2 -6
  180. package/src/models/mcpServiceToken.test.ts +129 -0
  181. package/src/models/mcpServiceToken.ts +158 -0
  182. package/src/openApi.test.ts +80 -64
  183. package/src/openApiBuilder.test.ts +95 -7
  184. package/src/openApiBuilder.ts +46 -9
  185. package/src/openApiCompat.ts +1 -1
  186. package/src/openApiValidator.test.ts +49 -54
  187. package/src/openApiValidator.ts +1 -3
  188. package/src/plugins.test.ts +14 -0
  189. package/src/plugins.ts +34 -9
  190. package/src/populate.test.ts +34 -0
  191. package/src/populate.ts +40 -29
  192. package/src/rateLimit/applyTrustProxy.ts +17 -0
  193. package/src/rateLimit/createStore.ts +25 -0
  194. package/src/rateLimit/memoryStore.ts +40 -0
  195. package/src/rateLimit/middleware.ts +79 -0
  196. package/src/rateLimit/mongoStore.test.ts +80 -0
  197. package/src/rateLimit/mongoStore.ts +76 -0
  198. package/src/rateLimit/policies.ts +130 -0
  199. package/src/rateLimit/rateLimit.test.ts +328 -0
  200. package/src/rateLimit/redisStore.ioredis.test.ts +29 -0
  201. package/src/rateLimit/redisStore.test.ts +114 -0
  202. package/src/rateLimit/redisStore.ts +85 -0
  203. package/src/rateLimit/types.ts +64 -0
  204. package/src/rbac/access.ts +5 -1
  205. package/src/rbac/assertAllowed.test.ts +325 -0
  206. package/src/rbac/assertAllowed.ts +157 -0
  207. package/src/rbac/backfillAdmins.test.ts +124 -0
  208. package/src/rbac/fieldViews.test.ts +89 -0
  209. package/src/rbac/modelRouterAccess.test.ts +126 -0
  210. package/src/rbac/modelRouterAccess.ts +5 -2
  211. package/src/rbac/permissionUtils.ts +3 -2
  212. package/src/rbac/realtimeAccess.test.ts +109 -1
  213. package/src/rbac/resolve.ts +5 -4
  214. package/src/rbac/roleManager.test.ts +169 -0
  215. package/src/rbac/routes.test.ts +233 -0
  216. package/src/rbac/routes.ts +16 -6
  217. package/src/realtime/deprecation.test.ts +60 -0
  218. package/src/realtime/deprecation.ts +32 -0
  219. package/src/realtime/realtime.test.ts +8 -4
  220. package/src/realtime/realtimeApp.ts +10 -11
  221. package/src/realtime/realtimeAppSetup.test.ts +32 -5
  222. package/src/realtime/registry.ts +48 -42
  223. package/src/realtime/sessionRevalidation.test.ts +57 -44
  224. package/src/realtime/socketAuth.test.ts +75 -23
  225. package/src/realtime/socketAuth.ts +17 -6
  226. package/src/realtime/socketUser.ts +5 -3
  227. package/src/realtime/types.ts +14 -4
  228. package/src/schemaMetadata.test.ts +405 -0
  229. package/src/schemaMetadata.ts +593 -0
  230. package/src/scrubAdminFields.test.ts +105 -0
  231. package/src/seedRunner.test.ts +591 -0
  232. package/src/seedRunner.ts +464 -0
  233. package/src/sync/docMatchesMutationData.test.ts +16 -0
  234. package/src/sync/ensureSyncIndexes.test.ts +54 -15
  235. package/src/sync/executors.test.ts +40 -0
  236. package/src/sync/executors.ts +24 -12
  237. package/src/sync/integration.test.ts +15 -7
  238. package/src/sync/loadHarness.ts +28 -19
  239. package/src/sync/models.ts +32 -18
  240. package/src/sync/mutationHandler.test.ts +16 -16
  241. package/src/sync/mutationHandler.ts +9 -7
  242. package/src/sync/registrationSideEffects.test.ts +126 -0
  243. package/src/sync/registrationSideEffects.ts +131 -0
  244. package/src/sync/registry.ts +45 -171
  245. package/src/sync/routes.ts +3 -2
  246. package/src/sync/scripts/compactTombstones.ts +0 -2
  247. package/src/sync/sessionRevalidationIntegration.test.ts +12 -11
  248. package/src/sync/sync.test.ts +25 -23
  249. package/src/sync/syncApp.ts +4 -4
  250. package/src/sync/syncBatch.ts +3 -2
  251. package/src/sync/syncFrontier.test.ts +17 -15
  252. package/src/sync/syncPhaseC.test.ts +54 -43
  253. package/src/sync/syncRoutes.test.ts +51 -36
  254. package/src/sync/syncSeqPlugin.ts +66 -44
  255. package/src/sync/syncSocket.test.ts +112 -81
  256. package/src/terrenoApp.mcpServiceTokens.test.ts +173 -0
  257. package/src/terrenoApp.ts +87 -15
  258. package/src/tests/models.ts +14 -1
  259. package/src/types/authToken.ts +43 -0
  260. package/src/types/mcpServiceToken.ts +54 -0
  261. package/src/webhooks/headerValue.test.ts +22 -0
  262. package/src/webhooks/headerValue.ts +12 -0
  263. package/src/webhooks/idempotency/memoryStore.ts +34 -0
  264. package/src/webhooks/idempotency/mongoStore.test.ts +274 -0
  265. package/src/webhooks/idempotency/mongoStore.ts +83 -0
  266. package/src/webhooks/idempotency/webhookReceipt.ts +70 -0
  267. package/src/webhooks/rawBody.test.ts +74 -0
  268. package/src/webhooks/rawBody.ts +23 -0
  269. package/src/webhooks/timingSafeEqual.ts +16 -0
  270. package/src/webhooks/verifiers/hmac.test.ts +110 -0
  271. package/src/webhooks/verifiers/hmac.ts +54 -0
  272. package/src/webhooks/verifiers/providerVerifiers.test.ts +388 -0
  273. package/src/webhooks/verifiers/sendgrid.ts +59 -0
  274. package/src/webhooks/verifiers/stripe.ts +67 -0
  275. package/src/webhooks/verifiers/twilio.ts +69 -0
  276. package/src/webhooks/webhooksApp.test.ts +221 -0
  277. package/src/webhooks/webhooksApp.ts +144 -0
@@ -0,0 +1,513 @@
1
+ "use strict";
2
+ var __assign = (this && this.__assign) || function () {
3
+ __assign = Object.assign || function(t) {
4
+ for (var s, i = 1, n = arguments.length; i < n; i++) {
5
+ s = arguments[i];
6
+ for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
7
+ t[p] = s[p];
8
+ }
9
+ return t;
10
+ };
11
+ return __assign.apply(this, arguments);
12
+ };
13
+ var __values = (this && this.__values) || function(o) {
14
+ var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
15
+ if (m) return m.call(o);
16
+ if (o && typeof o.length === "number") return {
17
+ next: function () {
18
+ if (o && i >= o.length) o = void 0;
19
+ return { value: o && o[i++], done: !o };
20
+ }
21
+ };
22
+ throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
23
+ };
24
+ var __read = (this && this.__read) || function (o, n) {
25
+ var m = typeof Symbol === "function" && o[Symbol.iterator];
26
+ if (!m) return o;
27
+ var i = m.call(o), r, ar = [], e;
28
+ try {
29
+ while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
30
+ }
31
+ catch (error) { e = { error: error }; }
32
+ finally {
33
+ try {
34
+ if (r && !r.done && (m = i["return"])) m.call(i);
35
+ }
36
+ finally { if (e) throw e.error; }
37
+ }
38
+ return ar;
39
+ };
40
+ Object.defineProperty(exports, "__esModule", { value: true });
41
+ exports.fieldDescriptionToZodType = exports.modelDescriptionToAdminFields = exports.fieldDescriptionToAdminMeta = exports.modelDescriptionToOpenApiSpec = exports.fieldDescriptionToOpenApiProperty = exports.describeModelForRouter = exports.describeModel = exports.nestDottedFieldDescriptions = exports.SYSTEM_FIELD_PATHS = void 0;
42
+ exports.SYSTEM_FIELD_PATHS = new Set(["_id", "id", "__v", "created", "updated", "deleted"]);
43
+ var isSystemField = function (path) { return exports.SYSTEM_FIELD_PATHS.has(path); };
44
+ var isMapWildcardPath = function (path) { return path === "$*" || path.endsWith(".$*"); };
45
+ var normalizeKind = function (instance) {
46
+ switch (instance) {
47
+ case "String":
48
+ return "string";
49
+ case "Number":
50
+ return "number";
51
+ case "Boolean":
52
+ return "boolean";
53
+ case "Date":
54
+ return "date";
55
+ case "DateOnly":
56
+ return "dateOnly";
57
+ case "ObjectId":
58
+ case "ObjectID":
59
+ case "SchemaObjectId":
60
+ return "objectId";
61
+ case "Mixed":
62
+ return "mixed";
63
+ case "Map":
64
+ return "map";
65
+ case "Embedded":
66
+ return "embedded";
67
+ default:
68
+ return "mixed";
69
+ }
70
+ };
71
+ var getNestedValueSchemaPath = function (schemaPath) {
72
+ var _a;
73
+ if (typeof schemaPath.getEmbeddedSchemaType === "function") {
74
+ var embedded = schemaPath.getEmbeddedSchemaType();
75
+ if (embedded) {
76
+ return embedded;
77
+ }
78
+ }
79
+ return (_a = schemaPath.$__schemaType) !== null && _a !== void 0 ? _a : schemaPath.caster;
80
+ };
81
+ var describeEmbeddedSchema = function (embeddedSchema) {
82
+ var e_1, _a;
83
+ if (!(embeddedSchema === null || embeddedSchema === void 0 ? void 0 : embeddedSchema.paths)) {
84
+ return undefined;
85
+ }
86
+ var fields = {};
87
+ try {
88
+ for (var _b = __values(Object.entries(embeddedSchema.paths)), _c = _b.next(); !_c.done; _c = _b.next()) {
89
+ var _d = __read(_c.value, 2), path = _d[0], rawSchemaPath = _d[1];
90
+ if (isMapWildcardPath(path)) {
91
+ continue;
92
+ }
93
+ fields[path] = describeSchemaPath(path, rawSchemaPath);
94
+ }
95
+ }
96
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
97
+ finally {
98
+ try {
99
+ if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
100
+ }
101
+ finally { if (e_1) throw e_1.error; }
102
+ }
103
+ return (0, exports.nestDottedFieldDescriptions)(fields);
104
+ };
105
+ var describeCaster = function (caster) {
106
+ var _a, _b, _c, _d;
107
+ var kind = normalizeKind(caster.instance);
108
+ var enumValues = ((_a = caster.enumValues) === null || _a === void 0 ? void 0 : _a.length)
109
+ ? caster.enumValues
110
+ : (_b = caster.options) === null || _b === void 0 ? void 0 : _b.enum;
111
+ return {
112
+ description: (_c = caster.options) === null || _c === void 0 ? void 0 : _c.description,
113
+ enum: (enumValues === null || enumValues === void 0 ? void 0 : enumValues.length) ? enumValues : undefined,
114
+ kind: kind,
115
+ ref: (_d = caster.options) === null || _d === void 0 ? void 0 : _d.ref,
116
+ required: false,
117
+ };
118
+ };
119
+ var describeSchemaPath = function (path, schemaPath) {
120
+ var _a, _b, _c, _d, _e;
121
+ var enumValues = ((_a = schemaPath.enumValues) === null || _a === void 0 ? void 0 : _a.length)
122
+ ? schemaPath.enumValues
123
+ : (_b = schemaPath.options) === null || _b === void 0 ? void 0 : _b.enum;
124
+ var base = {
125
+ default: (_c = schemaPath.options) === null || _c === void 0 ? void 0 : _c.default,
126
+ description: (_d = schemaPath.options) === null || _d === void 0 ? void 0 : _d.description,
127
+ enum: (enumValues === null || enumValues === void 0 ? void 0 : enumValues.length) ? enumValues : undefined,
128
+ kind: normalizeKind(schemaPath.instance),
129
+ ref: (_e = schemaPath.options) === null || _e === void 0 ? void 0 : _e.ref,
130
+ required: Boolean(schemaPath.isRequired),
131
+ system: isSystemField(path),
132
+ };
133
+ if (schemaPath.instance === "Array") {
134
+ if (schemaPath.schema) {
135
+ var nestedFields = describeEmbeddedSchema(schemaPath.schema);
136
+ return __assign(__assign({}, base), { fields: nestedFields, isArray: true, item: {
137
+ fields: nestedFields,
138
+ kind: "embedded",
139
+ required: false,
140
+ }, kind: "embedded" });
141
+ }
142
+ var itemSchemaPath = getNestedValueSchemaPath(schemaPath);
143
+ if (itemSchemaPath) {
144
+ var item = describeCaster(itemSchemaPath);
145
+ return __assign(__assign({}, base), { isArray: true, item: item, kind: item.kind });
146
+ }
147
+ return __assign(__assign({}, base), { isArray: true, item: { kind: "mixed", required: false }, kind: "mixed" });
148
+ }
149
+ if (schemaPath.instance === "Embedded" && schemaPath.schema) {
150
+ var fields = describeEmbeddedSchema(schemaPath.schema);
151
+ return __assign(__assign({}, base), { fields: fields, kind: "embedded" });
152
+ }
153
+ if (schemaPath.instance === "Map") {
154
+ var valueSchemaPath = getNestedValueSchemaPath(schemaPath);
155
+ return __assign(__assign({}, base), { item: valueSchemaPath ? describeCaster(valueSchemaPath) : { kind: "mixed", required: false }, kind: "map" });
156
+ }
157
+ return base;
158
+ };
159
+ var nestDottedFieldDescriptions = function (fields) {
160
+ var e_2, _a;
161
+ var root = {};
162
+ try {
163
+ for (var _b = __values(Object.entries(fields)), _c = _b.next(); !_c.done; _c = _b.next()) {
164
+ var _d = __read(_c.value, 2), path = _d[0], field = _d[1];
165
+ if (!path.includes(".")) {
166
+ root[path] = field;
167
+ continue;
168
+ }
169
+ var parts = path.split(".");
170
+ var current = root;
171
+ for (var index = 0; index < parts.length - 1; index++) {
172
+ var part = parts[index];
173
+ if (!current[part]) {
174
+ current[part] = {
175
+ fields: {},
176
+ kind: "embedded",
177
+ required: false,
178
+ };
179
+ }
180
+ if (!current[part].fields) {
181
+ current[part].fields = {};
182
+ }
183
+ current = current[part].fields;
184
+ }
185
+ current[parts[parts.length - 1]] = field;
186
+ }
187
+ }
188
+ catch (e_2_1) { e_2 = { error: e_2_1 }; }
189
+ finally {
190
+ try {
191
+ if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
192
+ }
193
+ finally { if (e_2) throw e_2.error; }
194
+ }
195
+ return root;
196
+ };
197
+ exports.nestDottedFieldDescriptions = nestDottedFieldDescriptions;
198
+ var isWritePathAllowed = function (path, write) {
199
+ if (write === "*") {
200
+ return true;
201
+ }
202
+ return write.some(function (allowed) { return path === allowed || path.startsWith("".concat(allowed, ".")); });
203
+ };
204
+ var applyWriteMasks = function (fields, options) {
205
+ var _a, _b, _c;
206
+ var validation = typeof options.validation === "object" && options.validation !== null
207
+ ? options.validation
208
+ : undefined;
209
+ var excludeFromCreate = new Set((_a = validation === null || validation === void 0 ? void 0 : validation.excludeFromCreate) !== null && _a !== void 0 ? _a : []);
210
+ var excludeFromUpdate = new Set((_b = validation === null || validation === void 0 ? void 0 : validation.excludeFromUpdate) !== null && _b !== void 0 ? _b : []);
211
+ var excludeFields = new Set((_c = options.excludeFields) !== null && _c !== void 0 ? _c : []);
212
+ var fieldView = options.fieldView;
213
+ var withMasks = function (path, field) {
214
+ var _a;
215
+ var writableOnCreate = !field.system &&
216
+ !excludeFields.has(path) &&
217
+ !excludeFromCreate.has(path) &&
218
+ (!fieldView || isWritePathAllowed(path, fieldView.write));
219
+ var writableOnUpdate = !field.system &&
220
+ !excludeFields.has(path) &&
221
+ !excludeFromUpdate.has(path) &&
222
+ (!fieldView || isWritePathAllowed(path, fieldView.write));
223
+ var next = __assign(__assign({}, field), { writableOnCreate: writableOnCreate, writableOnUpdate: writableOnUpdate });
224
+ if (field.fields) {
225
+ next.fields = Object.fromEntries(Object.entries(field.fields).map(function (_a) {
226
+ var _b = __read(_a, 2), nestedPath = _b[0], nestedField = _b[1];
227
+ return [
228
+ nestedPath,
229
+ withMasks("".concat(path, ".").concat(nestedPath), nestedField),
230
+ ];
231
+ }));
232
+ }
233
+ if ((_a = field.item) === null || _a === void 0 ? void 0 : _a.fields) {
234
+ next.item = __assign(__assign({}, field.item), { fields: Object.fromEntries(Object.entries(field.item.fields).map(function (_a) {
235
+ var _b = __read(_a, 2), nestedPath = _b[0], nestedField = _b[1];
236
+ return [
237
+ nestedPath,
238
+ withMasks("".concat(path, ".").concat(nestedPath), nestedField),
239
+ ];
240
+ })) });
241
+ }
242
+ return next;
243
+ };
244
+ return Object.fromEntries(Object.entries(fields).map(function (_a) {
245
+ var _b = __read(_a, 2), path = _b[0], field = _b[1];
246
+ return [path, withMasks(path, field)];
247
+ }));
248
+ };
249
+ var describeModel = function (model, options) {
250
+ var e_3, _a, e_4, _b;
251
+ if (options === void 0) { options = {}; }
252
+ var fields = {};
253
+ try {
254
+ for (var _c = __values(Object.entries(model.schema.paths)), _d = _c.next(); !_d.done; _d = _c.next()) {
255
+ var _e = __read(_d.value, 2), path = _e[0], rawSchemaPath = _e[1];
256
+ if (isMapWildcardPath(path)) {
257
+ continue;
258
+ }
259
+ fields[path] = describeSchemaPath(path, rawSchemaPath);
260
+ }
261
+ }
262
+ catch (e_3_1) { e_3 = { error: e_3_1 }; }
263
+ finally {
264
+ try {
265
+ if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
266
+ }
267
+ finally { if (e_3) throw e_3.error; }
268
+ }
269
+ if (options.extraProperties) {
270
+ try {
271
+ for (var _f = __values(Object.entries(options.extraProperties)), _g = _f.next(); !_g.done; _g = _f.next()) {
272
+ var _h = __read(_g.value, 2), path = _h[0], field = _h[1];
273
+ fields[path] = field;
274
+ }
275
+ }
276
+ catch (e_4_1) { e_4 = { error: e_4_1 }; }
277
+ finally {
278
+ try {
279
+ if (_g && !_g.done && (_b = _f.return)) _b.call(_f);
280
+ }
281
+ finally { if (e_4) throw e_4.error; }
282
+ }
283
+ }
284
+ return {
285
+ fields: fields,
286
+ modelName: model.modelName,
287
+ };
288
+ };
289
+ exports.describeModel = describeModel;
290
+ var describeModelForRouter = function (model, options) {
291
+ if (options === void 0) { options = {}; }
292
+ var description = (0, exports.describeModel)(model, options);
293
+ return __assign(__assign({}, description), { fields: applyWriteMasks(description.fields, options) });
294
+ };
295
+ exports.describeModelForRouter = describeModelForRouter;
296
+ var fieldDescriptionToOpenApiProperty = function (field) {
297
+ if (field.isArray) {
298
+ var items = field.item
299
+ ? (0, exports.fieldDescriptionToOpenApiProperty)(__assign(__assign({}, field.item), { isArray: false }))
300
+ : { type: "string" };
301
+ var property_1 = {
302
+ description: field.description,
303
+ items: items,
304
+ type: "array",
305
+ };
306
+ if (field.enum) {
307
+ property_1.enum = field.enum;
308
+ }
309
+ return property_1;
310
+ }
311
+ if (field.kind === "embedded" && field.fields) {
312
+ var nested = (0, exports.modelDescriptionToOpenApiSpec)({ fields: field.fields, modelName: "" });
313
+ var property_2 = {
314
+ properties: nested.properties,
315
+ type: "object",
316
+ };
317
+ if (field.description) {
318
+ property_2.description = field.description;
319
+ }
320
+ property_2.required = nested.required.length ? nested.required : [];
321
+ return property_2;
322
+ }
323
+ if (field.kind === "mixed") {
324
+ return { description: field.description };
325
+ }
326
+ if (field.kind === "map") {
327
+ var property_3 = {
328
+ additionalProperties: field.item
329
+ ? (0, exports.fieldDescriptionToOpenApiProperty)(__assign(__assign({}, field.item), { isArray: false }))
330
+ : { type: "string" },
331
+ type: "object",
332
+ };
333
+ if (field.description) {
334
+ property_3.description = field.description;
335
+ }
336
+ return property_3;
337
+ }
338
+ if (field.kind === "dateOnly") {
339
+ return {
340
+ description: field.description,
341
+ type: "dateonly",
342
+ };
343
+ }
344
+ var openApiType = field.kind === "objectId" ? "string" : field.kind === "date" ? "string" : field.kind;
345
+ var property = {
346
+ type: openApiType,
347
+ };
348
+ if (field.description) {
349
+ property.description = field.description;
350
+ }
351
+ if (field.enum) {
352
+ property.enum = field.enum;
353
+ }
354
+ if (field.kind === "objectId" && !field.system) {
355
+ property.format = "objectid";
356
+ }
357
+ if (field.kind === "date") {
358
+ property.format = "date-time";
359
+ }
360
+ return property;
361
+ };
362
+ exports.fieldDescriptionToOpenApiProperty = fieldDescriptionToOpenApiProperty;
363
+ var modelDescriptionToOpenApiSpec = function (description) {
364
+ var e_5, _a;
365
+ var nestedFields = (0, exports.nestDottedFieldDescriptions)(description.fields);
366
+ var properties = {};
367
+ var required = [];
368
+ try {
369
+ for (var _b = __values(Object.entries(nestedFields)), _c = _b.next(); !_c.done; _c = _b.next()) {
370
+ var _d = __read(_c.value, 2), path = _d[0], field = _d[1];
371
+ // mongoose-to-swagger omits __v from OpenAPI components; keep parity for HTTP bodies.
372
+ if (path === "__v") {
373
+ continue;
374
+ }
375
+ properties[path] = (0, exports.fieldDescriptionToOpenApiProperty)(field);
376
+ if (field.required) {
377
+ required.push(path);
378
+ }
379
+ }
380
+ }
381
+ catch (e_5_1) { e_5 = { error: e_5_1 }; }
382
+ finally {
383
+ try {
384
+ if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
385
+ }
386
+ finally { if (e_5) throw e_5.error; }
387
+ }
388
+ return { properties: properties, required: required };
389
+ };
390
+ exports.modelDescriptionToOpenApiSpec = modelDescriptionToOpenApiSpec;
391
+ var fieldDescriptionToAdminMeta = function (field) {
392
+ var adminType = field.isArray
393
+ ? "array"
394
+ : field.kind === "objectId"
395
+ ? "objectid"
396
+ : field.kind === "embedded"
397
+ ? "object"
398
+ : field.kind === "mixed"
399
+ ? "mixed"
400
+ : field.kind === "map"
401
+ ? "object"
402
+ : field.kind === "dateOnly"
403
+ ? "dateonly"
404
+ : field.kind;
405
+ var meta = {
406
+ default: field.default,
407
+ description: field.description,
408
+ enum: field.enum,
409
+ ref: field.ref,
410
+ required: field.required,
411
+ searchable: adminType === "string" && !field.enum,
412
+ type: adminType,
413
+ };
414
+ if (field.isArray && field.item) {
415
+ if (field.item.ref) {
416
+ meta.ref = field.item.ref;
417
+ }
418
+ if (field.item.fields) {
419
+ meta.items = Object.fromEntries(Object.entries(field.item.fields).map(function (_a) {
420
+ var _b = __read(_a, 2), key = _b[0], nestedField = _b[1];
421
+ return [
422
+ key,
423
+ (0, exports.fieldDescriptionToAdminMeta)(nestedField),
424
+ ];
425
+ }));
426
+ }
427
+ else {
428
+ meta.itemType =
429
+ field.item.kind === "objectId"
430
+ ? "objectid"
431
+ : field.item.kind === "embedded"
432
+ ? "object"
433
+ : field.item.kind;
434
+ meta.itemEnum = field.item.enum;
435
+ meta.itemRef = field.item.ref;
436
+ }
437
+ }
438
+ if (field.kind === "embedded" && field.fields && !field.isArray) {
439
+ meta.items = Object.fromEntries(Object.entries(field.fields).map(function (_a) {
440
+ var _b = __read(_a, 2), key = _b[0], nestedField = _b[1];
441
+ return [
442
+ key,
443
+ (0, exports.fieldDescriptionToAdminMeta)(nestedField),
444
+ ];
445
+ }));
446
+ }
447
+ return meta;
448
+ };
449
+ exports.fieldDescriptionToAdminMeta = fieldDescriptionToAdminMeta;
450
+ var modelDescriptionToAdminFields = function (description) {
451
+ var nestedFields = (0, exports.nestDottedFieldDescriptions)(description.fields);
452
+ return Object.fromEntries(Object.entries(nestedFields).map(function (_a) {
453
+ var _b = __read(_a, 2), path = _b[0], field = _b[1];
454
+ return [path, (0, exports.fieldDescriptionToAdminMeta)(field)];
455
+ }));
456
+ };
457
+ exports.modelDescriptionToAdminFields = modelDescriptionToAdminFields;
458
+ var fieldDescriptionToZodType = function (field, z) {
459
+ var _a;
460
+ var zodType;
461
+ if (field.isArray) {
462
+ var itemType = field.item
463
+ ? (0, exports.fieldDescriptionToZodType)(__assign(__assign({}, field.item), { isArray: false }), z)
464
+ : z.any();
465
+ zodType = z.array(itemType);
466
+ if (((_a = field.item) === null || _a === void 0 ? void 0 : _a.kind) === "embedded") {
467
+ zodType = zodType.describe("Array of subdocuments");
468
+ }
469
+ if (field.description) {
470
+ zodType = zodType.describe(field.description);
471
+ }
472
+ return zodType;
473
+ }
474
+ if (field.kind === "embedded" && field.fields) {
475
+ zodType = z.record(z.string(), z.any()).describe("Embedded document");
476
+ if (field.description) {
477
+ zodType = zodType.describe(field.description);
478
+ }
479
+ return zodType;
480
+ }
481
+ switch (field.kind) {
482
+ case "string":
483
+ zodType =
484
+ field.enum && field.enum.length > 0
485
+ ? z.enum(field.enum)
486
+ : z.string();
487
+ break;
488
+ case "number":
489
+ zodType = z.number();
490
+ break;
491
+ case "boolean":
492
+ zodType = z.boolean();
493
+ break;
494
+ case "date":
495
+ case "dateOnly":
496
+ zodType = z.string().describe("ISO 8601 date string");
497
+ break;
498
+ case "objectId":
499
+ zodType = z.string().describe(field.ref ? "ObjectId reference to ".concat(field.ref) : "ObjectId");
500
+ break;
501
+ case "map":
502
+ zodType = z.record(z.string(), z.any());
503
+ break;
504
+ default:
505
+ zodType = z.record(z.string(), z.any());
506
+ break;
507
+ }
508
+ if (field.description) {
509
+ zodType = zodType.describe(field.description);
510
+ }
511
+ return zodType;
512
+ };
513
+ exports.fieldDescriptionToZodType = fieldDescriptionToZodType;
@@ -0,0 +1,88 @@
1
+ import type { UserModel } from "./auth";
2
+ import { type BetterAuthInstance, syncBetterAuthUser } from "./betterAuthSetup";
3
+ import { type ScopedLogger } from "./logger";
4
+ export type SeedMode = "reset" | "sync";
5
+ export type SeedChange = "created" | "deleted" | "unchanged" | "updated";
6
+ interface SeedDocument {
7
+ get: (path: string) => unknown;
8
+ save: () => Promise<unknown>;
9
+ set: (pathOrValues: object, value?: unknown) => unknown;
10
+ }
11
+ /** The small structural subset of a Mongoose model used by seed helpers. */
12
+ export interface SeedModel {
13
+ new (): SeedDocument;
14
+ modelName: string;
15
+ countDocuments: (filter: Record<string, unknown>) => PromiseLike<number>;
16
+ deleteMany: (filter: Record<string, unknown>) => PromiseLike<unknown>;
17
+ find: (filter: Record<string, unknown>) => {
18
+ limit: (limit: number) => PromiseLike<SeedDocument[]>;
19
+ };
20
+ }
21
+ export interface SeedChangeResult {
22
+ change: SeedChange;
23
+ count: number;
24
+ key: string;
25
+ model: string;
26
+ }
27
+ export interface SeedContext {
28
+ dryRun: boolean;
29
+ mode: SeedMode;
30
+ changes: SeedChangeResult[];
31
+ deleteMany: (model: SeedModel, filter?: Record<string, unknown>) => Promise<SeedChangeResult>;
32
+ upsert: <TValues extends object>(model: SeedModel, key: Record<string, unknown>, values: TValues) => Promise<SeedChangeResult>;
33
+ }
34
+ export interface SeedStep {
35
+ name: string;
36
+ description?: string;
37
+ dependsOn?: string[];
38
+ reset?: (context: SeedContext) => Promise<void>;
39
+ run: (context: SeedContext) => Promise<void>;
40
+ }
41
+ export interface SeedRunOptions {
42
+ name: string;
43
+ steps: SeedStep[];
44
+ mode?: SeedMode;
45
+ dryRun?: boolean;
46
+ only?: string[];
47
+ force?: boolean;
48
+ allowProductionReset?: boolean | (() => boolean | Promise<boolean>);
49
+ connect?: () => Promise<void>;
50
+ disconnect?: () => Promise<void>;
51
+ log?: ScopedLogger;
52
+ }
53
+ export interface SeedRunResult {
54
+ changes: SeedChangeResult[];
55
+ dryRun: boolean;
56
+ mode: SeedMode;
57
+ name: string;
58
+ steps: string[];
59
+ summary: Record<SeedChange, number>;
60
+ success: boolean;
61
+ }
62
+ export interface SeedCliOptions extends Omit<SeedRunOptions, "dryRun" | "force" | "mode" | "only"> {
63
+ argv?: string[];
64
+ }
65
+ export interface SeedCliResult {
66
+ exitCode: number;
67
+ help?: string;
68
+ result?: SeedRunResult;
69
+ }
70
+ export interface BetterAuthSeedUser {
71
+ email: string;
72
+ name: string;
73
+ password: string;
74
+ }
75
+ /**
76
+ * Create a Better Auth credential user when missing, verify existing credentials,
77
+ * and reconcile the corresponding application user document.
78
+ */
79
+ export declare const seedBetterAuthUser: ({ auth, user, userModel, }: {
80
+ auth: BetterAuthInstance;
81
+ user: BetterAuthSeedUser;
82
+ userModel: UserModel;
83
+ }) => Promise<Awaited<ReturnType<typeof syncBetterAuthUser>>>;
84
+ /** Run an ordered, idempotent seed plan in sync or reset-and-reseed mode. */
85
+ export declare const runSeeds: (options: SeedRunOptions) => Promise<SeedRunResult>;
86
+ /** CLI adapter for runSeeds. It returns an exit code and never terminates the process. */
87
+ export declare const runSeedCli: (options: SeedCliOptions) => Promise<SeedCliResult>;
88
+ export {};