@directus/api 19.3.1 → 20.0.0-rc.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 (285) hide show
  1. package/dist/app.js +4 -4
  2. package/dist/auth/drivers/ldap.js +4 -4
  3. package/dist/auth/drivers/local.js +4 -4
  4. package/dist/auth/drivers/oauth2.js +4 -4
  5. package/dist/auth/drivers/openid.js +2 -4
  6. package/dist/cache.js +3 -0
  7. package/dist/cli/commands/bootstrap/index.js +8 -2
  8. package/dist/cli/commands/init/index.js +9 -10
  9. package/dist/cli/utils/defaults.d.ts +4 -11
  10. package/dist/cli/utils/defaults.js +7 -1
  11. package/dist/constants.d.ts +1 -1
  12. package/dist/controllers/access.d.ts +2 -0
  13. package/dist/controllers/access.js +148 -0
  14. package/dist/controllers/auth.js +5 -16
  15. package/dist/controllers/permissions.js +14 -2
  16. package/dist/controllers/policies.d.ts +2 -0
  17. package/dist/controllers/policies.js +169 -0
  18. package/dist/controllers/roles.js +22 -1
  19. package/dist/controllers/users.js +0 -55
  20. package/dist/database/errors/dialects/mysql.js +23 -23
  21. package/dist/database/get-ast-from-query/get-ast-from-query.d.ts +16 -0
  22. package/dist/database/get-ast-from-query/get-ast-from-query.js +82 -0
  23. package/dist/database/get-ast-from-query/lib/convert-wildcards.d.ts +13 -0
  24. package/dist/database/get-ast-from-query/lib/convert-wildcards.js +69 -0
  25. package/dist/database/get-ast-from-query/lib/parse-fields.d.ts +15 -0
  26. package/dist/database/get-ast-from-query/lib/parse-fields.js +190 -0
  27. package/dist/database/get-ast-from-query/utils/get-deep-query.d.ts +14 -0
  28. package/dist/database/get-ast-from-query/utils/get-deep-query.js +17 -0
  29. package/dist/database/get-ast-from-query/utils/get-related-collection.d.ts +2 -0
  30. package/dist/database/get-ast-from-query/utils/get-related-collection.js +13 -0
  31. package/dist/database/get-ast-from-query/utils/get-relation.d.ts +2 -0
  32. package/dist/database/get-ast-from-query/utils/get-relation.js +7 -0
  33. package/dist/database/helpers/fn/types.d.ts +2 -1
  34. package/dist/database/helpers/fn/types.js +1 -1
  35. package/dist/database/helpers/geometry/dialects/mssql.d.ts +1 -1
  36. package/dist/database/helpers/geometry/dialects/mssql.js +4 -2
  37. package/dist/database/helpers/geometry/dialects/mysql.js +1 -1
  38. package/dist/database/helpers/geometry/dialects/oracle.d.ts +1 -1
  39. package/dist/database/helpers/geometry/dialects/oracle.js +5 -3
  40. package/dist/database/helpers/geometry/types.d.ts +1 -1
  41. package/dist/database/helpers/geometry/types.js +4 -2
  42. package/dist/database/index.js +2 -1
  43. package/dist/database/migrations/20240619A-permissions-policies.d.ts +3 -0
  44. package/dist/database/migrations/20240619A-permissions-policies.js +163 -0
  45. package/dist/database/run-ast/lib/get-db-query.d.ts +4 -0
  46. package/dist/database/run-ast/lib/get-db-query.js +194 -0
  47. package/dist/database/run-ast/lib/parse-current-level.d.ts +7 -0
  48. package/dist/database/run-ast/lib/parse-current-level.js +41 -0
  49. package/dist/database/run-ast/run-ast.d.ts +7 -0
  50. package/dist/database/run-ast/run-ast.js +107 -0
  51. package/dist/database/{run-ast.d.ts → run-ast/types.d.ts} +3 -9
  52. package/dist/database/run-ast/types.js +1 -0
  53. package/dist/database/run-ast/utils/apply-case-when.d.ts +16 -0
  54. package/dist/database/run-ast/utils/apply-case-when.js +26 -0
  55. package/dist/database/run-ast/utils/apply-parent-filters.d.ts +3 -0
  56. package/dist/database/run-ast/utils/apply-parent-filters.js +55 -0
  57. package/dist/database/run-ast/utils/get-column-pre-processor.d.ts +10 -0
  58. package/dist/database/run-ast/utils/get-column-pre-processor.js +57 -0
  59. package/dist/database/run-ast/utils/get-field-alias.d.ts +2 -0
  60. package/dist/database/run-ast/utils/get-field-alias.js +4 -0
  61. package/dist/database/run-ast/utils/get-inner-query-column-pre-processor.d.ts +5 -0
  62. package/dist/database/run-ast/utils/get-inner-query-column-pre-processor.js +23 -0
  63. package/dist/database/run-ast/utils/merge-with-parent-items.d.ts +3 -0
  64. package/dist/database/run-ast/utils/merge-with-parent-items.js +87 -0
  65. package/dist/database/run-ast/utils/remove-temporary-fields.d.ts +3 -0
  66. package/dist/database/run-ast/utils/remove-temporary-fields.js +73 -0
  67. package/dist/extensions/lib/sandbox/generate-api-extensions-sandbox-entrypoint.d.ts +1 -1
  68. package/dist/flows.js +3 -4
  69. package/dist/middleware/authenticate.js +2 -7
  70. package/dist/middleware/cache.js +1 -1
  71. package/dist/middleware/cors.js +4 -4
  72. package/dist/middleware/respond.js +1 -1
  73. package/dist/permissions/cache.d.ts +2 -0
  74. package/dist/permissions/cache.js +23 -0
  75. package/dist/permissions/lib/fetch-permissions.d.ts +10 -0
  76. package/dist/permissions/lib/fetch-permissions.js +55 -0
  77. package/dist/permissions/lib/fetch-policies.d.ts +7 -0
  78. package/dist/permissions/lib/fetch-policies.js +28 -0
  79. package/dist/permissions/lib/fetch-roles-tree.d.ts +3 -0
  80. package/dist/permissions/lib/fetch-roles-tree.js +28 -0
  81. package/dist/{services/permissions → permissions}/lib/with-app-minimal-permissions.d.ts +1 -1
  82. package/dist/permissions/lib/with-app-minimal-permissions.js +10 -0
  83. package/dist/permissions/modules/fetch-accountability-collection-access/fetch-accountability-collection-access.d.ts +7 -0
  84. package/dist/permissions/modules/fetch-accountability-collection-access/fetch-accountability-collection-access.js +56 -0
  85. package/dist/permissions/modules/fetch-accountability-policy-globals/fetch-accountability-policy-globals.d.ts +3 -0
  86. package/dist/permissions/modules/fetch-accountability-policy-globals/fetch-accountability-policy-globals.js +16 -0
  87. package/dist/permissions/modules/fetch-allowed-collections/fetch-allowed-collections.d.ts +8 -0
  88. package/dist/permissions/modules/fetch-allowed-collections/fetch-allowed-collections.js +24 -0
  89. package/dist/permissions/modules/fetch-allowed-field-map/fetch-allowed-field-map.d.ts +9 -0
  90. package/dist/permissions/modules/fetch-allowed-field-map/fetch-allowed-field-map.js +31 -0
  91. package/dist/permissions/modules/fetch-allowed-fields/fetch-allowed-fields.d.ts +16 -0
  92. package/dist/permissions/modules/fetch-allowed-fields/fetch-allowed-fields.js +27 -0
  93. package/dist/permissions/modules/fetch-global-access/fetch-global-access.d.ts +10 -0
  94. package/dist/permissions/modules/fetch-global-access/fetch-global-access.js +23 -0
  95. package/dist/permissions/modules/fetch-global-access/lib/fetch-global-access-for-roles.d.ts +5 -0
  96. package/dist/permissions/modules/fetch-global-access/lib/fetch-global-access-for-roles.js +7 -0
  97. package/dist/permissions/modules/fetch-global-access/lib/fetch-global-access-for-user.d.ts +5 -0
  98. package/dist/permissions/modules/fetch-global-access/lib/fetch-global-access-for-user.js +10 -0
  99. package/dist/permissions/modules/fetch-global-access/types.d.ts +4 -0
  100. package/dist/permissions/modules/fetch-global-access/types.js +1 -0
  101. package/dist/permissions/modules/fetch-global-access/utils/fetch-global-access-for-query.d.ts +4 -0
  102. package/dist/permissions/modules/fetch-global-access/utils/fetch-global-access-for-query.js +27 -0
  103. package/dist/permissions/modules/fetch-inconsistent-field-map/fetch-inconsistent-field-map.d.ts +12 -0
  104. package/dist/permissions/modules/fetch-inconsistent-field-map/fetch-inconsistent-field-map.js +32 -0
  105. package/dist/permissions/modules/fetch-policies-ip-access/fetch-policies-ip-access.d.ts +4 -0
  106. package/dist/permissions/modules/fetch-policies-ip-access/fetch-policies-ip-access.js +29 -0
  107. package/dist/permissions/modules/process-ast/lib/extract-fields-from-children.d.ts +4 -0
  108. package/dist/permissions/modules/process-ast/lib/extract-fields-from-children.js +49 -0
  109. package/dist/permissions/modules/process-ast/lib/extract-fields-from-query.d.ts +3 -0
  110. package/dist/permissions/modules/process-ast/lib/extract-fields-from-query.js +56 -0
  111. package/dist/permissions/modules/process-ast/lib/field-map-from-ast.d.ts +4 -0
  112. package/dist/permissions/modules/process-ast/lib/field-map-from-ast.js +8 -0
  113. package/dist/permissions/modules/process-ast/lib/inject-cases.d.ts +9 -0
  114. package/dist/permissions/modules/process-ast/lib/inject-cases.js +93 -0
  115. package/dist/permissions/modules/process-ast/process-ast.d.ts +9 -0
  116. package/dist/permissions/modules/process-ast/process-ast.js +39 -0
  117. package/dist/permissions/modules/process-ast/types.d.ts +24 -0
  118. package/dist/permissions/modules/process-ast/types.js +1 -0
  119. package/dist/permissions/modules/process-ast/utils/collections-in-field-map.d.ts +2 -0
  120. package/dist/permissions/modules/process-ast/utils/collections-in-field-map.js +7 -0
  121. package/dist/permissions/modules/process-ast/utils/dedupe-access.d.ts +12 -0
  122. package/dist/permissions/modules/process-ast/utils/dedupe-access.js +30 -0
  123. package/dist/permissions/modules/process-ast/utils/extract-paths-from-query.d.ts +15 -0
  124. package/dist/permissions/modules/process-ast/utils/extract-paths-from-query.js +50 -0
  125. package/dist/permissions/modules/process-ast/utils/find-related-collection.d.ts +3 -0
  126. package/dist/permissions/modules/process-ast/utils/find-related-collection.js +9 -0
  127. package/dist/permissions/modules/process-ast/utils/flatten-filter.d.ts +3 -0
  128. package/dist/permissions/modules/process-ast/utils/flatten-filter.js +24 -0
  129. package/dist/permissions/modules/process-ast/utils/format-a2o-key.d.ts +1 -0
  130. package/dist/permissions/modules/process-ast/utils/format-a2o-key.js +3 -0
  131. package/dist/permissions/modules/process-ast/utils/get-info-for-path.d.ts +5 -0
  132. package/dist/permissions/modules/process-ast/utils/get-info-for-path.js +7 -0
  133. package/dist/permissions/modules/process-ast/utils/has-item-permissions.d.ts +2 -0
  134. package/dist/permissions/modules/process-ast/utils/has-item-permissions.js +3 -0
  135. package/dist/permissions/modules/process-ast/utils/stringify-query-path.d.ts +2 -0
  136. package/dist/permissions/modules/process-ast/utils/stringify-query-path.js +3 -0
  137. package/dist/permissions/modules/process-ast/utils/validate-path/create-error.d.ts +3 -0
  138. package/dist/permissions/modules/process-ast/utils/validate-path/create-error.js +16 -0
  139. package/dist/permissions/modules/process-ast/utils/validate-path/validate-path-existence.d.ts +2 -0
  140. package/dist/permissions/modules/process-ast/utils/validate-path/validate-path-existence.js +12 -0
  141. package/dist/permissions/modules/process-ast/utils/validate-path/validate-path-permissions.d.ts +2 -0
  142. package/dist/permissions/modules/process-ast/utils/validate-path/validate-path-permissions.js +28 -0
  143. package/dist/permissions/modules/process-payload/lib/is-field-nullable.d.ts +5 -0
  144. package/dist/permissions/modules/process-payload/lib/is-field-nullable.js +12 -0
  145. package/dist/permissions/modules/process-payload/process-payload.d.ts +13 -0
  146. package/dist/permissions/modules/process-payload/process-payload.js +77 -0
  147. package/dist/permissions/modules/validate-access/lib/validate-collection-access.d.ts +12 -0
  148. package/dist/permissions/modules/validate-access/lib/validate-collection-access.js +11 -0
  149. package/dist/permissions/modules/validate-access/lib/validate-item-access.d.ts +9 -0
  150. package/dist/permissions/modules/validate-access/lib/validate-item-access.js +33 -0
  151. package/dist/permissions/modules/validate-access/validate-access.d.ts +14 -0
  152. package/dist/permissions/modules/validate-access/validate-access.js +28 -0
  153. package/dist/permissions/modules/validate-remaining-admin/validate-remaining-admin-count.d.ts +1 -0
  154. package/dist/permissions/modules/validate-remaining-admin/validate-remaining-admin-count.js +8 -0
  155. package/dist/permissions/modules/validate-remaining-admin/validate-remaining-admin-users.d.ts +5 -0
  156. package/dist/permissions/modules/validate-remaining-admin/validate-remaining-admin-users.js +10 -0
  157. package/dist/permissions/types.d.ts +6 -0
  158. package/dist/permissions/types.js +1 -0
  159. package/dist/permissions/utils/create-default-accountability.d.ts +2 -0
  160. package/dist/permissions/utils/create-default-accountability.js +11 -0
  161. package/dist/permissions/utils/extract-required-dynamic-variable-context.d.ts +8 -0
  162. package/dist/permissions/utils/extract-required-dynamic-variable-context.js +27 -0
  163. package/dist/permissions/utils/fetch-dynamic-variable-context.d.ts +9 -0
  164. package/dist/permissions/utils/fetch-dynamic-variable-context.js +43 -0
  165. package/dist/permissions/utils/filter-policies-by-ip.d.ts +2 -0
  166. package/dist/permissions/utils/filter-policies-by-ip.js +15 -0
  167. package/dist/permissions/utils/get-unaliased-field-key.d.ts +5 -0
  168. package/dist/permissions/utils/get-unaliased-field-key.js +17 -0
  169. package/dist/permissions/utils/process-permissions.d.ts +7 -0
  170. package/dist/permissions/utils/process-permissions.js +9 -0
  171. package/dist/permissions/utils/with-cache.d.ts +10 -0
  172. package/dist/permissions/utils/with-cache.js +25 -0
  173. package/dist/services/access.d.ts +10 -0
  174. package/dist/services/access.js +43 -0
  175. package/dist/services/activity.js +22 -10
  176. package/dist/services/assets.d.ts +2 -3
  177. package/dist/services/assets.js +10 -5
  178. package/dist/services/authentication.js +18 -18
  179. package/dist/services/collections.js +18 -17
  180. package/dist/services/fields.d.ts +0 -1
  181. package/dist/services/fields.js +53 -24
  182. package/dist/services/files.d.ts +0 -4
  183. package/dist/services/files.js +10 -10
  184. package/dist/services/flows.d.ts +0 -2
  185. package/dist/services/flows.js +2 -14
  186. package/dist/services/graphql/index.d.ts +3 -3
  187. package/dist/services/graphql/index.js +126 -22
  188. package/dist/services/graphql/subscription.js +2 -4
  189. package/dist/services/import-export.js +23 -9
  190. package/dist/services/index.d.ts +3 -2
  191. package/dist/services/index.js +3 -2
  192. package/dist/services/items.d.ts +40 -14
  193. package/dist/services/items.js +182 -79
  194. package/dist/services/meta.js +60 -23
  195. package/dist/services/notifications.d.ts +0 -1
  196. package/dist/services/notifications.js +0 -7
  197. package/dist/services/operations.d.ts +0 -2
  198. package/dist/services/operations.js +2 -14
  199. package/dist/services/payload.d.ts +9 -10
  200. package/dist/services/payload.js +35 -19
  201. package/dist/services/{permissions/index.d.ts → permissions.d.ts} +5 -7
  202. package/dist/services/{permissions/index.js → permissions.js} +30 -54
  203. package/dist/services/policies.d.ts +12 -0
  204. package/dist/services/policies.js +87 -0
  205. package/dist/services/relations.d.ts +0 -6
  206. package/dist/services/relations.js +26 -29
  207. package/dist/services/roles.d.ts +4 -14
  208. package/dist/services/roles.js +56 -430
  209. package/dist/services/shares.d.ts +0 -2
  210. package/dist/services/shares.js +12 -8
  211. package/dist/services/specifications.d.ts +2 -2
  212. package/dist/services/specifications.js +39 -27
  213. package/dist/services/users.d.ts +2 -20
  214. package/dist/services/users.js +87 -192
  215. package/dist/services/utils.js +11 -7
  216. package/dist/services/versions.d.ts +0 -2
  217. package/dist/services/versions.js +34 -10
  218. package/dist/telemetry/lib/get-report.js +6 -3
  219. package/dist/telemetry/types/report.d.ts +4 -0
  220. package/dist/telemetry/utils/check-user-limits.d.ts +5 -0
  221. package/dist/telemetry/utils/check-user-limits.js +19 -0
  222. package/dist/telemetry/utils/get-filesize-sum.d.ts +5 -0
  223. package/dist/telemetry/utils/get-filesize-sum.js +7 -0
  224. package/dist/types/ast.d.ts +43 -1
  225. package/dist/types/items.d.ts +11 -0
  226. package/dist/utils/apply-query.d.ts +4 -3
  227. package/dist/utils/apply-query.js +37 -8
  228. package/dist/utils/fetch-user-count/fetch-access-lookup.d.ts +17 -0
  229. package/dist/utils/fetch-user-count/fetch-access-lookup.js +22 -0
  230. package/dist/utils/fetch-user-count/fetch-access-roles.d.ts +16 -0
  231. package/dist/utils/fetch-user-count/fetch-access-roles.js +37 -0
  232. package/dist/utils/fetch-user-count/fetch-active-users.d.ts +6 -0
  233. package/dist/utils/fetch-user-count/fetch-active-users.js +3 -0
  234. package/dist/utils/fetch-user-count/fetch-user-count.d.ts +12 -0
  235. package/dist/utils/fetch-user-count/fetch-user-count.js +57 -0
  236. package/dist/utils/fetch-user-count/get-user-count-query.d.ts +20 -0
  237. package/dist/utils/fetch-user-count/get-user-count-query.js +17 -0
  238. package/dist/utils/get-accountability-for-role.js +16 -25
  239. package/dist/utils/get-accountability-for-token.js +17 -16
  240. package/dist/utils/get-cache-key.d.ts +1 -1
  241. package/dist/utils/get-cache-key.js +12 -1
  242. package/dist/utils/get-column.d.ts +2 -1
  243. package/dist/utils/get-column.js +1 -0
  244. package/dist/utils/get-graphql-type.js +1 -0
  245. package/dist/utils/get-service.d.ts +1 -1
  246. package/dist/utils/get-service.js +14 -10
  247. package/dist/utils/reduce-schema.d.ts +4 -6
  248. package/dist/utils/reduce-schema.js +14 -34
  249. package/dist/utils/validate-user-count-integrity.d.ts +13 -0
  250. package/dist/utils/validate-user-count-integrity.js +29 -0
  251. package/dist/websocket/authenticate.d.ts +0 -2
  252. package/dist/websocket/authenticate.js +0 -12
  253. package/dist/websocket/controllers/graphql.js +1 -4
  254. package/dist/websocket/controllers/hooks.js +4 -0
  255. package/dist/websocket/controllers/rest.js +0 -2
  256. package/dist/websocket/handlers/subscribe.js +0 -2
  257. package/dist/websocket/utils/items.d.ts +1 -1
  258. package/dist/websocket/utils/items.js +4 -1
  259. package/package.json +31 -30
  260. package/dist/database/run-ast.js +0 -450
  261. package/dist/middleware/check-ip.d.ts +0 -2
  262. package/dist/middleware/check-ip.js +0 -37
  263. package/dist/middleware/get-permissions.d.ts +0 -3
  264. package/dist/middleware/get-permissions.js +0 -10
  265. package/dist/services/authorization.d.ts +0 -17
  266. package/dist/services/authorization.js +0 -456
  267. package/dist/services/permissions/lib/with-app-minimal-permissions.js +0 -13
  268. package/dist/telemetry/utils/check-increased-user-limits.d.ts +0 -7
  269. package/dist/telemetry/utils/check-increased-user-limits.js +0 -22
  270. package/dist/telemetry/utils/get-role-counts-by-roles.d.ts +0 -6
  271. package/dist/telemetry/utils/get-role-counts-by-roles.js +0 -27
  272. package/dist/telemetry/utils/get-role-counts-by-users.d.ts +0 -11
  273. package/dist/telemetry/utils/get-role-counts-by-users.js +0 -34
  274. package/dist/telemetry/utils/get-user-count.d.ts +0 -8
  275. package/dist/telemetry/utils/get-user-count.js +0 -33
  276. package/dist/telemetry/utils/get-user-counts-by-roles.d.ts +0 -7
  277. package/dist/telemetry/utils/get-user-counts-by-roles.js +0 -35
  278. package/dist/utils/get-ast-from-query.d.ts +0 -13
  279. package/dist/utils/get-ast-from-query.js +0 -297
  280. package/dist/utils/get-permissions.d.ts +0 -2
  281. package/dist/utils/get-permissions.js +0 -150
  282. package/dist/utils/merge-permissions-for-share.d.ts +0 -4
  283. package/dist/utils/merge-permissions-for-share.js +0 -109
  284. package/dist/utils/merge-permissions.d.ts +0 -3
  285. package/dist/utils/merge-permissions.js +0 -95
@@ -0,0 +1,27 @@
1
+ import { uniq } from 'lodash-es';
2
+ import { fetchPermissions } from '../../lib/fetch-permissions.js';
3
+ import { fetchPolicies } from '../../lib/fetch-policies.js';
4
+ import { withCache } from '../../utils/with-cache.js';
5
+ export const fetchAllowedFields = withCache('allowed-fields', _fetchAllowedFields, ({ action, collection, accountability: { user, role, roles, ip, app } }) => ({
6
+ action,
7
+ collection,
8
+ accountability: { user, role, roles, ip, app },
9
+ }));
10
+ /**
11
+ * Look up all fields that are allowed to be used for the given collection and action for the given
12
+ * accountability object
13
+ *
14
+ * Done by looking up all available policies for the current accountability object, and reading all
15
+ * permissions that exist for the collection+action+policy combination
16
+ */
17
+ export async function _fetchAllowedFields({ accountability, action, collection }, { knex, schema }) {
18
+ const policies = await fetchPolicies(accountability, { knex, schema });
19
+ const permissions = await fetchPermissions({ action, collections: [collection], policies, accountability }, { knex, schema });
20
+ const allowedFields = [];
21
+ for (const { fields } of permissions) {
22
+ if (!fields)
23
+ continue;
24
+ allowedFields.push(...fields);
25
+ }
26
+ return uniq(allowedFields).filter((field) => field === '*' || field in (schema.collections[collection]?.fields ?? {}));
27
+ }
@@ -0,0 +1,10 @@
1
+ import type { Accountability } from '@directus/types';
2
+ import type { Knex } from 'knex';
3
+ import type { GlobalAccess } from './types.js';
4
+ export declare const fetchGlobalAccess: typeof _fetchGlobalAccess;
5
+ /**
6
+ * Fetch the global access (eg admin/app access) rules for the given roles, or roles+user combination
7
+ *
8
+ * Will fetch roles and user info separately so they can be cached and reused individually
9
+ */
10
+ export declare function _fetchGlobalAccess(accountability: Pick<Accountability, 'user' | 'roles' | 'ip'>, knex: Knex): Promise<GlobalAccess>;
@@ -0,0 +1,23 @@
1
+ import { withCache } from '../../utils/with-cache.js';
2
+ import { fetchGlobalAccessForRoles } from './lib/fetch-global-access-for-roles.js';
3
+ import { fetchGlobalAccessForUser } from './lib/fetch-global-access-for-user.js';
4
+ export const fetchGlobalAccess = withCache('global-access', _fetchGlobalAccess, ({ user, roles, ip }) => ({
5
+ user,
6
+ roles,
7
+ ip,
8
+ }));
9
+ /**
10
+ * Fetch the global access (eg admin/app access) rules for the given roles, or roles+user combination
11
+ *
12
+ * Will fetch roles and user info separately so they can be cached and reused individually
13
+ */
14
+ export async function _fetchGlobalAccess(accountability, knex) {
15
+ const access = await fetchGlobalAccessForRoles(accountability, knex);
16
+ if (accountability.user !== undefined) {
17
+ const userAccess = await fetchGlobalAccessForUser(accountability, knex);
18
+ // If app/admin is already true, keep it true
19
+ access.app ||= userAccess.app;
20
+ access.admin ||= userAccess.admin;
21
+ }
22
+ return access;
23
+ }
@@ -0,0 +1,5 @@
1
+ import type { Accountability } from '@directus/types';
2
+ import type { Knex } from 'knex';
3
+ import type { GlobalAccess } from '../types.js';
4
+ export declare const fetchGlobalAccessForRoles: typeof _fetchGlobalAccessForRoles;
5
+ export declare function _fetchGlobalAccessForRoles(accountability: Pick<Accountability, 'roles' | 'ip'>, knex: Knex): Promise<GlobalAccess>;
@@ -0,0 +1,7 @@
1
+ import { withCache } from '../../../utils/with-cache.js';
2
+ import { fetchGlobalAccessForQuery } from '../utils/fetch-global-access-for-query.js';
3
+ export const fetchGlobalAccessForRoles = withCache('global-access-role', _fetchGlobalAccessForRoles, ({ roles, ip }) => ({ roles, ip }));
4
+ export async function _fetchGlobalAccessForRoles(accountability, knex) {
5
+ const query = knex.where('role', 'in', accountability.roles);
6
+ return await fetchGlobalAccessForQuery(query, accountability);
7
+ }
@@ -0,0 +1,5 @@
1
+ import type { Accountability } from '@directus/types';
2
+ import type { Knex } from 'knex';
3
+ import type { GlobalAccess } from '../types.js';
4
+ export declare const fetchGlobalAccessForUser: typeof _fetchGlobalAccessForUser;
5
+ export declare function _fetchGlobalAccessForUser(accountability: Pick<Accountability, 'user' | 'ip'>, knex: Knex): Promise<GlobalAccess>;
@@ -0,0 +1,10 @@
1
+ import { withCache } from '../../../utils/with-cache.js';
2
+ import { fetchGlobalAccessForQuery } from '../utils/fetch-global-access-for-query.js';
3
+ export const fetchGlobalAccessForUser = withCache('global-access-user', _fetchGlobalAccessForUser, ({ user, ip }) => ({
4
+ user,
5
+ ip,
6
+ }));
7
+ export async function _fetchGlobalAccessForUser(accountability, knex) {
8
+ const query = knex.where('user', '=', accountability.user);
9
+ return await fetchGlobalAccessForQuery(query, accountability);
10
+ }
@@ -0,0 +1,4 @@
1
+ export interface GlobalAccess {
2
+ app: boolean;
3
+ admin: boolean;
4
+ }
@@ -0,0 +1,4 @@
1
+ import type { Accountability } from '@directus/types';
2
+ import type { Knex } from 'knex';
3
+ import type { GlobalAccess } from '../types.js';
4
+ export declare function fetchGlobalAccessForQuery(query: Knex.QueryBuilder<any, any[]>, accountability: Pick<Accountability, 'ip'>): Promise<GlobalAccess>;
@@ -0,0 +1,27 @@
1
+ import { toBoolean, toArray } from '@directus/utils';
2
+ import { ipInNetworks } from '../../../../utils/ip-in-networks.js';
3
+ export async function fetchGlobalAccessForQuery(query, accountability) {
4
+ const globalAccess = {
5
+ app: false,
6
+ admin: false,
7
+ };
8
+ const accessRows = await query
9
+ .select('directus_policies.admin_access', 'directus_policies.app_access', 'directus_policies.ip_access')
10
+ .from('directus_access')
11
+ // @NOTE: `where` clause comes from the caller
12
+ .leftJoin('directus_policies', 'directus_policies.id', 'directus_access.policy');
13
+ // Additively merge access permissions
14
+ for (const { admin_access, app_access, ip_access } of accessRows) {
15
+ if (accountability.ip && ip_access) {
16
+ // Skip row if IP is not in the allowed networks
17
+ const networks = toArray(ip_access);
18
+ if (!ipInNetworks(accountability.ip, networks))
19
+ continue;
20
+ }
21
+ globalAccess.admin ||= toBoolean(admin_access);
22
+ globalAccess.app ||= globalAccess.admin || toBoolean(app_access);
23
+ if (globalAccess.admin)
24
+ break;
25
+ }
26
+ return globalAccess;
27
+ }
@@ -0,0 +1,12 @@
1
+ import type { Accountability, PermissionsAction } from '@directus/types';
2
+ import type { Context } from '../../types.js';
3
+ export type FieldMap = Record<string, string[]>;
4
+ export interface FetchInconsistentFieldMapOptions {
5
+ accountability: Pick<Accountability, 'user' | 'role' | 'roles' | 'ip' | 'admin' | 'app'> | null;
6
+ action: PermissionsAction;
7
+ }
8
+ /**
9
+ * Fetch a field map for fields that may or may not be null based on item-by-item permissions.
10
+ */
11
+ export declare const fetchInconsistentFieldMap: typeof _fetchInconsistentFieldMap;
12
+ export declare function _fetchInconsistentFieldMap({ accountability, action }: FetchInconsistentFieldMapOptions, { knex, schema }: Context): Promise<FieldMap>;
@@ -0,0 +1,32 @@
1
+ import { uniq, intersection, difference, pick } from 'lodash-es';
2
+ import { fetchPolicies } from '../../lib/fetch-policies.js';
3
+ import { withCache } from '../../utils/with-cache.js';
4
+ import { fetchPermissions } from '../../lib/fetch-permissions.js';
5
+ /**
6
+ * Fetch a field map for fields that may or may not be null based on item-by-item permissions.
7
+ */
8
+ export const fetchInconsistentFieldMap = withCache('inconsistent-field-map', _fetchInconsistentFieldMap, ({ action, accountability }) => ({
9
+ action,
10
+ accountability: accountability ? pick(accountability, ['user', 'role', 'roles', 'ip', 'admin', 'app']) : null,
11
+ }));
12
+ export async function _fetchInconsistentFieldMap({ accountability, action }, { knex, schema }) {
13
+ const fieldMap = {};
14
+ if (!accountability || accountability.admin) {
15
+ for (const collection of Object.keys(schema.collections)) {
16
+ fieldMap[collection] = [];
17
+ }
18
+ return fieldMap;
19
+ }
20
+ const policies = await fetchPolicies(accountability, { knex, schema });
21
+ const permissions = await fetchPermissions({ action, policies, accountability }, { knex, schema });
22
+ const collections = uniq(permissions.map(({ collection }) => collection));
23
+ for (const collection of collections) {
24
+ const fields = permissions
25
+ .filter((permission) => permission.collection === collection)
26
+ .map((permission) => permission.fields ?? []);
27
+ const availableEverywhere = intersection(...fields);
28
+ const availableSomewhere = difference(uniq(fields.flat()), availableEverywhere);
29
+ fieldMap[collection] = availableSomewhere;
30
+ }
31
+ return fieldMap;
32
+ }
@@ -0,0 +1,4 @@
1
+ import type { Accountability } from '@directus/types';
2
+ import type { Knex } from 'knex';
3
+ export declare const fetchPoliciesIpAccess: typeof _fetchPoliciesIpAccess;
4
+ export declare function _fetchPoliciesIpAccess(accountability: Pick<Accountability, 'user' | 'roles'>, knex: Knex): Promise<string[][]>;
@@ -0,0 +1,29 @@
1
+ import { toArray } from '@directus/utils';
2
+ import { withCache } from '../../utils/with-cache.js';
3
+ export const fetchPoliciesIpAccess = withCache('policies-ip-access', _fetchPoliciesIpAccess, ({ user, roles }) => ({
4
+ user,
5
+ roles,
6
+ }));
7
+ export async function _fetchPoliciesIpAccess(accountability, knex) {
8
+ const query = knex('directus_access')
9
+ .select({ ip_access: 'directus_policies.ip_access' })
10
+ .leftJoin('directus_policies', 'directus_access.policy', 'directus_policies.id')
11
+ .whereNotNull('directus_policies.ip_access');
12
+ // No roles and no user means unauthenticated request
13
+ if (accountability.roles.length === 0 && !accountability.user) {
14
+ query.where({
15
+ role: null,
16
+ user: null,
17
+ });
18
+ }
19
+ else {
20
+ query.where(function () {
21
+ if (accountability.user) {
22
+ this.orWhere('directus_access.user', accountability.user);
23
+ }
24
+ this.orWhereIn('directus_access.role', accountability.roles);
25
+ });
26
+ }
27
+ const rows = await query;
28
+ return rows.filter(({ ip_access }) => ip_access).map(({ ip_access }) => toArray(ip_access));
29
+ }
@@ -0,0 +1,4 @@
1
+ import type { SchemaOverview } from '@directus/types';
2
+ import type { FieldNode, FunctionFieldNode, NestedCollectionNode } from '../../../../types/ast.js';
3
+ import type { FieldMap, QueryPath } from '../types.js';
4
+ export declare function extractFieldsFromChildren(collection: string, children: (NestedCollectionNode | FieldNode | FunctionFieldNode)[], fieldMap: FieldMap, schema: SchemaOverview, path?: QueryPath): void;
@@ -0,0 +1,49 @@
1
+ import { getUnaliasedFieldKey } from '../../../utils/get-unaliased-field-key.js';
2
+ import { formatA2oKey } from '../utils/format-a2o-key.js';
3
+ import { getInfoForPath } from '../utils/get-info-for-path.js';
4
+ import { extractFieldsFromQuery } from './extract-fields-from-query.js';
5
+ export function extractFieldsFromChildren(collection, children, fieldMap, schema, path = []) {
6
+ const info = getInfoForPath(fieldMap, 'other', path, collection);
7
+ for (const child of children) {
8
+ info.fields.add(getUnaliasedFieldKey(child));
9
+ if (child.type === 'a2o') {
10
+ for (const [collection, children] of Object.entries(child.children)) {
11
+ extractFieldsFromChildren(collection, children, fieldMap, schema, [
12
+ ...path,
13
+ formatA2oKey(child.fieldKey, collection),
14
+ ]);
15
+ }
16
+ if (child.query) {
17
+ for (const [collection, query] of Object.entries(child.query)) {
18
+ extractFieldsFromQuery(collection, query, fieldMap, schema, [
19
+ ...path,
20
+ formatA2oKey(child.fieldKey, collection),
21
+ ]);
22
+ }
23
+ }
24
+ }
25
+ else if (child.type === 'm2o') {
26
+ extractFieldsFromChildren(child.relation.related_collection, child.children, fieldMap, schema, [
27
+ ...path,
28
+ child.fieldKey,
29
+ ]);
30
+ extractFieldsFromQuery(child.relation.related_collection, child.query, fieldMap, schema, [
31
+ ...path,
32
+ child.fieldKey,
33
+ ]);
34
+ }
35
+ else if (child.type === 'o2m') {
36
+ extractFieldsFromChildren(child.relation.collection, child.children, fieldMap, schema, [
37
+ ...path,
38
+ child.fieldKey,
39
+ ]);
40
+ extractFieldsFromQuery(child.relation.collection, child.query, fieldMap, schema, [...path, child.fieldKey]);
41
+ }
42
+ else if (child.type === 'functionField') {
43
+ // functionFields operate on a related o2m collection, we have to make sure we include a
44
+ // no-field read check to the related collection
45
+ extractFieldsFromChildren(child.relatedCollection, [], fieldMap, schema, [...path, child.fieldKey]);
46
+ extractFieldsFromQuery(child.relatedCollection, child.query, fieldMap, schema, [...path, child.fieldKey]);
47
+ }
48
+ }
49
+ }
@@ -0,0 +1,3 @@
1
+ import type { Query, SchemaOverview } from '@directus/types';
2
+ import type { CollectionKey, FieldKey, FieldMap } from '../types.js';
3
+ export declare function extractFieldsFromQuery(collection: CollectionKey, query: Query, fieldMap: FieldMap, schema: SchemaOverview, pathPrefix?: FieldKey[]): void;
@@ -0,0 +1,56 @@
1
+ import { parseFilterKey } from '../../../../utils/parse-filter-key.js';
2
+ import { extractPathsFromQuery } from '../utils/extract-paths-from-query.js';
3
+ import { findRelatedCollection } from '../utils/find-related-collection.js';
4
+ import { getInfoForPath } from '../utils/get-info-for-path.js';
5
+ export function extractFieldsFromQuery(collection, query, fieldMap, schema, pathPrefix = []) {
6
+ if (!query)
7
+ return;
8
+ const { paths: otherPaths, readOnlyPaths } = extractPathsFromQuery(query);
9
+ const groupedPaths = {
10
+ other: otherPaths,
11
+ read: readOnlyPaths,
12
+ };
13
+ for (const [group, paths] of Object.entries(groupedPaths)) {
14
+ for (const path of paths) {
15
+ /**
16
+ * Current path stack. For each iteration of the path loop this will be appended with the
17
+ * current part we're operating on. So when looping over ['category', 'created_by', 'name']
18
+ * the first iteration it'll be `['category']`, and then `['category', 'created_by']` etc.
19
+ */
20
+ const stack = [];
21
+ /**
22
+ * Current collection the path part we're operating on lives in. Once we hit a relational
23
+ * field, this will be updated to the related collection, so we can follow the relational path
24
+ * left to right.
25
+ */
26
+ let collectionContext = collection;
27
+ for (const part of path) {
28
+ const info = getInfoForPath(fieldMap, group, [...pathPrefix, ...stack], collectionContext);
29
+ // A2o specifier field fetch
30
+ if (part.includes(':')) {
31
+ const [fieldKey, collection] = part.split(':');
32
+ info.fields.add(fieldKey);
33
+ collectionContext = collection;
34
+ stack.push(part);
35
+ continue;
36
+ }
37
+ if (part.startsWith('$FOLLOW(') && part.endsWith(')')) {
38
+ // Don't add this implicit relation field to fields, as it will be accounted for in the reverse direction
39
+ }
40
+ else {
41
+ const { fieldName } = parseFilterKey(part);
42
+ info.fields.add(fieldName);
43
+ }
44
+ /**
45
+ * Related collection for the current part. Is null when the current field isn't a
46
+ * relational field.
47
+ */
48
+ const relatedCollection = findRelatedCollection(collectionContext, part, schema);
49
+ if (relatedCollection) {
50
+ collectionContext = relatedCollection;
51
+ stack.push(part);
52
+ }
53
+ }
54
+ }
55
+ }
56
+ }
@@ -0,0 +1,4 @@
1
+ import type { SchemaOverview } from '@directus/types';
2
+ import type { AST } from '../../../../types/ast.js';
3
+ import type { FieldMap } from '../types.js';
4
+ export declare function fieldMapFromAst(ast: AST, schema: SchemaOverview): FieldMap;
@@ -0,0 +1,8 @@
1
+ import { extractFieldsFromChildren } from './extract-fields-from-children.js';
2
+ import { extractFieldsFromQuery } from './extract-fields-from-query.js';
3
+ export function fieldMapFromAst(ast, schema) {
4
+ const fieldMap = { read: new Map(), other: new Map() };
5
+ extractFieldsFromChildren(ast.name, ast.children, fieldMap, schema);
6
+ extractFieldsFromQuery(ast.name, ast.query, fieldMap, schema);
7
+ return fieldMap;
8
+ }
@@ -0,0 +1,9 @@
1
+ import type { Permission } from '@directus/types';
2
+ import type { AST } from '../../../../types/ast.js';
3
+ /**
4
+ * Mutates passed AST
5
+ *
6
+ * @param ast - Read query AST
7
+ * @param permissions - Expected to be filtered down for the policies and action already
8
+ */
9
+ export declare function injectCases(ast: AST, permissions: Permission[]): void;
@@ -0,0 +1,93 @@
1
+ import { getUnaliasedFieldKey } from '../../../utils/get-unaliased-field-key.js';
2
+ import { dedupeAccess } from '../utils/dedupe-access.js';
3
+ import { hasItemPermissions } from '../utils/has-item-permissions.js';
4
+ import { uniq } from 'lodash-es';
5
+ /**
6
+ * Mutates passed AST
7
+ *
8
+ * @param ast - Read query AST
9
+ * @param permissions - Expected to be filtered down for the policies and action already
10
+ */
11
+ export function injectCases(ast, permissions) {
12
+ ast.cases = processChildren(ast.name, ast.children, permissions);
13
+ }
14
+ function processChildren(collection, children, permissions) {
15
+ // Use uniq here, since there might be multiple duplications due to aliases or functions
16
+ const requestedKeys = uniq(children.map(getUnaliasedFieldKey));
17
+ const { cases, caseMap, allowedFields } = getCases(collection, permissions, requestedKeys);
18
+ // TODO this can be optimized if there is only one rule to skip the whole case/where system,
19
+ // since fields that are not allowed at all are already filtered out
20
+ // TODO this can be optimized if all cases are the same for all requested keys, as those should be
21
+ //
22
+ for (const child of children) {
23
+ // If there's one or more permissions that allow full access to this field, we can safe some
24
+ // query perf overhead by ignoring the whole case/where system
25
+ const fieldKey = getUnaliasedFieldKey(child);
26
+ if (allowedFields.has('*') || allowedFields.has(fieldKey))
27
+ continue;
28
+ const globalWhenCase = caseMap['*'];
29
+ const fieldWhenCase = caseMap[fieldKey];
30
+ // Validation should catch any fields that are attempted to be read that don't have any access control configured.
31
+ // When there are no access rules for this field, and no rules for "all" fields `*`, we missed something in the validation
32
+ // and should abort.
33
+ if (!globalWhenCase && !fieldWhenCase) {
34
+ throw new Error(`Cannot extract access permissions for field "${fieldKey}" in collection "${collection}"`);
35
+ }
36
+ // Global and field can't both be undefined as per the error check prior
37
+ child.whenCase = [...(globalWhenCase ?? []), ...(fieldWhenCase ?? [])];
38
+ if (child.type === 'm2o') {
39
+ child.cases = processChildren(child.relation.related_collection, child.children, permissions);
40
+ }
41
+ if (child.type === 'o2m') {
42
+ child.cases = processChildren(child.relation.collection, child.children, permissions);
43
+ }
44
+ if (child.type === 'a2o') {
45
+ for (const collection of child.names) {
46
+ child.cases[collection] = processChildren(collection, child.children[collection] ?? [], permissions);
47
+ }
48
+ }
49
+ if (child.type === 'functionField') {
50
+ const { cases } = getCases(child.relatedCollection, permissions, []);
51
+ child.cases = cases;
52
+ }
53
+ }
54
+ return cases;
55
+ }
56
+ function getCases(collection, permissions, requestedKeys) {
57
+ const permissionsForCollection = permissions.filter((permission) => permission.collection === collection);
58
+ const rules = dedupeAccess(permissionsForCollection);
59
+ const cases = [];
60
+ const caseMap = {};
61
+ // TODO this can be optimized if there is only one rule to skip the whole case/where system,
62
+ // since fields that are not allowed at all are already filtered out
63
+ // TODO this can be optimized if all cases are the same for all requested keys, as those should be
64
+ //
65
+ let index = 0;
66
+ for (const { rule, fields } of rules) {
67
+ // If none of the fields in the current permissions rule overlap with the actually requested
68
+ // fields in the AST, we can ignore this case altogether
69
+ if (requestedKeys.length > 0 &&
70
+ fields.has('*') === false &&
71
+ Array.from(fields).every((field) => requestedKeys.includes(field) === false)) {
72
+ continue;
73
+ }
74
+ if (rule === null)
75
+ continue;
76
+ cases.push(rule);
77
+ for (const field of fields) {
78
+ caseMap[field] = [...(caseMap[field] ?? []), index];
79
+ }
80
+ index++;
81
+ }
82
+ // Field that are allowed no matter what conditions exist for the item. These come from
83
+ // permissions where the item read access is "everything"
84
+ const allowedFields = new Set(permissionsForCollection
85
+ .filter((permission) => hasItemPermissions(permission) === false)
86
+ .map((permission) => permission.fields ?? [])
87
+ .flat());
88
+ return {
89
+ cases,
90
+ caseMap,
91
+ allowedFields,
92
+ };
93
+ }
@@ -0,0 +1,9 @@
1
+ import type { Accountability, PermissionsAction } from '@directus/types';
2
+ import type { AST } from '../../../types/ast.js';
3
+ import type { Context } from '../../types.js';
4
+ export interface ProcessAstOptions {
5
+ ast: AST;
6
+ action: PermissionsAction;
7
+ accountability: Accountability | null;
8
+ }
9
+ export declare function processAst(options: ProcessAstOptions, context: Context): Promise<AST>;
@@ -0,0 +1,39 @@
1
+ import { fetchPermissions } from '../../lib/fetch-permissions.js';
2
+ import { fetchPolicies } from '../../lib/fetch-policies.js';
3
+ import { fieldMapFromAst } from './lib/field-map-from-ast.js';
4
+ import { injectCases } from './lib/inject-cases.js';
5
+ import { collectionsInFieldMap } from './utils/collections-in-field-map.js';
6
+ import { validatePathPermissions } from './utils/validate-path/validate-path-permissions.js';
7
+ import { validatePathExistence } from './utils/validate-path/validate-path-existence.js';
8
+ export async function processAst(options, context) {
9
+ // FieldMap is a Map of paths in the AST, with each path containing the collection and fields in
10
+ // that collection that the AST path tries to access
11
+ const fieldMap = fieldMapFromAst(options.ast, context.schema);
12
+ const collections = collectionsInFieldMap(fieldMap);
13
+ if (!options.accountability || options.accountability.admin) {
14
+ // Validate the field existence, even if no permissions apply to the current accountability
15
+ for (const [path, { collection, fields }] of [...fieldMap.read.entries(), ...fieldMap.other.entries()]) {
16
+ validatePathExistence(path, collection, fields, context.schema);
17
+ }
18
+ return options.ast;
19
+ }
20
+ const policies = await fetchPolicies(options.accountability, context);
21
+ const permissions = await fetchPermissions({ action: options.action, policies, collections, accountability: options.accountability }, context);
22
+ const readPermissions = options.action === 'read'
23
+ ? permissions
24
+ : await fetchPermissions({ action: 'read', policies, collections, accountability: options.accountability }, context);
25
+ // Validate field existence first
26
+ for (const [path, { collection, fields }] of [...fieldMap.read.entries(), ...fieldMap.other.entries()]) {
27
+ validatePathExistence(path, collection, fields, context.schema);
28
+ }
29
+ // Validate permissions for the fields
30
+ for (const [path, { collection, fields }] of fieldMap.other.entries()) {
31
+ validatePathPermissions(path, permissions, collection, fields);
32
+ }
33
+ // Validate permission for read only fields
34
+ for (const [path, { collection, fields }] of fieldMap.read.entries()) {
35
+ validatePathPermissions(path, readPermissions, collection, fields);
36
+ }
37
+ injectCases(options.ast, permissions);
38
+ return options.ast;
39
+ }
@@ -0,0 +1,24 @@
1
+ export type CollectionKey = string;
2
+ export type FieldKey = string;
3
+ export type QueryPath = string[];
4
+ /**
5
+ * Key is dot-notation QueryPath, f.e. `category.created_by`.
6
+ * Value contains collection context for that path, and fields fetched within
7
+ */
8
+ export type FieldMapEntries = Map<string, {
9
+ collection: CollectionKey;
10
+ fields: Set<FieldKey>;
11
+ }>;
12
+ /**
13
+ * FieldMapEntries that require only read permissions and those that require action specific permissions
14
+ */
15
+ export type FieldMap = {
16
+ read: FieldMapEntries;
17
+ other: FieldMapEntries;
18
+ };
19
+ export interface AccessRow {
20
+ policy: {
21
+ id: string;
22
+ ip_access: string[] | null;
23
+ };
24
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,2 @@
1
+ import type { CollectionKey, FieldMap } from '../types.js';
2
+ export declare function collectionsInFieldMap(fieldMap: FieldMap): CollectionKey[];
@@ -0,0 +1,7 @@
1
+ export function collectionsInFieldMap(fieldMap) {
2
+ const collections = new Set();
3
+ for (const { collection } of [...fieldMap.other.values(), ...fieldMap.read.values()]) {
4
+ collections.add(collection);
5
+ }
6
+ return Array.from(collections);
7
+ }
@@ -0,0 +1,12 @@
1
+ import type { Filter, Permission } from '@directus/types';
2
+ /**
3
+ * Deduplicate the permissions sets by merging the field sets based on the access control rules
4
+ * (`permissions` in Permission rows)
5
+ *
6
+ * This allows the cases injection to be more efficient by not having to generate duplicate
7
+ * case/when clauses for permission sets where the rule access is identical
8
+ */
9
+ export declare function dedupeAccess(permissions: Permission[]): {
10
+ rule: Filter;
11
+ fields: Set<string>;
12
+ }[];
@@ -0,0 +1,30 @@
1
+ import hash from 'object-hash';
2
+ /**
3
+ * Deduplicate the permissions sets by merging the field sets based on the access control rules
4
+ * (`permissions` in Permission rows)
5
+ *
6
+ * This allows the cases injection to be more efficient by not having to generate duplicate
7
+ * case/when clauses for permission sets where the rule access is identical
8
+ */
9
+ export function dedupeAccess(permissions) {
10
+ // Map of `ruleHash: fields[]`
11
+ const map = new Map();
12
+ for (const permission of permissions) {
13
+ const rule = permission.permissions ?? {};
14
+ // Two JS objects can't be equality checked. Object-hash will resort any nested arrays
15
+ // deterministically meaning that this can be used to compare two rule sets where the array
16
+ // order does not matter
17
+ const ruleHash = hash(rule, {
18
+ algorithm: 'passthrough',
19
+ unorderedArrays: true,
20
+ });
21
+ if (map.has(ruleHash) === false) {
22
+ map.set(ruleHash, { rule, fields: new Set() });
23
+ }
24
+ const info = map.get(ruleHash);
25
+ for (const field of permission.fields ?? []) {
26
+ info.fields.add(field);
27
+ }
28
+ }
29
+ return Array.from(map.values());
30
+ }
@@ -0,0 +1,15 @@
1
+ import type { Query } from '@directus/types';
2
+ /**
3
+ * Converts the passed Query object into a unique list of path arrays, for example:
4
+ *
5
+ * ```
6
+ * [
7
+ * ['author', 'age'],
8
+ * ['category']
9
+ * ]
10
+ * ```
11
+ */
12
+ export declare function extractPathsFromQuery(query: Query): {
13
+ paths: string[][];
14
+ readOnlyPaths: string[][];
15
+ };