@me2em/core 0.4.4-alpha.1 → 0.6.0-alpha.1

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 (92) hide show
  1. package/README.md +299 -766
  2. package/dist/attestation.d.ts +151 -0
  3. package/dist/attestation.d.ts.map +1 -0
  4. package/dist/attestation.js +279 -0
  5. package/dist/attestation.js.map +1 -0
  6. package/dist/canonical-name.d.ts +3 -0
  7. package/dist/canonical-name.d.ts.map +1 -0
  8. package/dist/canonical-name.js +12 -0
  9. package/dist/canonical-name.js.map +1 -0
  10. package/dist/crypto/derivation-paths.d.ts +41 -0
  11. package/dist/crypto/derivation-paths.d.ts.map +1 -0
  12. package/dist/crypto/derivation-paths.js +50 -0
  13. package/dist/crypto/derivation-paths.js.map +1 -0
  14. package/dist/crypto/ed25519.d.ts +52 -0
  15. package/dist/crypto/ed25519.d.ts.map +1 -0
  16. package/dist/crypto/ed25519.js +67 -0
  17. package/dist/crypto/ed25519.js.map +1 -0
  18. package/dist/crypto/hkdf.d.ts +13 -0
  19. package/dist/crypto/hkdf.d.ts.map +1 -0
  20. package/dist/crypto/hkdf.js +17 -0
  21. package/dist/crypto/hkdf.js.map +1 -0
  22. package/dist/crypto/index.d.ts +4 -0
  23. package/dist/crypto/index.d.ts.map +1 -0
  24. package/dist/crypto/index.js +5 -0
  25. package/dist/crypto/index.js.map +1 -0
  26. package/dist/crypto/init.d.ts +9 -0
  27. package/dist/crypto/init.d.ts.map +1 -0
  28. package/dist/crypto/init.js +17 -0
  29. package/dist/crypto/init.js.map +1 -0
  30. package/dist/handle.d.ts +206 -0
  31. package/dist/handle.d.ts.map +1 -0
  32. package/dist/handle.js +258 -0
  33. package/dist/handle.js.map +1 -0
  34. package/dist/identity.d.ts +123 -0
  35. package/dist/identity.d.ts.map +1 -0
  36. package/dist/identity.js +167 -0
  37. package/dist/identity.js.map +1 -0
  38. package/dist/index.d.ts +33 -0
  39. package/dist/index.d.ts.map +1 -0
  40. package/dist/index.js +33 -0
  41. package/dist/index.js.map +1 -0
  42. package/dist/seed.d.ts +83 -0
  43. package/dist/seed.d.ts.map +1 -0
  44. package/dist/seed.js +117 -0
  45. package/dist/seed.js.map +1 -0
  46. package/dist/session.d.ts +231 -0
  47. package/dist/session.d.ts.map +1 -0
  48. package/dist/session.js +454 -0
  49. package/dist/session.js.map +1 -0
  50. package/dist/subhandle.d.ts +126 -0
  51. package/dist/subhandle.d.ts.map +1 -0
  52. package/dist/subhandle.js +158 -0
  53. package/dist/subhandle.js.map +1 -0
  54. package/dist/util.d.ts +9 -0
  55. package/dist/util.d.ts.map +1 -0
  56. package/dist/util.js +34 -0
  57. package/dist/util.js.map +1 -0
  58. package/package.json +36 -12
  59. package/src/attestation.ts +364 -0
  60. package/src/canonical-name.ts +12 -0
  61. package/src/crypto/derivation-paths.ts +56 -0
  62. package/src/crypto/ed25519.ts +86 -0
  63. package/{packages/core/src → src}/crypto/hkdf.ts +2 -0
  64. package/src/crypto/index.ts +4 -0
  65. package/{packages/core/src → src}/crypto/init.ts +1 -0
  66. package/src/handle.ts +320 -0
  67. package/src/identity.ts +218 -0
  68. package/{packages/core/src → src}/index.ts +5 -1
  69. package/{packages/core/src → src}/seed.ts +41 -54
  70. package/src/session.ts +660 -0
  71. package/src/subhandle.ts +230 -0
  72. package/src/util.ts +35 -0
  73. package/.github/workflows/ci.yml +0 -0
  74. package/CODE_OF_CONDUCT.md +0 -73
  75. package/CONTRIBUTING.md +0 -145
  76. package/GOVERNANCE.md +0 -132
  77. package/SECURITY.md +0 -70
  78. package/packages/core/README.md +0 -656
  79. package/packages/core/package.json +0 -44
  80. package/packages/core/src/crypto/ed25519.ts +0 -12
  81. package/packages/core/src/crypto/index.ts +0 -2
  82. package/packages/core/src/handle.ts +0 -130
  83. package/packages/core/src/identity.ts +0 -89
  84. package/packages/core/src/session.ts +0 -47
  85. package/packages/core/test/derivation.spec.ts +0 -117
  86. package/packages/core/tsconfig.json +0 -9
  87. package/pnpm-workspace.yaml +0 -2
  88. package/specs/core.md +0 -44
  89. package/specs/openapi/server-ref.yaml +0 -10
  90. package/specs/test-vectors.json +0 -13
  91. package/tsconfig.base.json +0 -20
  92. package/typedoc.json +0 -18
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,126 @@
1
+ import { Handle, type HandleMetadata } from './handle.js';
2
+ /**
3
+ * Metadata for a {@link SubHandle}, extending {@link HandleMetadata} with
4
+ * constraints that govern session creation.
5
+ *
6
+ * All constraint fields are optional. When present, they are enforced by
7
+ * {@link SubHandle.validateSessionOptions} at session creation time.
8
+ *
9
+ * @category Types
10
+ */
11
+ export interface SubHandleMetadata extends HandleMetadata {
12
+ /**
13
+ * Restricts the set of audiences this SubHandle may create sessions for.
14
+ * `undefined` = unrestricted; `[]` = deny all.
15
+ */
16
+ allowedAudiences?: string[];
17
+ /**
18
+ * Restricts the set of scopes this SubHandle may request in sessions.
19
+ * `undefined` = unrestricted; `[]` = deny all.
20
+ */
21
+ allowedScopes?: string[];
22
+ /**
23
+ * Maximum allowed TTL (in seconds) for sessions created by this SubHandle.
24
+ * Attempts to create a session with a larger TTL will be rejected.
25
+ */
26
+ maxSessionTtl?: number;
27
+ /**
28
+ * Unix timestamp (in seconds) at which this SubHandle itself expires.
29
+ * After this time, any attempt to create a session will fail.
30
+ * Useful for temporary access grants (e.g., contractor access for 2 weeks).
31
+ */
32
+ expiresAt?: number;
33
+ }
34
+ /**
35
+ * Represents a context-isolated child Handle in the Me2em hierarchy.
36
+ *
37
+ * A SubHandle is always derived from a parent {@link Handle} and represents
38
+ * a leaf node in the derivation tree (MAX_DEPTH = 2). It inherits all
39
+ * cryptographic capabilities of Handle (signing, key derivation, etc.) but
40
+ * adds:
41
+ *
42
+ * - A **derivation path** (`[handleName, subName]`) carried in session tokens.
43
+ * - **Constraint enforcement** on audience, scopes, and TTL at session creation.
44
+ * - An optional **expiration timestamp** for temporary access grants.
45
+ *
46
+ * SubHandle is used for polymorphism in {@link Session}: both Handle and
47
+ * SubHandle can create and verify sessions, but SubHandle sessions carry
48
+ * the additional `hPath` field for hierarchical auditing.
49
+ *
50
+ * @category Core Primitives
51
+ */
52
+ export declare class SubHandle extends Handle {
53
+ private readonly _path;
54
+ private readonly _subMetadata;
55
+ /**
56
+ * Creates a new SubHandle instance.
57
+ *
58
+ * @internal Typically created via {@link Handle.deriveSubHandle} or
59
+ * {@link Identity.deriveSubHandle}. Direct construction is discouraged.
60
+ *
61
+ * @param privateKey - The 32-byte Ed25519 private key for this SubHandle.
62
+ * @param name - The SubHandle name.
63
+ * @param path - The derivation path, must have exactly 2 elements: `[handleName, subName]`.
64
+ * @param subMetadata - Optional constraints and metadata.
65
+ * @throws {Error} If the path does not have exactly 2 elements.
66
+ */
67
+ constructor(privateKey: Uint8Array, name: string, path: string[], subMetadata?: SubHandleMetadata);
68
+ /**
69
+ * Returns the full derivation path of this SubHandle.
70
+ *
71
+ * @returns A copy of the path array, e.g. `["station-001", "connector-1"]`.
72
+ */
73
+ getPath(): string[];
74
+ /**
75
+ * Returns the derivation path as a slash-separated string.
76
+ *
77
+ * @returns The path string, e.g. `"station-001/connector-1"`.
78
+ */
79
+ getPathString(): string;
80
+ /**
81
+ * Returns the depth of this SubHandle in the derivation hierarchy.
82
+ *
83
+ * With MAX_DEPTH = 2, this is always `2` (Identity = 0, Handle = 1, SubHandle = 2).
84
+ *
85
+ * @returns The depth, always `2`.
86
+ */
87
+ getDepth(): number;
88
+ /**
89
+ * Returns whether this SubHandle is a leaf node.
90
+ *
91
+ * With MAX_DEPTH = 2, a SubHandle is **always** a leaf and cannot derive children.
92
+ *
93
+ * @returns Always `true`.
94
+ */
95
+ isLeaf(): boolean;
96
+ /**
97
+ * SubHandle is a leaf node (depth = 2) and cannot derive children.
98
+ * Overrides the inherited `Handle.deriveSubHandle` to throw an error.
99
+ */
100
+ deriveSubHandle(): Promise<never>;
101
+ /**
102
+ * Returns the SubHandle-specific metadata (constraints).
103
+ *
104
+ * @returns The SubHandleMetadata object.
105
+ */
106
+ getSubMetadata(): SubHandleMetadata;
107
+ /**
108
+ * Validates session options against this SubHandle's constraints.
109
+ *
110
+ * Called internally by {@link Session.create} before signing. Throws if
111
+ * any constraint is violated:
112
+ * - `audience` not in `allowedAudiences`
113
+ * - any `scope` not in `allowedScopes`
114
+ * - `ttl` exceeds `maxSessionTtl`
115
+ * - current time is past `expiresAt`
116
+ *
117
+ * @param options - The session options to validate.
118
+ * @throws {Error} If any constraint is violated.
119
+ */
120
+ validateSessionOptions(options: {
121
+ audience: string;
122
+ scopes: string[];
123
+ ttl: number;
124
+ }): void;
125
+ }
126
+ //# sourceMappingURL=subhandle.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"subhandle.d.ts","sourceRoot":"","sources":["../src/subhandle.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAG1D;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD;;;QAGI;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,SAAU,SAAQ,MAAM;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IAEjD;;;;;;;;;;;OAWG;gBAED,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,WAAW,CAAC,EAAE,iBAAiB;IAmBjC;;;;OAIG;IACH,OAAO,IAAI,MAAM,EAAE;IAInB;;;;OAIG;IACH,aAAa,IAAI,MAAM;IAIvB;;;;;;OAMG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;;;;OAMG;IACH,MAAM,IAAI,OAAO;IAIjB;;;OAGG;IACY,eAAe,IAAI,OAAO,CAAC,KAAK,CAAC;IAIhD;;;;OAIG;IACH,cAAc,IAAI,iBAAiB;IAYnC;;;;;;;;;;;;OAYG;IACH,sBAAsB,CAAC,OAAO,EAAE;QAC9B,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,IAAI;CA6CT"}
@@ -0,0 +1,158 @@
1
+ // subhandle.ts
2
+ //
3
+ // SubHandle is a leaf node in the Me2em derivation tree.
4
+ // With MAX_DEPTH = 2, a SubHandle CANNOT derive children.
5
+ // It inherits from Handle for polymorphism in Session handling.
6
+ import { Handle } from './handle.js';
7
+ import { normalizeName } from './canonical-name.js';
8
+ /**
9
+ * Represents a context-isolated child Handle in the Me2em hierarchy.
10
+ *
11
+ * A SubHandle is always derived from a parent {@link Handle} and represents
12
+ * a leaf node in the derivation tree (MAX_DEPTH = 2). It inherits all
13
+ * cryptographic capabilities of Handle (signing, key derivation, etc.) but
14
+ * adds:
15
+ *
16
+ * - A **derivation path** (`[handleName, subName]`) carried in session tokens.
17
+ * - **Constraint enforcement** on audience, scopes, and TTL at session creation.
18
+ * - An optional **expiration timestamp** for temporary access grants.
19
+ *
20
+ * SubHandle is used for polymorphism in {@link Session}: both Handle and
21
+ * SubHandle can create and verify sessions, but SubHandle sessions carry
22
+ * the additional `hPath` field for hierarchical auditing.
23
+ *
24
+ * @category Core Primitives
25
+ */
26
+ export class SubHandle extends Handle {
27
+ _path;
28
+ _subMetadata;
29
+ /**
30
+ * Creates a new SubHandle instance.
31
+ *
32
+ * @internal Typically created via {@link Handle.deriveSubHandle} or
33
+ * {@link Identity.deriveSubHandle}. Direct construction is discouraged.
34
+ *
35
+ * @param privateKey - The 32-byte Ed25519 private key for this SubHandle.
36
+ * @param name - The SubHandle name.
37
+ * @param path - The derivation path, must have exactly 2 elements: `[handleName, subName]`.
38
+ * @param subMetadata - Optional constraints and metadata.
39
+ * @throws {Error} If the path does not have exactly 2 elements.
40
+ */
41
+ constructor(privateKey, name, path, subMetadata) {
42
+ super(privateKey, name, subMetadata);
43
+ if (path.length !== 2) {
44
+ throw new Error(`SubHandle path must have exactly 2 elements: [handleName, subName]. Got ${path.length}.`);
45
+ }
46
+ const normalizedName = normalizeName(name);
47
+ if (path[1] !== normalizedName) {
48
+ throw new Error(`path[1] must equal normalized name: path[1]=${JSON.stringify(path[1])}, name=${JSON.stringify(normalizedName)}`);
49
+ }
50
+ this._path = path;
51
+ this._subMetadata = subMetadata ?? {};
52
+ }
53
+ /**
54
+ * Returns the full derivation path of this SubHandle.
55
+ *
56
+ * @returns A copy of the path array, e.g. `["station-001", "connector-1"]`.
57
+ */
58
+ getPath() {
59
+ return [...this._path];
60
+ }
61
+ /**
62
+ * Returns the derivation path as a slash-separated string.
63
+ *
64
+ * @returns The path string, e.g. `"station-001/connector-1"`.
65
+ */
66
+ getPathString() {
67
+ return this._path.join('/');
68
+ }
69
+ /**
70
+ * Returns the depth of this SubHandle in the derivation hierarchy.
71
+ *
72
+ * With MAX_DEPTH = 2, this is always `2` (Identity = 0, Handle = 1, SubHandle = 2).
73
+ *
74
+ * @returns The depth, always `2`.
75
+ */
76
+ getDepth() {
77
+ return 2;
78
+ }
79
+ /**
80
+ * Returns whether this SubHandle is a leaf node.
81
+ *
82
+ * With MAX_DEPTH = 2, a SubHandle is **always** a leaf and cannot derive children.
83
+ *
84
+ * @returns Always `true`.
85
+ */
86
+ isLeaf() {
87
+ return true;
88
+ }
89
+ /**
90
+ * SubHandle is a leaf node (depth = 2) and cannot derive children.
91
+ * Overrides the inherited `Handle.deriveSubHandle` to throw an error.
92
+ */
93
+ async deriveSubHandle() {
94
+ throw new Error('Cannot derive child: maximum depth (2) reached or this SubHandle is marked as leaf');
95
+ }
96
+ /**
97
+ * Returns the SubHandle-specific metadata (constraints).
98
+ *
99
+ * @returns The SubHandleMetadata object.
100
+ */
101
+ getSubMetadata() {
102
+ return {
103
+ ...this._subMetadata,
104
+ allowedAudiences: this._subMetadata.allowedAudiences
105
+ ? [...this._subMetadata.allowedAudiences]
106
+ : undefined,
107
+ allowedScopes: this._subMetadata.allowedScopes
108
+ ? [...this._subMetadata.allowedScopes]
109
+ : undefined,
110
+ };
111
+ }
112
+ /**
113
+ * Validates session options against this SubHandle's constraints.
114
+ *
115
+ * Called internally by {@link Session.create} before signing. Throws if
116
+ * any constraint is violated:
117
+ * - `audience` not in `allowedAudiences`
118
+ * - any `scope` not in `allowedScopes`
119
+ * - `ttl` exceeds `maxSessionTtl`
120
+ * - current time is past `expiresAt`
121
+ *
122
+ * @param options - The session options to validate.
123
+ * @throws {Error} If any constraint is violated.
124
+ */
125
+ validateSessionOptions(options) {
126
+ // Audience check: undefined = unrestricted, [] = deny all
127
+ if (this._subMetadata.allowedAudiences !== undefined) {
128
+ if (!this._subMetadata.allowedAudiences.includes(options.audience)) {
129
+ throw new Error(`Audience "${options.audience}" not allowed for this SubHandle. ` +
130
+ `Allowed: ${this._subMetadata.allowedAudiences.length === 0
131
+ ? '(none — empty list denies all)'
132
+ : this._subMetadata.allowedAudiences.join(', ')}`);
133
+ }
134
+ }
135
+ // Scopes check: undefined = unrestricted, [] = deny all
136
+ if (this._subMetadata.allowedScopes !== undefined) {
137
+ const forbidden = options.scopes.filter(s => !this._subMetadata.allowedScopes.includes(s));
138
+ // An empty allow-list denies every requested scope.
139
+ if (forbidden.length > 0) {
140
+ throw new Error(`Scopes not allowed for this SubHandle: ${forbidden.join(', ')}`);
141
+ }
142
+ }
143
+ // TTL check
144
+ if (this._subMetadata.maxSessionTtl !== undefined &&
145
+ options.ttl > this._subMetadata.maxSessionTtl) {
146
+ throw new Error(`TTL ${options.ttl}s exceeds max allowed ` +
147
+ `${this._subMetadata.maxSessionTtl}s for this SubHandle`);
148
+ }
149
+ // SubHandle expiration check
150
+ if (this._subMetadata.expiresAt !== undefined) {
151
+ const now = Math.floor(Date.now() / 1000);
152
+ if (now >= this._subMetadata.expiresAt) {
153
+ throw new Error('SubHandle has expired');
154
+ }
155
+ }
156
+ }
157
+ }
158
+ //# sourceMappingURL=subhandle.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"subhandle.js","sourceRoot":"","sources":["../src/subhandle.ts"],"names":[],"mappings":"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"}
package/dist/util.d.ts ADDED
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Encodes a Uint8Array to a URL-safe Base64 string (no padding).
3
+ */
4
+ export declare function base64urlEncode(bytes: Uint8Array): string;
5
+ /**
6
+ * Decodes a URL-safe Base64 string to a Uint8Array.
7
+ */
8
+ export declare function base64urlDecode(input: string): Uint8Array;
9
+ //# sourceMappingURL=util.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CASzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAazD"}
package/dist/util.js ADDED
@@ -0,0 +1,34 @@
1
+ // util.ts
2
+ //
3
+ // Shared utility functions for the Me2em protocol.
4
+ /**
5
+ * Encodes a Uint8Array to a URL-safe Base64 string (no padding).
6
+ */
7
+ export function base64urlEncode(bytes) {
8
+ let binary = '';
9
+ for (const byte of bytes) {
10
+ binary += String.fromCharCode(byte);
11
+ }
12
+ return btoa(binary)
13
+ .replace(/\+/g, '-')
14
+ .replace(/\//g, '_')
15
+ .replace(/=+$/, '');
16
+ }
17
+ /**
18
+ * Decodes a URL-safe Base64 string to a Uint8Array.
19
+ */
20
+ export function base64urlDecode(input) {
21
+ let base64 = input
22
+ .replace(/-/g, '+')
23
+ .replace(/_/g, '/');
24
+ while (base64.length % 4 !== 0) {
25
+ base64 += '=';
26
+ }
27
+ const binary = atob(base64);
28
+ const bytes = new Uint8Array(binary.length);
29
+ for (let i = 0; i < binary.length; i++) {
30
+ bytes[i] = binary.charCodeAt(i);
31
+ }
32
+ return bytes;
33
+ }
34
+ //# sourceMappingURL=util.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,EAAE;AACF,mDAAmD;AAEnD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC;SAChB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,IAAI,MAAM,GAAG,KAAK;SACf,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;SAClB,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,CAAC;IAChB,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
package/package.json CHANGED
@@ -1,20 +1,44 @@
1
1
  {
2
2
  "name": "@me2em/core",
3
- "version": "0.4.4-alpha.1",
4
- "private": false,
5
- "engines": {
6
- "node": ">=18.0.0",
7
- "pnpm": ">=9.0.0"
3
+ "version": "0.6.0-alpha.1",
4
+ "description": "Core primitives for the Me2em authorization protocol: Identity, Handle, and Session",
5
+ "type": "module",
6
+ "main": "./dist/index.js",
7
+ "types": "./dist/index.d.ts",
8
+ "exports": {
9
+ ".": {
10
+ "types": "./dist/index.d.ts",
11
+ "import": "./dist/index.js"
12
+ }
13
+ },
14
+ "files": [
15
+ "dist",
16
+ "src",
17
+ "README.md",
18
+ "LICENSE"
19
+ ],
20
+ "license": "Apache-2.0",
21
+ "publishConfig": {
22
+ "access": "public"
23
+ },
24
+ "dependencies": {
25
+ "@noble/curves": "^1.8.1",
26
+ "@noble/ed25519": "^3.1.0",
27
+ "@noble/hashes": "^2.2.0",
28
+ "@scure/bip39": "^1.3.0"
8
29
  },
9
30
  "devDependencies": {
10
- "typedoc": "^0.26.11",
11
- "typescript": "5.6"
31
+ "@types/node": "^25.9.1",
32
+ "@vitest/coverage-v8": "^4.1.11",
33
+ "eslint": "^10.4.1",
34
+ "typescript": "^6.0.3",
35
+ "vitest": "^4.1.7"
12
36
  },
13
37
  "scripts": {
14
- "build": "pnpm -r build",
15
- "test": "pnpm -r test",
16
- "lint": "pnpm -r lint",
17
- "typecheck": "pnpm -r typecheck",
18
- "build-docs": "typedoc"
38
+ "build": "tsc -p tsconfig.json",
39
+ "test": "vitest run",
40
+ "test:coverage": "vitest run --coverage",
41
+ "lint": "eslint src",
42
+ "typecheck": "tsc --noEmit"
19
43
  }
20
44
  }