@imolko/ultra-event-signature 0.4.0 → 0.4.1-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.
@@ -1 +1 @@
1
- {"version":3,"file":"sign.d.ts","sourceRoot":"","sources":["../src/sign.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAiBjE,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAG3D;AAsBD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,UAAU,CA8C7E"}
1
+ {"version":3,"file":"sign.d.ts","sourceRoot":"","sources":["../src/sign.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAiBjE,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAG3D;AA2DD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,UAAU,CAqD7E"}
package/dist-node/sign.js CHANGED
@@ -40,6 +40,40 @@ function validateKeyId(envelope, options) {
40
40
  }
41
41
  return undefined;
42
42
  }
43
+ /**
44
+ * Rechaza la forma de `source` y de `comimolkotenant` que ninguna política
45
+ * aceptada por `parseTrustPolicy` podría autorizar jamás (02 §2, 03 §4).
46
+ *
47
+ * «Presente» significa `!== undefined`: la forma canónica omite los miembros
48
+ * con valor `undefined` (01 §3.5), así que `{ source: undefined }` es el mismo
49
+ * hecho que la ausencia. Devuelve como mucho un token, el primer fallo, en el
50
+ * orden de 03 §4: autor (paso 3) y tenencia (paso 5).
51
+ */
52
+ function authorisabilityIssues(envelope) {
53
+ const source = envelope["source"];
54
+ if (source === undefined) {
55
+ return "missing:source";
56
+ }
57
+ if (typeof source !== "string" || source.length === 0) {
58
+ return "invalid:source";
59
+ }
60
+ if (source.includes("*")) {
61
+ return "invalid:source:wildcard";
62
+ }
63
+ // El vocabulario del `type` es de la política, no del firmador (03 §4): un
64
+ // `type` ausente o no textual ya falla más abajo, en la derivación del
65
+ // payload type, y la lista blanca la posee el documento de política.
66
+ // Un `comimolkotenant` presente que no es un string no vacío es un candidato
67
+ // que ningún scope puede contener, ni siquiera `all` (03 §4.5, PJ-005). El
68
+ // comodín sí es un candidato válido bajo `all`: la tenencia no es asunto del
69
+ // firmador, sólo su presencia y su forma.
70
+ const tenant = envelope["comimolkotenant"];
71
+ if (tenant !== undefined &&
72
+ (typeof tenant !== "string" || tenant.length === 0)) {
73
+ return "invalid:comimolkotenant";
74
+ }
75
+ return undefined;
76
+ }
43
77
  /**
44
78
  * Firma un hecho con Ed25519 y devuelve el sobre con `comimolkohash` y
45
79
  * `securityToken`.
@@ -63,6 +97,12 @@ function signFact(envelope, options) {
63
97
  if (declares(envelope, "comimolkohash")) {
64
98
  return (0, errors_1.invalid)("existing:comimolkohash");
65
99
  }
100
+ // Estructural y barata: precede al tipado del payload y a cualquier
101
+ // operación criptográfica, para que un sobre sin autor no llegue al digest.
102
+ const authorisabilityIssue = authorisabilityIssues(envelope);
103
+ if (authorisabilityIssue !== undefined) {
104
+ return (0, errors_1.invalid)(authorisabilityIssue);
105
+ }
66
106
  const payloadType = (0, payload_type_1.factPayloadType)(envelope);
67
107
  if (payloadType.kind !== "parsed") {
68
108
  return { kind: "invalid", issues: payloadType.issues };
@@ -1 +1 @@
1
- {"version":3,"file":"sign.js","sourceRoot":"","sources":["../src/sign.ts"],"names":[],"mappings":";;AAwBA,wCAGC;AA8BD,4BA8CC;AAvGD,qDAAiD;AACjD,qCAAoD;AACpD,qCAAkD;AAClD,+BAA4B;AAC5B,yCAAyC;AACzC,iDAAiD;AAGjD;;;;;;;GAOG;AAEH,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;AAE/B,qEAAqE;AACrE,MAAM,QAAQ,GAAG,CAAC,QAAkB,EAAE,MAAc,EAAW,EAAE,CAC/D,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAEzD,4DAA4D;AAC5D,SAAgB,cAAc,CAAC,QAAkB;IAC/C,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,GAAG,QAAQ,CAAC;IAC7E,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,aAAa,CACpB,QAAkB,EAClB,OAAoB;IAEpB,MAAM,aAAa,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;IAChD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,IAAA,gBAAO,EAAC,uBAAuB,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,CAAC,sBAAW,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAC1E,OAAO,IAAA,gBAAO,EAAC,uBAAuB,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,sBAAW,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1E,OAAO,IAAA,gBAAO,EAAC,eAAe,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,aAAa,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC;QACpC,OAAO,IAAA,gBAAO,EAAC,wBAAwB,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,QAAQ,CAAC,QAAkB,EAAE,OAAoB;IAC/D,IAAI,CAAC;QACH,IAAI,CAAC,IAAA,sBAAa,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAA,gBAAO,EAAC,kBAAkB,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,IAAI,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,CAAC;YACxC,OAAO,IAAA,gBAAO,EAAC,wBAAwB,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,CAAC;YACxC,OAAO,IAAA,gBAAO,EAAC,wBAAwB,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,WAAW,GAAG,IAAA,8BAAe,EAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,WAAW,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;QACzD,CAAC;QACD,MAAM,SAAS,GAAG,IAAA,8BAAa,EAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1D,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;QACvD,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,IAAA,eAAM,EAAC,IAAI,CAAC,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,IAAA,aAAI,EAAC,IAAA,SAAG,EAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QAEzE,wEAAwE;QACxE,2EAA2E;QAC3E,sEAAsE;QACtE,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAa,CAAC;QAE9D,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE;gBACR,GAAG,aAAa;gBAChB,aAAa,EAAE,MAAM;gBACrB,aAAa,EAAE,IAAA,mBAAU,EAAC,SAAS,CAAC;aACrC;SACF,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAA,gBAAO,EAAC,eAAe,CAAC,CAAC;IAClC,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"sign.js","sourceRoot":"","sources":["../src/sign.ts"],"names":[],"mappings":"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"}
@@ -30,7 +30,16 @@ one in [01 — wire format](spec/01-wire-format.md); the signing call is in
30
30
  4. **Freeze `source`.** `source` is the author identity the policy binds to the
31
31
  key. Changing it makes an emitter look like a different author and invalidates
32
32
  the policy entry. Done when `source` is a constant of the emitter, not a
33
- per-deployment or per-request value.
33
+ per-deployment or per-request value. Since `0.4.1` the library enforces the
34
+ shape, so this is a rule and not advice: `signFact` returns `invalid` with
35
+ `missing:source` when the envelope has no `source`, `invalid:source` when it is
36
+ present and not a non-empty string, and `invalid:source:wildcard` when it
37
+ contains `*` — before any cryptographic operation, so a forgotten or templated
38
+ author is never signed. A
39
+ `comimolkotenant` that is present and not a non-empty string is
40
+ `invalid:comimolkotenant`. Which `source` and `type` values are yours stay
41
+ the policy's decision (03 §4); the
42
+ signer only refuses the shapes no policy could accept.
34
43
 
35
44
  5. **Sign with `signFact`, never a home-grown canonicaliser.** Import the
36
45
  library (or delegate through `ultra-ddd`) and pass the covered envelope plus
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@imolko/ultra-event-signature",
3
- "version": "0.4.0",
3
+ "version": "0.4.1-beta",
4
4
  "description": "Formato v1 de firma de hechos CloudEvent (JSON canónico + DSSE PAE + Ed25519) y verificador puro sin dependencias.",
5
5
  "license": "MIT",
6
6
  "author": {