@imolko/ultra-ddd 3.0.1-beta → 3.1.0-beta

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 (99) hide show
  1. package/dist-browser/authorization/errors/authorization.error.d.ts +21 -7
  2. package/dist-browser/authorization/errors/authorization.error.d.ts.map +1 -1
  3. package/dist-browser/authorization/errors/authorization.error.js +26 -7
  4. package/dist-browser/authorization/errors/authorization.error.js.map +1 -1
  5. package/dist-browser/authorization/index.d.ts +1 -0
  6. package/dist-browser/authorization/index.d.ts.map +1 -1
  7. package/dist-browser/authorization/index.js +1 -0
  8. package/dist-browser/authorization/index.js.map +1 -1
  9. package/dist-browser/authorization/ports/authorization.port.d.ts +14 -3
  10. package/dist-browser/authorization/ports/authorization.port.d.ts.map +1 -1
  11. package/dist-browser/authorization/ports/authorization.port.js.map +1 -1
  12. package/dist-browser/authorization/resource-scope/conditions.d.ts +26 -0
  13. package/dist-browser/authorization/resource-scope/conditions.d.ts.map +1 -0
  14. package/dist-browser/authorization/resource-scope/conditions.js +27 -0
  15. package/dist-browser/authorization/resource-scope/conditions.js.map +1 -0
  16. package/dist-browser/authorization/resource-scope/definition.d.ts +23 -0
  17. package/dist-browser/authorization/resource-scope/definition.d.ts.map +1 -0
  18. package/dist-browser/authorization/resource-scope/definition.js +34 -0
  19. package/dist-browser/authorization/resource-scope/definition.js.map +1 -0
  20. package/dist-browser/authorization/resource-scope/errors.d.ts +3 -0
  21. package/dist-browser/authorization/resource-scope/errors.d.ts.map +1 -0
  22. package/dist-browser/authorization/resource-scope/errors.js +2 -0
  23. package/dist-browser/authorization/resource-scope/errors.js.map +1 -0
  24. package/dist-browser/authorization/resource-scope/index.d.ts +5 -0
  25. package/dist-browser/authorization/resource-scope/index.d.ts.map +1 -0
  26. package/dist-browser/authorization/resource-scope/index.js +2 -0
  27. package/dist-browser/authorization/resource-scope/index.js.map +1 -0
  28. package/dist-browser/authorization/resource-scope/payload.d.ts +4 -0
  29. package/dist-browser/authorization/resource-scope/payload.d.ts.map +1 -0
  30. package/dist-browser/authorization/resource-scope/payload.js +2 -0
  31. package/dist-browser/authorization/resource-scope/payload.js.map +1 -0
  32. package/dist-browser/authorization/resource-scope/primitive.d.ts +2 -0
  33. package/dist-browser/authorization/resource-scope/primitive.d.ts.map +1 -0
  34. package/dist-browser/authorization/resource-scope/primitive.js +2 -0
  35. package/dist-browser/authorization/resource-scope/primitive.js.map +1 -0
  36. package/dist-browser/authorization/resource-scope/props.d.ts +7 -0
  37. package/dist-browser/authorization/resource-scope/props.d.ts.map +1 -0
  38. package/dist-browser/authorization/resource-scope/props.js +2 -0
  39. package/dist-browser/authorization/resource-scope/props.js.map +1 -0
  40. package/dist-browser/authorization/resource-scope/value-object.d.ts +102 -0
  41. package/dist-browser/authorization/resource-scope/value-object.d.ts.map +1 -0
  42. package/dist-browser/authorization/resource-scope/value-object.js +17 -0
  43. package/dist-browser/authorization/resource-scope/value-object.js.map +1 -0
  44. package/dist-browser/authorization/secured-use-case/secured-use-case.mixin.d.ts +6 -4
  45. package/dist-browser/authorization/secured-use-case/secured-use-case.mixin.d.ts.map +1 -1
  46. package/dist-browser/authorization/secured-use-case/secured-use-case.mixin.js +93 -11
  47. package/dist-browser/authorization/secured-use-case/secured-use-case.mixin.js.map +1 -1
  48. package/dist-browser/authorization/secured-use-case/secured-use-case.types.d.ts +28 -0
  49. package/dist-browser/authorization/secured-use-case/secured-use-case.types.d.ts.map +1 -1
  50. package/dist-node/authorization/errors/authorization.error.d.ts +21 -7
  51. package/dist-node/authorization/errors/authorization.error.d.ts.map +1 -1
  52. package/dist-node/authorization/errors/authorization.error.js +26 -7
  53. package/dist-node/authorization/errors/authorization.error.js.map +1 -1
  54. package/dist-node/authorization/index.d.ts +1 -0
  55. package/dist-node/authorization/index.d.ts.map +1 -1
  56. package/dist-node/authorization/index.js +1 -0
  57. package/dist-node/authorization/index.js.map +1 -1
  58. package/dist-node/authorization/ports/authorization.port.d.ts +14 -3
  59. package/dist-node/authorization/ports/authorization.port.d.ts.map +1 -1
  60. package/dist-node/authorization/ports/authorization.port.js.map +1 -1
  61. package/dist-node/authorization/resource-scope/conditions.d.ts +26 -0
  62. package/dist-node/authorization/resource-scope/conditions.d.ts.map +1 -0
  63. package/dist-node/authorization/resource-scope/conditions.js +30 -0
  64. package/dist-node/authorization/resource-scope/conditions.js.map +1 -0
  65. package/dist-node/authorization/resource-scope/definition.d.ts +23 -0
  66. package/dist-node/authorization/resource-scope/definition.d.ts.map +1 -0
  67. package/dist-node/authorization/resource-scope/definition.js +37 -0
  68. package/dist-node/authorization/resource-scope/definition.js.map +1 -0
  69. package/dist-node/authorization/resource-scope/errors.d.ts +3 -0
  70. package/dist-node/authorization/resource-scope/errors.d.ts.map +1 -0
  71. package/dist-node/authorization/resource-scope/errors.js +3 -0
  72. package/dist-node/authorization/resource-scope/errors.js.map +1 -0
  73. package/dist-node/authorization/resource-scope/index.d.ts +5 -0
  74. package/dist-node/authorization/resource-scope/index.d.ts.map +1 -0
  75. package/dist-node/authorization/resource-scope/index.js +6 -0
  76. package/dist-node/authorization/resource-scope/index.js.map +1 -0
  77. package/dist-node/authorization/resource-scope/payload.d.ts +4 -0
  78. package/dist-node/authorization/resource-scope/payload.d.ts.map +1 -0
  79. package/dist-node/authorization/resource-scope/payload.js +3 -0
  80. package/dist-node/authorization/resource-scope/payload.js.map +1 -0
  81. package/dist-node/authorization/resource-scope/primitive.d.ts +2 -0
  82. package/dist-node/authorization/resource-scope/primitive.d.ts.map +1 -0
  83. package/dist-node/authorization/resource-scope/primitive.js +3 -0
  84. package/dist-node/authorization/resource-scope/primitive.js.map +1 -0
  85. package/dist-node/authorization/resource-scope/props.d.ts +7 -0
  86. package/dist-node/authorization/resource-scope/props.d.ts.map +1 -0
  87. package/dist-node/authorization/resource-scope/props.js +3 -0
  88. package/dist-node/authorization/resource-scope/props.js.map +1 -0
  89. package/dist-node/authorization/resource-scope/value-object.d.ts +102 -0
  90. package/dist-node/authorization/resource-scope/value-object.d.ts.map +1 -0
  91. package/dist-node/authorization/resource-scope/value-object.js +20 -0
  92. package/dist-node/authorization/resource-scope/value-object.js.map +1 -0
  93. package/dist-node/authorization/secured-use-case/secured-use-case.mixin.d.ts +6 -4
  94. package/dist-node/authorization/secured-use-case/secured-use-case.mixin.d.ts.map +1 -1
  95. package/dist-node/authorization/secured-use-case/secured-use-case.mixin.js +93 -11
  96. package/dist-node/authorization/secured-use-case/secured-use-case.mixin.js.map +1 -1
  97. package/dist-node/authorization/secured-use-case/secured-use-case.types.d.ts +28 -0
  98. package/dist-node/authorization/secured-use-case/secured-use-case.types.d.ts.map +1 -1
  99. package/package.json +1 -1
@@ -2,6 +2,7 @@
2
2
  import { fail } from '@imolko/ultra-result';
3
3
  import { AuthorizationError } from '../errors';
4
4
  import { Permission } from '../permission';
5
+ import { ResourceScope } from '../resource-scope';
5
6
  import { Security } from '../security';
6
7
  /**
7
8
  * Lectura fail-closed de la seguridad declarada.
@@ -28,22 +29,87 @@ const readSecurity = (security) => {
28
29
  : [];
29
30
  return { mode: candidate?.mode, permissions, trusted: false };
30
31
  };
32
+ /**
33
+ * Indica si un valor se comporta como promesa.
34
+ *
35
+ * @param value Valor devuelto por el resolutor
36
+ * @returns `true` si expone un `then` invocable
37
+ */
38
+ const isThenable = (value) => typeof value === 'object' &&
39
+ value !== null &&
40
+ typeof value.then === 'function';
41
+ /**
42
+ * Consume una promesa devuelta por el resolutor para que su rechazo no quede
43
+ * huérfano y tumbe el proceso del consumidor.
44
+ *
45
+ * @param value Promesa que se descarta
46
+ */
47
+ const discard = (value) => {
48
+ Promise.resolve(value).catch(() => undefined);
49
+ };
50
+ /**
51
+ * Resuelve los alcances declarados por el caso de uso.
52
+ *
53
+ * La resolución es fail-closed: un resolutor no invocable, una excepción, o
54
+ * un retorno que no sea una lista no vacía de `ResourceScope` produce `null`,
55
+ * que el enforcement traduce a denegación. No se interpreta el contenido de
56
+ * los alcances.
57
+ *
58
+ * El resolutor es síncrono por contrato: una promesa se deniega y su rechazo
59
+ * se consume, para que un `securityScope` declarado `async` desde JavaScript
60
+ * no deje un rechazo no gestionado.
61
+ *
62
+ * @param resolver Estático `securityScope` de la definición
63
+ * @param request Petición del caso de uso
64
+ * @returns Los alcances resueltos, o `null` si la resolución no es confiable
65
+ */
66
+ const resolveScopes = (resolver, request) => {
67
+ if (typeof resolver !== 'function') {
68
+ return null;
69
+ }
70
+ try {
71
+ const resolved = resolver(request);
72
+ if (isThenable(resolved)) {
73
+ discard(resolved);
74
+ return null;
75
+ }
76
+ if (!Array.isArray(resolved) || resolved.length === 0) {
77
+ return null;
78
+ }
79
+ if (!resolved.every((scope) => scope instanceof ResourceScope)) {
80
+ return null;
81
+ }
82
+ return resolved;
83
+ }
84
+ catch {
85
+ return null;
86
+ }
87
+ };
31
88
  /**
32
89
  * Aplica el enforcement fail-closed y devuelve la primera denegación.
33
90
  *
91
+ * Precedencia de fallos: sujeto ausente, `security` no validada, resolución
92
+ * de alcances y decisión por permiso.
93
+ *
34
94
  * Reglas:
35
95
  * - autenticación requerida sin sujeto deniega sin consultar el puerto;
36
96
  * - cualquier modo distinto de `optional` sin sujeto deniega;
37
97
  * - permisos declarados sin sujeto deniegan;
38
98
  * - una `security` no validada deniega;
99
+ * - `securityScope` se resuelve una vez, antes de la primera llamada al
100
+ * puerto, y sólo si hay permisos que autorizar;
101
+ * - un `securityScope` declarado que no devuelve alcances, lanza, devuelve
102
+ * valores no validados, no es invocable o devuelve una promesa deniega;
103
+ * - sin `securityScope`, se autoriza contra `(subject, permission)` como en
104
+ * 3.0.0;
39
105
  * - el primer `denied` del puerto detiene la evaluación;
40
106
  * - `optional` sin permisos ejecuta aunque no haya sujeto.
41
107
  *
42
- * @param security Seguridad declarada por el caso de uso
43
- * @param context Sujeto y puerto de autorización
108
+ * @param query Seguridad, contexto, petición y resolutor de alcances
44
109
  * @returns La denegación o `null` si el caso de uso puede ejecutarse
45
110
  */
46
- const findDenial = async (security, context) => {
111
+ const findDenial = async (query) => {
112
+ const { security, context, request, securityScope } = query;
47
113
  const { subject, authorizationPort } = context;
48
114
  const { mode, permissions, trusted } = readSecurity(security);
49
115
  if (!subject) {
@@ -53,10 +119,19 @@ const findDenial = async (security, context) => {
53
119
  if (!trusted) {
54
120
  return new AuthorizationError(subject, null);
55
121
  }
122
+ const hasSecurityScope = securityScope !== undefined;
123
+ const scopes = hasSecurityScope && permissions.length > 0
124
+ ? resolveScopes(securityScope, request)
125
+ : null;
126
+ if (hasSecurityScope && permissions.length > 0 && scopes === null) {
127
+ return new AuthorizationError(subject, permissions[0]);
128
+ }
56
129
  for (const permission of permissions) {
57
- const decision = await authorizationPort.authorize(subject, permission);
130
+ const decision = scopes === null
131
+ ? await authorizationPort.authorize(subject, permission)
132
+ : await authorizationPort.authorize(subject, permission, scopes);
58
133
  if (decision !== 'granted') {
59
- return AuthorizationError.denied(subject, permission);
134
+ return AuthorizationError.denied(subject, permission, scopes);
60
135
  }
61
136
  }
62
137
  return null;
@@ -64,10 +139,12 @@ const findDenial = async (security, context) => {
64
139
  /**
65
140
  * Mixin de caso de uso seguro.
66
141
  *
67
- * Exige `security` en el tipo de la definición, expone `run` como único camino
68
- * público y oculta `execute` en el tipo (no en el runtime). `run` aplica el
69
- * enforcement fail-closed y preserva el canal del caso de uso, uniendo
70
- * `AuthorizationError` a su tipo de error sin anidar resultados.
142
+ * Exige `security` en el tipo de la definición, acepta `securityScope` como
143
+ * estático opcional para resolver los alcances del recurso a partir de la
144
+ * petición, expone `run` como único camino público y oculta `execute` en el
145
+ * tipo (no en el runtime). `run` aplica el enforcement fail-closed y preserva
146
+ * el canal del caso de uso, uniendo `AuthorizationError` a su tipo de error sin
147
+ * anidar resultados.
71
148
  *
72
149
  * @param Source Definición del caso de uso con `security` y `execute`
73
150
  * @returns Constructor cuyo tipo público sólo ofrece `run`
@@ -83,8 +160,13 @@ export const SecuredUseCase = (Source) => {
83
160
  */
84
161
  run(request, context) {
85
162
  const runSecured = async () => {
86
- const security = this.constructor.security;
87
- const denial = await findDenial(security, context);
163
+ const source = this.constructor;
164
+ const denial = await findDenial({
165
+ security: source.security,
166
+ context,
167
+ request,
168
+ securityScope: source.securityScope,
169
+ });
88
170
  if (denial) {
89
171
  return fail(denial);
90
172
  }
@@ -1 +1 @@
1
- {"version":3,"file":"secured-use-case.mixin.js","sourceRoot":"","sources":["../../../src/authorization/secured-use-case/secured-use-case.mixin.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"secured-use-case.mixin.js","sourceRoot":"","sources":["../../../src/authorization/secured-use-case/secured-use-case.mixin.ts"],"names":[],"mappings":"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"}
@@ -3,6 +3,7 @@ import { Identifiable, SubjectId } from '../../entity/identity';
3
3
  import { AuthenticatedSubject } from '../authenticated-subject';
4
4
  import { AuthorizationError } from '../errors';
5
5
  import { AuthorizationPort } from '../ports';
6
+ import { ResourceScope } from '../resource-scope';
6
7
  import { Security } from '../security';
7
8
  /**
8
9
  * Contexto que recibe `run` con el sujeto ya autenticado por el transporte.
@@ -18,11 +19,34 @@ export interface SecuredUseCaseContext<Id extends Identifiable = SubjectId> {
18
19
  /** Puerto que decide sobre los permisos declarados */
19
20
  authorizationPort: AuthorizationPort<Id>;
20
21
  }
22
+ /**
23
+ * Resolución de los alcances del recurso a partir de la petición.
24
+ *
25
+ * Es **pura y síncrona** por contrato: sin E/S, sin reloj y sin acceso al
26
+ * sujeto autenticado. Sólo transforma la petición en los recursos sobre los que
27
+ * el caso de uso pide sus permisos. Lo que requiera consultar (por ejemplo, la
28
+ * pertenencia del sujeto a una marca) es trabajo del `AuthorizationPort`, que
29
+ * ya puede ser asíncrono.
30
+ *
31
+ * Devolver `undefined` o una lista vacía se trata como denegación: declarar el
32
+ * resolutor hace obligatorio el alcance en toda llamada que autorice permisos.
33
+ * Devolver una promesa también deniega —la resolución no se espera— y su
34
+ * rechazo se consume para que un resolutor declarado `async` desde JavaScript
35
+ * no deje un rechazo no gestionado.
36
+ *
37
+ * @template Request Tipo de la petición del caso de uso
38
+ */
39
+ export type SecurityScopeResolver<Request = unknown> = (request: Request) => readonly ResourceScope[] | undefined;
21
40
  /**
22
41
  * Forma estática mínima de una definición de caso de uso seguro.
23
42
  *
24
43
  * Exige `security` y que `execute` devuelva un `TaskExecution`. La definición
25
44
  * conserva su canal de resultado; el mixin sólo lo ensancha en el lado de error.
45
+ *
46
+ * `securityScope` es opcional y su tipo es permisivo a propósito: ligar el
47
+ * `request` del resolutor al de `execute` exigiría volver genérica la
48
+ * definición. El consumidor tiene comprobación real declarando el estático con
49
+ * `SecurityScopeResolver<Request>`.
26
50
  */
27
51
  export interface SecuredUseCaseDefinition {
28
52
  new (...args: any[]): {
@@ -30,6 +54,8 @@ export interface SecuredUseCaseDefinition {
30
54
  };
31
55
  /** Modo de autenticación y permisos que exige el caso de uso */
32
56
  security: Security;
57
+ /** Resolución opcional de los alcances del recurso que se autoriza */
58
+ securityScope?: SecurityScopeResolver<any>;
33
59
  }
34
60
  /** Firma de `execute` en la definición concreta. */
35
61
  type ExecuteOf<Definition extends SecuredUseCaseDefinition> = InstanceType<Definition>['execute'];
@@ -66,6 +92,8 @@ export type SecuredUseCaseConstructor<Definition extends SecuredUseCaseDefinitio
66
92
  new (...args: any[]): SecuredUseCaseInstance<Definition>;
67
93
  /** Seguridad declarada por la definición, visible en el tipo */
68
94
  security: Security;
95
+ /** Resolución opcional de alcances declarada por la definición */
96
+ securityScope?: SecurityScopeResolver<any>;
69
97
  };
70
98
  export {};
71
99
  //# sourceMappingURL=secured-use-case.types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"secured-use-case.types.d.ts","sourceRoot":"","sources":["../../../src/authorization/secured-use-case/secured-use-case.types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB,CAAC,EAAE,SAAS,YAAY,GAAG,SAAS;IACxE,uEAAuE;IACvE,OAAO,CAAC,EAAE,oBAAoB,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IAC1C,sDAAsD;IACtD,iBAAiB,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC;CAC1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG;QACpB,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;KAClD,CAAC;IACF,gEAAgE;IAChE,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,oDAAoD;AACpD,KAAK,SAAS,CAAC,UAAU,SAAS,wBAAwB,IACxD,YAAY,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC;AAEtC,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,CAAC,UAAU,SAAS,wBAAwB,IACtE,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,MAAM,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC,GAC/D,OAAO,GACP,SAAS,CAAC;AAEhB,uCAAuC;AACvC,MAAM,MAAM,eAAe,CAAC,UAAU,SAAS,wBAAwB,IACrE,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,SAAS,aAAa,CAAC,MAAM,MAAM,EAAE,GAAG,CAAC,GACtE,MAAM,GACN,KAAK,CAAC;AAEZ,8BAA8B;AAC9B,MAAM,MAAM,eAAe,CAAC,UAAU,SAAS,wBAAwB,IACrE,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,SAAS,aAAa,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC,GACtE,MAAM,GACN,KAAK,CAAC;AAEZ;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,UAAU,SAAS,wBAAwB,IACxE,aAAa,CACX,eAAe,CAAC,UAAU,CAAC,GAAG,kBAAkB,EAChD,eAAe,CAAC,UAAU,CAAC,CAC5B,CAAC;AAEJ;;;;GAIG;AACH,MAAM,WAAW,sBAAsB,CACrC,UAAU,SAAS,wBAAwB;IAE3C;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,SAAS,YAAY,EACzB,OAAO,EAAE,gBAAgB,CAAC,UAAU,CAAC,EACrC,OAAO,EAAE,qBAAqB,CAAC,EAAE,CAAC,GACjC,kBAAkB,CAAC,UAAU,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,MAAM,yBAAyB,CACnC,UAAU,SAAS,wBAAwB,IACzC;IACF,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IACzD,gEAAgE;IAChE,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC"}
1
+ {"version":3,"file":"secured-use-case.types.d.ts","sourceRoot":"","sources":["../../../src/authorization/secured-use-case/secured-use-case.types.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,6 @@
1
1
  import { DomainBaseError } from '../../domain-base-error';
2
2
  import { PermissionPrimitive } from '../permission';
3
+ import { ResourceScope } from '../resource-scope';
3
4
  /** Primitiva de la identidad de un sujeto autenticado. */
4
5
  export type AuthorizationSubjectId = string | number;
5
6
  /**
@@ -20,21 +21,27 @@ export type AuthorizationPermissionLike = PermissionPrimitive | HasPrimitive<Per
20
21
  * Datos extendidos del error de autorización.
21
22
  *
22
23
  * `subjectId` es `null` cuando la denegación ocurre por ausencia de sujeto;
23
- * `permission` es `null` cuando no se llegó a evaluar un permiso concreto.
24
+ * `permission` es `null` cuando no se llegó a evaluar un permiso concreto;
25
+ * `scopes` es `null` cuando la denegación ocurrió antes de que el puerto
26
+ * viera alcances resueltos, y la copia de sus primitivas cuando el puerto
27
+ * denegó con alcances presentados.
24
28
  */
25
29
  export type AuthorizationErrorData = {
26
30
  /** Identidad del sujeto autenticado, o `null` si no hay sujeto. */
27
31
  subjectId: AuthorizationSubjectId | null;
28
32
  /** Permiso evaluado, o `null` si la denegación fue por autenticación. */
29
33
  permission: PermissionPrimitive | null;
34
+ /** Primitivas de los alcances presentados al puerto, o `null`. */
35
+ scopes: string[] | null;
30
36
  };
31
37
  /**
32
38
  * Error de dominio de autorización.
33
39
  *
34
40
  * Viaja por el canal de error del caso de uso seguro cuando el enforcement
35
- * deniega: sujeto ausente cuando se requiere, o el puerto de autorización
36
- * devuelve `denied`. Lleva la identidad del sujeto y el permiso evaluado.
37
- * La traducción a `403` queda en la capa de aplicación.
41
+ * deniega: sujeto ausente cuando se requiere, `security` o `securityScope` no
42
+ * validados, o el puerto de autorización devuelve `denied`. Lleva la identidad
43
+ * del sujeto, el permiso evaluado y, cuando el puerto vio alcances, sus
44
+ * primitivas. La traducción a `403` queda en la capa de aplicación.
38
45
  */
39
46
  export declare class AuthorizationError extends DomainBaseError<AuthorizationErrorData> {
40
47
  /** Identidad estable del error para los traductores de la app. */
@@ -45,7 +52,12 @@ export declare class AuthorizationError extends DomainBaseError<AuthorizationErr
45
52
  readonly subjectId: AuthorizationSubjectId | null;
46
53
  /** Permiso evaluado, o `null` si la denegación fue por autenticación. */
47
54
  readonly permission: PermissionPrimitive | null;
48
- constructor(subjectId: AuthorizationSubjectIdLike, permission: AuthorizationPermissionLike);
55
+ /**
56
+ * Primitivas de los alcances presentados al puerto, o `null` cuando la
57
+ * denegación ocurrió antes de que el puerto los viera.
58
+ */
59
+ readonly scopes: string[] | null;
60
+ constructor(subjectId: AuthorizationSubjectIdLike, permission: AuthorizationPermissionLike, scopes?: readonly ResourceScope[] | null);
49
61
  /**
50
62
  * Construye el error de autenticación requerida sin sujeto.
51
63
  *
@@ -61,8 +73,10 @@ export declare class AuthorizationError extends DomainBaseError<AuthorizationErr
61
73
  *
62
74
  * @param subject Sujeto autenticado al que se le denegó el permiso
63
75
  * @param permission Permiso denegado
64
- * @returns Error de autorización con la identidad y el permiso
76
+ * @param scopes Alcances presentados al puerto, o `null` si el puerto no los
77
+ * vio
78
+ * @returns Error de autorización con la identidad, el permiso y los alcances
65
79
  */
66
- static denied(subject: HasPrimitive<AuthorizationSubjectId>, permission: HasPrimitive<PermissionPrimitive>): AuthorizationError;
80
+ static denied(subject: HasPrimitive<AuthorizationSubjectId>, permission: HasPrimitive<PermissionPrimitive>, scopes?: readonly ResourceScope[] | null): AuthorizationError;
67
81
  }
68
82
  //# sourceMappingURL=authorization.error.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"authorization.error.d.ts","sourceRoot":"","sources":["../../../src/authorization/errors/authorization.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,0DAA0D;AAC1D,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY,CAAC,SAAS;IACrC,YAAY,IAAI,SAAS,CAAC;CAC3B;AAED,oEAAoE;AACpE,MAAM,MAAM,0BAA0B,GAClC,sBAAsB,GACtB,YAAY,CAAC,sBAAsB,CAAC,GACpC,IAAI,CAAC;AAET,8DAA8D;AAC9D,MAAM,MAAM,2BAA2B,GACnC,mBAAmB,GACnB,YAAY,CAAC,mBAAmB,CAAC,GACjC,IAAI,CAAC;AAoBT;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,mEAAmE;IACnE,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACzC,yEAAyE;IACzE,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACxC,CAAC;AAsBF;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,eAAe,CAAC,sBAAsB,CAAC;IAC7E,kEAAkE;IAClE,gBAAuB,UAAU,yBAAyB;IAE1D,+DAA+D;IAC/D,gBAAuB,IAAI,yBAAiC;IAE5D,mEAAmE;IACnE,SAAgB,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAEzD,yEAAyE;IACzE,SAAgB,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;gBAGrD,SAAS,EAAE,0BAA0B,EACrC,UAAU,EAAE,2BAA2B;IAezC;;;;;;;;OAQG;WACW,cAAc,IAAI,kBAAkB;IAIlD;;;;;;OAMG;WACW,MAAM,CAClB,OAAO,EAAE,YAAY,CAAC,sBAAsB,CAAC,EAC7C,UAAU,EAAE,YAAY,CAAC,mBAAmB,CAAC,GAC5C,kBAAkB;CAGtB"}
1
+ {"version":3,"file":"authorization.error.d.ts","sourceRoot":"","sources":["../../../src/authorization/errors/authorization.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,0DAA0D;AAC1D,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY,CAAC,SAAS;IACrC,YAAY,IAAI,SAAS,CAAC;CAC3B;AAED,oEAAoE;AACpE,MAAM,MAAM,0BAA0B,GAClC,sBAAsB,GACtB,YAAY,CAAC,sBAAsB,CAAC,GACpC,IAAI,CAAC;AAET,8DAA8D;AAC9D,MAAM,MAAM,2BAA2B,GACnC,mBAAmB,GACnB,YAAY,CAAC,mBAAmB,CAAC,GACjC,IAAI,CAAC;AAoCT;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,mEAAmE;IACnE,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACzC,yEAAyE;IACzE,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACvC,kEAAkE;IAClE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACzB,CAAC;AAsBF;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,eAAe,CAAC,sBAAsB,CAAC;IAC7E,kEAAkE;IAClE,gBAAuB,UAAU,yBAAyB;IAE1D,+DAA+D;IAC/D,gBAAuB,IAAI,yBAAiC;IAE5D,mEAAmE;IACnE,SAAgB,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAEzD,yEAAyE;IACzE,SAAgB,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAEvD;;;OAGG;IACH,SAAgB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;gBAGtC,SAAS,EAAE,0BAA0B,EACrC,UAAU,EAAE,2BAA2B,EACvC,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI;IAkB1C;;;;;;;;OAQG;WACW,cAAc,IAAI,kBAAkB;IAIlD;;;;;;;;OAQG;WACW,MAAM,CAClB,OAAO,EAAE,YAAY,CAAC,sBAAsB,CAAC,EAC7C,UAAU,EAAE,YAAY,CAAC,mBAAmB,CAAC,EAC7C,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI,GACvC,kBAAkB;CAGtB"}
@@ -17,6 +17,19 @@ const toPrimitive = (value) => {
17
17
  }
18
18
  return value;
19
19
  };
20
+ /**
21
+ * Normaliza los alcances presentados al puerto a sus primitivas.
22
+ *
23
+ * @param scopes Alcances resueltos, o `null` cuando la denegación ocurrió
24
+ * antes de que el puerto viera alcances
25
+ * @returns Copia de las primitivas, o `null`
26
+ */
27
+ const toScopePrimitives = (scopes) => {
28
+ if (scopes === null || scopes === undefined) {
29
+ return null;
30
+ }
31
+ return scopes.map((scope) => scope.getPrimitive());
32
+ };
20
33
  /**
21
34
  * Construye el detalle legible de la denegación.
22
35
  *
@@ -37,22 +50,26 @@ const buildDetail = (subjectId, permission) => {
37
50
  * Error de dominio de autorización.
38
51
  *
39
52
  * Viaja por el canal de error del caso de uso seguro cuando el enforcement
40
- * deniega: sujeto ausente cuando se requiere, o el puerto de autorización
41
- * devuelve `denied`. Lleva la identidad del sujeto y el permiso evaluado.
42
- * La traducción a `403` queda en la capa de aplicación.
53
+ * deniega: sujeto ausente cuando se requiere, `security` o `securityScope` no
54
+ * validados, o el puerto de autorización devuelve `denied`. Lleva la identidad
55
+ * del sujeto, el permiso evaluado y, cuando el puerto vio alcances, sus
56
+ * primitivas. La traducción a `403` queda en la capa de aplicación.
43
57
  */
44
58
  class AuthorizationError extends domain_base_error_1.DomainBaseError {
45
- constructor(subjectId, permission) {
59
+ constructor(subjectId, permission, scopes) {
46
60
  const normalizedSubjectId = toPrimitive(subjectId);
47
61
  const normalizedPermission = toPrimitive(permission);
62
+ const normalizedScopes = toScopePrimitives(scopes);
48
63
  const title = 'Authorization error';
49
64
  const detail = buildDetail(normalizedSubjectId, normalizedPermission);
50
65
  super('authorization', AuthorizationError.IDENTIFIER, detail, title, {
51
66
  subjectId: normalizedSubjectId,
52
67
  permission: normalizedPermission,
68
+ scopes: normalizedScopes,
53
69
  });
54
70
  this.subjectId = normalizedSubjectId;
55
71
  this.permission = normalizedPermission;
72
+ this.scopes = normalizedScopes;
56
73
  }
57
74
  /**
58
75
  * Construye el error de autenticación requerida sin sujeto.
@@ -71,10 +88,12 @@ class AuthorizationError extends domain_base_error_1.DomainBaseError {
71
88
  *
72
89
  * @param subject Sujeto autenticado al que se le denegó el permiso
73
90
  * @param permission Permiso denegado
74
- * @returns Error de autorización con la identidad y el permiso
91
+ * @param scopes Alcances presentados al puerto, o `null` si el puerto no los
92
+ * vio
93
+ * @returns Error de autorización con la identidad, el permiso y los alcances
75
94
  */
76
- static denied(subject, permission) {
77
- return new AuthorizationError(subject, permission);
95
+ static denied(subject, permission, scopes) {
96
+ return new AuthorizationError(subject, permission, scopes);
78
97
  }
79
98
  }
80
99
  exports.AuthorizationError = AuthorizationError;
@@ -1 +1 @@
1
- {"version":3,"file":"authorization.error.js","sourceRoot":"","sources":["../../../src/authorization/errors/authorization.error.ts"],"names":[],"mappings":";;;AAAA,+DAA0D;AA6B1D;;;;;GAKG;AACH,MAAM,WAAW,GAAG,CAClB,KAAiD,EAC/B,EAAE;IACpB,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAQ,KAAiC,CAAC,YAAY,EAAE,CAAC;IAC3D,CAAC;IACD,OAAO,KAAkB,CAAC;AAC5B,CAAC,CAAC;AAeF;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,CAClB,SAAwC,EACxC,UAAsC,EAC9B,EAAE;IACV,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,2DAA2D,CAAC;IACrE,CAAC;IACD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,YAAY,SAAS,qBAAqB,CAAC;IACpD,CAAC;IACD,OAAO,YAAY,SAAS,uCAAuC,UAAU,GAAG,CAAC;AACnF,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAa,kBAAmB,SAAQ,mCAAuC;IAa7E,YACE,SAAqC,EACrC,UAAuC;QAEvC,MAAM,mBAAmB,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QACnD,MAAM,oBAAoB,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,qBAAqB,CAAC;QACpC,MAAM,MAAM,GAAG,WAAW,CAAC,mBAAmB,EAAE,oBAAoB,CAAC,CAAC;QACtE,KAAK,CAAC,eAAe,EAAE,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE;YACnE,SAAS,EAAE,mBAAmB;YAC9B,UAAU,EAAE,oBAAoB;SACjC,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,mBAAmB,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,oBAAoB,CAAC;IACzC,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,cAAc;QAC1B,OAAO,IAAI,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAClB,OAA6C,EAC7C,UAA6C;QAE7C,OAAO,IAAI,kBAAkB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACrD,CAAC;;AAvDH,gDAwDC;AAvDC,kEAAkE;AAC3C,6BAAU,GAAG,qBAAqB,CAAC;AAE1D,+DAA+D;AACxC,uBAAI,GAAG,kBAAkB,CAAC,UAAU,CAAC"}
1
+ {"version":3,"file":"authorization.error.js","sourceRoot":"","sources":["../../../src/authorization/errors/authorization.error.ts"],"names":[],"mappings":";;;AAAA,+DAA0D;AA8B1D;;;;;GAKG;AACH,MAAM,WAAW,GAAG,CAClB,KAAiD,EAC/B,EAAE;IACpB,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAQ,KAAiC,CAAC,YAAY,EAAE,CAAC;IAC3D,CAAC;IACD,OAAO,KAAkB,CAAC;AAC5B,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,iBAAiB,GAAG,CACxB,MAAmD,EAClC,EAAE;IACnB,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;AACrD,CAAC,CAAC;AAoBF;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,CAClB,SAAwC,EACxC,UAAsC,EAC9B,EAAE;IACV,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,2DAA2D,CAAC;IACrE,CAAC;IACD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,YAAY,SAAS,qBAAqB,CAAC;IACpD,CAAC;IACD,OAAO,YAAY,SAAS,uCAAuC,UAAU,GAAG,CAAC;AACnF,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAa,kBAAmB,SAAQ,mCAAuC;IAmB7E,YACE,SAAqC,EACrC,UAAuC,EACvC,MAAwC;QAExC,MAAM,mBAAmB,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QACnD,MAAM,oBAAoB,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,qBAAqB,CAAC;QACpC,MAAM,MAAM,GAAG,WAAW,CAAC,mBAAmB,EAAE,oBAAoB,CAAC,CAAC;QACtE,KAAK,CAAC,eAAe,EAAE,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE;YACnE,SAAS,EAAE,mBAAmB;YAC9B,UAAU,EAAE,oBAAoB;YAChC,MAAM,EAAE,gBAAgB;SACzB,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,mBAAmB,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,oBAAoB,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,gBAAgB,CAAC;IACjC,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,cAAc;QAC1B,OAAO,IAAI,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,MAAM,CAClB,OAA6C,EAC7C,UAA6C,EAC7C,MAAwC;QAExC,OAAO,IAAI,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;;AApEH,gDAqEC;AApEC,kEAAkE;AAC3C,6BAAU,GAAG,qBAAqB,CAAC;AAE1D,+DAA+D;AACxC,uBAAI,GAAG,kBAAkB,CAAC,UAAU,CAAC"}
@@ -2,6 +2,7 @@ export * from './authenticated-subject';
2
2
  export * from './errors';
3
3
  export * from './permission';
4
4
  export * from './ports';
5
+ export * from './resource-scope';
5
6
  export * from './secured-use-case';
6
7
  export * from './security';
7
8
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/authorization/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/authorization/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}
@@ -18,6 +18,7 @@ __exportStar(require("./authenticated-subject"), exports);
18
18
  __exportStar(require("./errors"), exports);
19
19
  __exportStar(require("./permission"), exports);
20
20
  __exportStar(require("./ports"), exports);
21
+ __exportStar(require("./resource-scope"), exports);
21
22
  __exportStar(require("./secured-use-case"), exports);
22
23
  __exportStar(require("./security"), exports);
23
24
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/authorization/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,2CAAyB;AACzB,+CAA6B;AAC7B,0CAAwB;AACxB,qDAAmC;AACnC,6CAA2B"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/authorization/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,2CAAyB;AACzB,+CAA6B;AAC7B,0CAAwB;AACxB,mDAAiC;AACjC,qDAAmC;AACnC,6CAA2B"}
@@ -1,6 +1,7 @@
1
1
  import { Identifiable, SubjectId } from '../../entity/identity';
2
2
  import { AuthenticatedSubject } from '../authenticated-subject';
3
3
  import { Permission } from '../permission';
4
+ import { ResourceScope } from '../resource-scope';
4
5
  /**
5
6
  * Decisiones que puede devolver un puerto de autorización.
6
7
  *
@@ -14,8 +15,13 @@ export type AuthorizationDecision = (typeof AUTHORIZATION_DECISIONS)[number];
14
15
  * Puerto genérico de autorización del caso de uso seguro.
15
16
  *
16
17
  * Es independiente de la tecnología y del modelo de autorización (RBAC, ABAC,
17
- * ReBAC, PDP): recibe el sujeto autenticado y el permiso exigido, y decide.
18
- * El adaptador concreto vive en la aplicación.
18
+ * ReBAC, PDP): recibe el sujeto autenticado, el permiso exigido y, cuando el
19
+ * caso de uso lo declara, los alcances del recurso sobre el que se pide el
20
+ * permiso, y decide.
21
+ *
22
+ * Los alcances son opcionales y **no interpretados** por la librería: decide el
23
+ * adaptador si la concesión exige alguno de ellos, todos o una combinación del
24
+ * modelo del consumidor. El adaptador concreto vive en la aplicación.
19
25
  *
20
26
  * @template Id Tipo de identidad del sujeto
21
27
  */
@@ -23,10 +29,15 @@ export interface AuthorizationPort<Id extends Identifiable = SubjectId> {
23
29
  /**
24
30
  * Decide si el sujeto tiene el permiso indicado.
25
31
  *
32
+ * El tercer parámetro es opcional: una implementación escrita contra 3.0.0
33
+ * (dos parámetros) sigue satisfaciendo esta interfaz sin cambios.
34
+ *
26
35
  * @param subject Sujeto ya autenticado
27
36
  * @param permission Permiso exigido por el caso de uso
37
+ * @param scopes Alcances del recurso resueltos por el caso de uso, o
38
+ * ausentes cuando el caso de uso no declara `securityScope`
28
39
  * @returns `granted` si autoriza; `denied` si deniega
29
40
  */
30
- authorize(subject: AuthenticatedSubject<Id>, permission: Permission): AuthorizationDecision | Promise<AuthorizationDecision>;
41
+ authorize(subject: AuthenticatedSubject<Id>, permission: Permission, scopes?: readonly ResourceScope[]): AuthorizationDecision | Promise<AuthorizationDecision>;
31
42
  }
32
43
  //# sourceMappingURL=authorization.port.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"authorization.port.d.ts","sourceRoot":"","sources":["../../../src/authorization/ports/authorization.port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,gCAAiC,CAAC;AAEtE,0DAA0D;AAC1D,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7E;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB,CAAC,EAAE,SAAS,YAAY,GAAG,SAAS;IACpE;;;;;;OAMG;IACH,SAAS,CACP,OAAO,EAAE,oBAAoB,CAAC,EAAE,CAAC,EACjC,UAAU,EAAE,UAAU,GACrB,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC3D"}
1
+ {"version":3,"file":"authorization.port.d.ts","sourceRoot":"","sources":["../../../src/authorization/ports/authorization.port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,gCAAiC,CAAC;AAEtE,0DAA0D;AAC1D,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7E;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,iBAAiB,CAAC,EAAE,SAAS,YAAY,GAAG,SAAS;IACpE;;;;;;;;;;;OAWG;IACH,SAAS,CACP,OAAO,EAAE,oBAAoB,CAAC,EAAE,CAAC,EACjC,UAAU,EAAE,UAAU,EACtB,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,GAChC,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC3D"}
@@ -1 +1 @@
1
- {"version":3,"file":"authorization.port.js","sourceRoot":"","sources":["../../../src/authorization/ports/authorization.port.ts"],"names":[],"mappings":";;;AAIA;;;;;GAKG;AACU,QAAA,uBAAuB,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAC"}
1
+ {"version":3,"file":"authorization.port.js","sourceRoot":"","sources":["../../../src/authorization/ports/authorization.port.ts"],"names":[],"mappings":";;;AAKA;;;;;GAKG;AACU,QAAA,uBAAuB,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAC"}
@@ -0,0 +1,26 @@
1
+ import { z } from '@imolko/ultra-v8n';
2
+ /**
3
+ * Longitud máxima de un alcance de recurso.
4
+ *
5
+ * Es la única fuente de la longitud: `PATTERN` y el mensaje de error se
6
+ * derivan de aquí. La cota vive en el patrón y no en un `.max()` para que el
7
+ * vocabulario de errores del seam se quede en `InvalidTypeError` e
8
+ * `InvalidStringError`.
9
+ */
10
+ export declare const MAX_LENGTH = 128;
11
+ /**
12
+ * Gramática de un alcance de recurso.
13
+ *
14
+ * Es el conjunto `unreserved` de RFC 3986 (`A-Z a-z 0-9 - . _ ~`) más `/`,
15
+ * con primer carácter alfanumérico y longitud máxima de `MAX_LENGTH`. Excluir
16
+ * `:` es deliberado: un `Permission` válido (`<contexto>:<acción>`) nunca es
17
+ * un alcance válido. Todo valor admitido es un `scope-token` legal de OAuth
18
+ * 2.0.
19
+ */
20
+ export declare const PATTERN: RegExp;
21
+ /** Mensaje de error para un alcance de recurso fuera de la gramática. */
22
+ export declare const PATTERN_ERROR = "Resource scope must start with an alphanumeric character and contain only letters, digits, \".\", \"_\", \"~\", \"/\" or \"-\" (1-128 characters, no \":\")";
23
+ export declare const conditions: z.ZodPipe<z.ZodString, z.ZodTransform<{
24
+ value: string;
25
+ }, string>>;
26
+ //# sourceMappingURL=conditions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../../src/authorization/resource-scope/conditions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAEtC;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,QAEnB,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,aAAa,gKAA8J,CAAC;AAEzL,eAAO,MAAM,UAAU;;WAGa,CAAC"}
@@ -0,0 +1,30 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.conditions = exports.PATTERN_ERROR = exports.PATTERN = exports.MAX_LENGTH = void 0;
4
+ const ultra_v8n_1 = require("@imolko/ultra-v8n");
5
+ /**
6
+ * Longitud máxima de un alcance de recurso.
7
+ *
8
+ * Es la única fuente de la longitud: `PATTERN` y el mensaje de error se
9
+ * derivan de aquí. La cota vive en el patrón y no en un `.max()` para que el
10
+ * vocabulario de errores del seam se quede en `InvalidTypeError` e
11
+ * `InvalidStringError`.
12
+ */
13
+ exports.MAX_LENGTH = 128;
14
+ /**
15
+ * Gramática de un alcance de recurso.
16
+ *
17
+ * Es el conjunto `unreserved` de RFC 3986 (`A-Z a-z 0-9 - . _ ~`) más `/`,
18
+ * con primer carácter alfanumérico y longitud máxima de `MAX_LENGTH`. Excluir
19
+ * `:` es deliberado: un `Permission` válido (`<contexto>:<acción>`) nunca es
20
+ * un alcance válido. Todo valor admitido es un `scope-token` legal de OAuth
21
+ * 2.0.
22
+ */
23
+ exports.PATTERN = new RegExp(`^[A-Za-z0-9][A-Za-z0-9._~/-]{0,${exports.MAX_LENGTH - 1}}$`);
24
+ /** Mensaje de error para un alcance de recurso fuera de la gramática. */
25
+ exports.PATTERN_ERROR = `Resource scope must start with an alphanumeric character and contain only letters, digits, ".", "_", "~", "/" or "-" (1-${exports.MAX_LENGTH} characters, no ":")`;
26
+ exports.conditions = ultra_v8n_1.z
27
+ .string()
28
+ .regex(exports.PATTERN, { error: exports.PATTERN_ERROR })
29
+ .transform((value) => ({ value }));
30
+ //# sourceMappingURL=conditions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"conditions.js","sourceRoot":"","sources":["../../../src/authorization/resource-scope/conditions.ts"],"names":[],"mappings":";;;AAAA,iDAAsC;AAEtC;;;;;;;GAOG;AACU,QAAA,UAAU,GAAG,GAAG,CAAC;AAE9B;;;;;;;;GAQG;AACU,QAAA,OAAO,GAAG,IAAI,MAAM,CAC/B,kCAAkC,kBAAU,GAAG,CAAC,IAAI,CACrD,CAAC;AAEF,yEAAyE;AAC5D,QAAA,aAAa,GAAG,2HAA2H,kBAAU,sBAAsB,CAAC;AAE5K,QAAA,UAAU,GAAG,aAAC;KACxB,MAAM,EAAE;KACR,KAAK,CAAC,eAAO,EAAE,EAAE,KAAK,EAAE,qBAAa,EAAE,CAAC;KACxC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC"}
@@ -0,0 +1,23 @@
1
+ import { ZodType } from '@imolko/ultra-v8n';
2
+ import { ValueObjectBase } from '../../value-object';
3
+ import { Payload } from './payload';
4
+ import { Primitive } from './primitive';
5
+ import { Props } from './props';
6
+ export declare class Definition extends ValueObjectBase<Props, Primitive, Payload> {
7
+ /**
8
+ * Miembros estáticos
9
+ */
10
+ static readonly NAME = "resource-scope";
11
+ static readonly conditions: ZodType<Props, Payload>;
12
+ /**
13
+ * Devuelve las propiedades serializadas para exponer en la aplicación
14
+ * @returns {Primitive}
15
+ */
16
+ getPrimitive(): Primitive;
17
+ /**
18
+ * Devuelve las propiedades serializadas que permiten la reconstrucción
19
+ * @returns {Payload}
20
+ */
21
+ getPayload(): Payload;
22
+ }
23
+ //# sourceMappingURL=definition.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/authorization/resource-scope/definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAgB,MAAM,oBAAoB,CAAC;AAEnE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,qBACa,UAAW,SAAQ,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC;IACxE;;OAEG;IACH,gBAAuB,IAAI,oBAAoB;IAC/C,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAc;IACjE;;;OAGG;IACI,YAAY,IAAI,SAAS;IAGhC;;;OAGG;IACI,UAAU,IAAI,OAAO;CAG7B"}
@@ -0,0 +1,37 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ Object.defineProperty(exports, "__esModule", { value: true });
9
+ exports.Definition = void 0;
10
+ const value_object_1 = require("../../value-object");
11
+ const conditions_1 = require("./conditions");
12
+ let Definition = class Definition extends value_object_1.ValueObjectBase {
13
+ /**
14
+ * Devuelve las propiedades serializadas para exponer en la aplicación
15
+ * @returns {Primitive}
16
+ */
17
+ getPrimitive() {
18
+ return this.props.value;
19
+ }
20
+ /**
21
+ * Devuelve las propiedades serializadas que permiten la reconstrucción
22
+ * @returns {Payload}
23
+ */
24
+ getPayload() {
25
+ return this.props.value;
26
+ }
27
+ };
28
+ exports.Definition = Definition;
29
+ /**
30
+ * Miembros estáticos
31
+ */
32
+ Definition.NAME = 'resource-scope';
33
+ Definition.conditions = conditions_1.conditions;
34
+ exports.Definition = Definition = __decorate([
35
+ (0, value_object_1.isVOComplete)()
36
+ ], Definition);
37
+ //# sourceMappingURL=definition.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../src/authorization/resource-scope/definition.ts"],"names":[],"mappings":";;;;;;;;;AAEA,qDAAmE;AACnE,6CAA0C;AAMnC,IAAM,UAAU,GAAhB,MAAM,UAAW,SAAQ,8BAA0C;IAMxE;;;OAGG;IACI,YAAY;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC1B,CAAC;IACD;;;OAGG;IACI,UAAU;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC1B,CAAC;;AAnBU,gCAAU;AACrB;;GAEG;AACoB,eAAI,GAAG,gBAAgB,AAAnB,CAAoB;AAC/B,qBAAU,GAA4B,uBAAU,AAAtC,CAAuC;qBALtD,UAAU;IADtB,IAAA,2BAAY,GAAE;GACF,UAAU,CAoBtB"}
@@ -0,0 +1,3 @@
1
+ import { InvalidStringError, InvalidTypeError } from '@imolko/ultra-v8n';
2
+ export type Errors = InvalidTypeError | InvalidStringError;
3
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/authorization/resource-scope/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEzE,MAAM,MAAM,MAAM,GAAG,gBAAgB,GAAG,kBAAkB,CAAC"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=errors.js.map