@selfauth/spec 0.0.0-stage → 0.2.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.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 The SelfAuth Authors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,25 @@
1
- # Temporary Holding Version
1
+ # @selfauth/spec
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ The language-neutral SelfAuth specification, plus the tooling around it.
4
+
5
+ - `specs/*.md` are the normative documents: authentication, authorization,
6
+ security requirements, data model, errors, configuration, conformance and
7
+ optional capabilities. Requirements carry stable IDs such as
8
+ `**[SEC-CSRF-004]** (MUST)`.
9
+ - `parseRequirements()` and `loadRequirements()` read those IDs, and
10
+ `findRequirementReferences()` finds where they are cited.
11
+ - `selfAuthConfigSchema`, `parseConfig()`, `defineConfig()` and
12
+ `configJsonSchema()` validate `selfauth.config` against the spec's bounds.
13
+ For example, Argon2 settings below the
14
+ OWASP floor are rejected, and so is an idle timeout longer than the
15
+ absolute one.
16
+ - `ERROR_CODES`, `ERROR_HTTP_STATUS` and `isErrorCode()` cover the error
17
+ envelope and its codes.
18
+
19
+ ```ts
20
+ import { parseConfig, loadRequirements, SPEC_VERSION } from "@selfauth/spec";
21
+ ```
22
+
23
+ Projects generated by SelfAuth don't depend on this package at runtime. They
24
+ keep a local copy of the types. See the
25
+ [repository](https://github.com/thetejasmagade/selfauth).
@@ -0,0 +1,181 @@
1
+ /**
2
+ * Machine-readable form of specs/CONFIGURATION_SPEC.md.
3
+ * Unknown keys are rejected (CONF-FILE-001); out-of-range values are rejected,
4
+ * never clamped (CONF-FILE-003).
5
+ */
6
+ import { z } from "zod";
7
+ export declare const SPEC_VERSION = "0.1";
8
+ /** AUTHZ-PERM-001: two or more dot-separated `[a-z][a-z0-9_]*` segments. */
9
+ export declare const PERMISSION_PATTERN: RegExp;
10
+ /** AUTHZ-RBAC-001. */
11
+ export declare const ROLE_NAME_PATTERN: RegExp;
12
+ /** System permissions held by the `admin` role (AUTHORIZATION_SPEC §5). */
13
+ export declare const SYSTEM_PERMISSIONS: readonly ["auth.users.read", "auth.users.manage", "auth.sessions.manage", "auth.roles.assign", "auth.roles.manage", "auth.audit.read"];
14
+ export declare const SYSTEM_ROLES: readonly ["admin", "user"];
15
+ /** Minimum Argon2id profiles (SEC-HASH-002, OWASP). A configuration must meet at least one. */
16
+ export declare const ARGON2_FLOORS: readonly [{
17
+ readonly memoryKiB: 19456;
18
+ readonly iterations: 2;
19
+ }, {
20
+ readonly memoryKiB: 47104;
21
+ readonly iterations: 1;
22
+ }];
23
+ export declare function meetsArgon2Floor(p: {
24
+ memoryKiB: number;
25
+ iterations: number;
26
+ }): boolean;
27
+ export declare const selfAuthConfigSchema: z.ZodObject<{
28
+ specVersion: z.ZodDefault<z.ZodString>;
29
+ adapter: z.ZodObject<{
30
+ backend: z.ZodEnum<{
31
+ express: "express";
32
+ }>;
33
+ frontend: z.ZodDefault<z.ZodEnum<{
34
+ none: "none";
35
+ vue: "vue";
36
+ react: "react";
37
+ }>>;
38
+ database: z.ZodEnum<{
39
+ postgresql: "postgresql";
40
+ mongodb: "mongodb";
41
+ memory: "memory";
42
+ }>;
43
+ orm: z.ZodEnum<{
44
+ prisma: "prisma";
45
+ mongoose: "mongoose";
46
+ none: "none";
47
+ }>;
48
+ }, z.core.$strict>;
49
+ authentication: z.ZodPrefault<z.ZodObject<{
50
+ methods: z.ZodDefault<z.ZodArray<z.ZodEnum<{
51
+ password: "password";
52
+ }>>>;
53
+ emailVerification: z.ZodPrefault<z.ZodObject<{
54
+ mode: z.ZodDefault<z.ZodEnum<{
55
+ optional: "optional";
56
+ required: "required";
57
+ off: "off";
58
+ }>>;
59
+ tokenTtlMinutes: z.ZodDefault<z.ZodNumber>;
60
+ }, z.core.$strict>>;
61
+ registration: z.ZodPrefault<z.ZodObject<{
62
+ revealExistingEmail: z.ZodDefault<z.ZodBoolean>;
63
+ signInAfterRegistration: z.ZodDefault<z.ZodBoolean>;
64
+ }, z.core.$strict>>;
65
+ passwordReset: z.ZodPrefault<z.ZodObject<{
66
+ tokenTtlMinutes: z.ZodDefault<z.ZodNumber>;
67
+ }, z.core.$strict>>;
68
+ password: z.ZodPrefault<z.ZodObject<{
69
+ minLength: z.ZodDefault<z.ZodNumber>;
70
+ maxLength: z.ZodDefault<z.ZodNumber>;
71
+ rejectCommon: z.ZodDefault<z.ZodBoolean>;
72
+ hashing: z.ZodPrefault<z.ZodObject<{
73
+ memoryKiB: z.ZodDefault<z.ZodNumber>;
74
+ iterations: z.ZodDefault<z.ZodNumber>;
75
+ parallelism: z.ZodDefault<z.ZodNumber>;
76
+ }, z.core.$strict>>;
77
+ }, z.core.$strict>>;
78
+ sessions: z.ZodPrefault<z.ZodObject<{
79
+ strategy: z.ZodDefault<z.ZodEnum<{
80
+ database: "database";
81
+ }>>;
82
+ idleTimeoutMinutes: z.ZodDefault<z.ZodNumber>;
83
+ absoluteTimeoutMinutes: z.ZodDefault<z.ZodNumber>;
84
+ touchIntervalSeconds: z.ZodDefault<z.ZodNumber>;
85
+ cookie: z.ZodPrefault<z.ZodObject<{
86
+ name: z.ZodDefault<z.ZodString>;
87
+ sameSite: z.ZodDefault<z.ZodEnum<{
88
+ none: "none";
89
+ lax: "lax";
90
+ strict: "strict";
91
+ }>>;
92
+ secure: z.ZodDefault<z.ZodBoolean>;
93
+ }, z.core.$strict>>;
94
+ }, z.core.$strict>>;
95
+ rateLimit: z.ZodPrefault<z.ZodObject<{
96
+ login: z.ZodPrefault<z.ZodObject<{
97
+ perAccount: z.ZodPrefault<z.ZodObject<{
98
+ limit: z.ZodDefault<z.ZodNumber>;
99
+ windowSeconds: z.ZodDefault<z.ZodNumber>;
100
+ }, z.core.$strict>>;
101
+ perAddress: z.ZodPrefault<z.ZodObject<{
102
+ limit: z.ZodDefault<z.ZodNumber>;
103
+ windowSeconds: z.ZodDefault<z.ZodNumber>;
104
+ }, z.core.$strict>>;
105
+ }, z.core.$strict>>;
106
+ passwordChange: z.ZodPrefault<z.ZodObject<{
107
+ perAccount: z.ZodPrefault<z.ZodObject<{
108
+ limit: z.ZodDefault<z.ZodNumber>;
109
+ windowSeconds: z.ZodDefault<z.ZodNumber>;
110
+ }, z.core.$strict>>;
111
+ perAddress: z.ZodPrefault<z.ZodObject<{
112
+ limit: z.ZodDefault<z.ZodNumber>;
113
+ windowSeconds: z.ZodDefault<z.ZodNumber>;
114
+ }, z.core.$strict>>;
115
+ }, z.core.$strict>>;
116
+ register: z.ZodPrefault<z.ZodObject<{
117
+ perAccount: z.ZodPrefault<z.ZodObject<{
118
+ limit: z.ZodDefault<z.ZodNumber>;
119
+ windowSeconds: z.ZodDefault<z.ZodNumber>;
120
+ }, z.core.$strict>>;
121
+ perAddress: z.ZodPrefault<z.ZodObject<{
122
+ limit: z.ZodDefault<z.ZodNumber>;
123
+ windowSeconds: z.ZodDefault<z.ZodNumber>;
124
+ }, z.core.$strict>>;
125
+ }, z.core.$strict>>;
126
+ passwordResetRequest: z.ZodPrefault<z.ZodObject<{
127
+ perAccount: z.ZodPrefault<z.ZodObject<{
128
+ limit: z.ZodDefault<z.ZodNumber>;
129
+ windowSeconds: z.ZodDefault<z.ZodNumber>;
130
+ }, z.core.$strict>>;
131
+ perAddress: z.ZodPrefault<z.ZodObject<{
132
+ limit: z.ZodDefault<z.ZodNumber>;
133
+ windowSeconds: z.ZodDefault<z.ZodNumber>;
134
+ }, z.core.$strict>>;
135
+ }, z.core.$strict>>;
136
+ verificationResend: z.ZodPrefault<z.ZodObject<{
137
+ perAccount: z.ZodPrefault<z.ZodObject<{
138
+ limit: z.ZodDefault<z.ZodNumber>;
139
+ windowSeconds: z.ZodDefault<z.ZodNumber>;
140
+ }, z.core.$strict>>;
141
+ perAddress: z.ZodPrefault<z.ZodObject<{
142
+ limit: z.ZodDefault<z.ZodNumber>;
143
+ windowSeconds: z.ZodDefault<z.ZodNumber>;
144
+ }, z.core.$strict>>;
145
+ }, z.core.$strict>>;
146
+ }, z.core.$strict>>;
147
+ }, z.core.$strict>>;
148
+ authorization: z.ZodPrefault<z.ZodObject<{
149
+ strategy: z.ZodDefault<z.ZodEnum<{
150
+ rbac: "rbac";
151
+ }>>;
152
+ permissions: z.ZodDefault<z.ZodArray<z.ZodString>>;
153
+ roles: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
154
+ defaultRoles: z.ZodDefault<z.ZodArray<z.ZodString>>;
155
+ reauthenticationWindowMinutes: z.ZodDefault<z.ZodNumber>;
156
+ }, z.core.$strict>>;
157
+ http: z.ZodPrefault<z.ZodObject<{
158
+ bodyLimitBytes: z.ZodDefault<z.ZodNumber>;
159
+ basePath: z.ZodDefault<z.ZodString>;
160
+ trustedOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
161
+ trustProxy: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodNumber, z.ZodArray<z.ZodString>]>>;
162
+ csrf: z.ZodPrefault<z.ZodObject<{
163
+ mode: z.ZodDefault<z.ZodEnum<{
164
+ header: "header";
165
+ token: "token";
166
+ }>>;
167
+ headerName: z.ZodDefault<z.ZodString>;
168
+ }, z.core.$strict>>;
169
+ }, z.core.$strict>>;
170
+ }, z.core.$strict>;
171
+ /** Configuration as written by the developer (defaults optional). */
172
+ export type SelfAuthConfigInput = z.input<typeof selfAuthConfigSchema>;
173
+ /** Fully resolved configuration with defaults applied. */
174
+ export type SelfAuthConfig = z.output<typeof selfAuthConfigSchema>;
175
+ /** Identity helper giving editor completion in `selfauth.config.ts`. */
176
+ export declare function defineConfig(config: SelfAuthConfigInput): SelfAuthConfigInput;
177
+ /** Validate and resolve a configuration; throws a ZodError on invalid input. */
178
+ export declare function parseConfig(config: unknown): SelfAuthConfig;
179
+ /** JSON Schema (input shape) for adapters written in other languages. */
180
+ export declare function configJsonSchema(): Record<string, unknown>;
181
+ //# sourceMappingURL=config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,QAA0C,CAAC;AAC1E,sBAAsB;AACtB,eAAO,MAAM,iBAAiB,QAAuB,CAAC;AAEtD,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,wIAOrB,CAAC;AAEX,eAAO,MAAM,YAAY,4BAA6B,CAAC;AAIvD,+FAA+F;AAC/F,eAAO,MAAM,aAAa;;;;;;EAGhB,CAAC;AAEX,wBAAgB,gBAAgB,CAAC,CAAC,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAEtF;AAoCD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0O7B,CAAC;AAEL,qEAAqE;AACrE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACvE,0DAA0D;AAC1D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEnE,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAE7E;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,CAE3D;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK1D"}
package/dist/config.js ADDED
@@ -0,0 +1,301 @@
1
+ /**
2
+ * Machine-readable form of specs/CONFIGURATION_SPEC.md.
3
+ * Unknown keys are rejected (CONF-FILE-001); out-of-range values are rejected,
4
+ * never clamped (CONF-FILE-003).
5
+ */
6
+ import { z } from "zod";
7
+ export const SPEC_VERSION = "0.1";
8
+ /** AUTHZ-PERM-001: two or more dot-separated `[a-z][a-z0-9_]*` segments. */
9
+ export const PERMISSION_PATTERN = /^[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)+$/;
10
+ /** AUTHZ-RBAC-001. */
11
+ export const ROLE_NAME_PATTERN = /^[a-z][a-z0-9_-]*$/;
12
+ /** System permissions held by the `admin` role (AUTHORIZATION_SPEC §5). */
13
+ export const SYSTEM_PERMISSIONS = [
14
+ "auth.users.read",
15
+ "auth.users.manage",
16
+ "auth.sessions.manage",
17
+ "auth.roles.assign",
18
+ "auth.roles.manage",
19
+ "auth.audit.read",
20
+ ];
21
+ export const SYSTEM_ROLES = ["admin", "user"];
22
+ const int = (min, max) => z.number().int().min(min).max(max);
23
+ /** Minimum Argon2id profiles (SEC-HASH-002, OWASP). A configuration must meet at least one. */
24
+ export const ARGON2_FLOORS = [
25
+ { memoryKiB: 19_456, iterations: 2 },
26
+ { memoryKiB: 47_104, iterations: 1 },
27
+ ];
28
+ export function meetsArgon2Floor(p) {
29
+ return ARGON2_FLOORS.some((f) => p.memoryKiB >= f.memoryKiB && p.iterations >= f.iterations);
30
+ }
31
+ const limitSchema = (limit) => z
32
+ .strictObject({
33
+ limit: int(1, 1_000_000).default(limit),
34
+ windowSeconds: int(1, 86_400).default(900),
35
+ })
36
+ .prefault({});
37
+ const rateLimitOp = (perAccount, perAddress) => z
38
+ .strictObject({
39
+ perAccount: limitSchema(perAccount),
40
+ perAddress: limitSchema(perAddress),
41
+ })
42
+ .prefault({});
43
+ const originSchema = z.string().refine((value) => {
44
+ try {
45
+ const url = new URL(value);
46
+ return (url.protocol === "https:" || url.protocol === "http:") && url.origin === value;
47
+ }
48
+ catch {
49
+ return false;
50
+ }
51
+ }, { message: "must be an origin such as https://app.example.com (no path or trailing slash)" });
52
+ const ADAPTER_PAIRS = {
53
+ postgresql: "prisma",
54
+ mongodb: "mongoose",
55
+ memory: "none",
56
+ };
57
+ export const selfAuthConfigSchema = z
58
+ .strictObject({
59
+ specVersion: z
60
+ .string()
61
+ .regex(/^\d+\.\d+$/)
62
+ .default(SPEC_VERSION),
63
+ adapter: z.strictObject({
64
+ backend: z.enum(["express"]),
65
+ frontend: z.enum(["vue", "react", "none"]).default("none"),
66
+ database: z.enum(["postgresql", "mongodb", "memory"]),
67
+ orm: z.enum(["prisma", "mongoose", "none"]),
68
+ }),
69
+ authentication: z
70
+ .strictObject({
71
+ methods: z
72
+ .array(z.enum(["password"]))
73
+ .min(1)
74
+ .default(["password"]),
75
+ emailVerification: z
76
+ .strictObject({
77
+ mode: z.enum(["required", "optional", "off"]).default("required"),
78
+ tokenTtlMinutes: int(5, 10_080).default(1_440),
79
+ })
80
+ .prefault({}),
81
+ registration: z
82
+ .strictObject({
83
+ revealExistingEmail: z.boolean().default(false),
84
+ signInAfterRegistration: z.boolean().default(false),
85
+ })
86
+ .prefault({}),
87
+ passwordReset: z
88
+ .strictObject({
89
+ tokenTtlMinutes: int(5, 60).default(30),
90
+ })
91
+ .prefault({}),
92
+ password: z
93
+ .strictObject({
94
+ minLength: int(8, 1024).default(12),
95
+ maxLength: int(64, 1024).default(128),
96
+ rejectCommon: z.boolean().default(true),
97
+ hashing: z
98
+ .strictObject({
99
+ memoryKiB: int(ARGON2_FLOORS[0].memoryKiB, 4_194_304).default(19_456),
100
+ iterations: int(1, 10).default(2),
101
+ parallelism: int(1, 16).default(1),
102
+ })
103
+ .prefault({})
104
+ .refine(meetsArgon2Floor, {
105
+ message: "Argon2id parameters are below the minimum (19 MiB with 2+ iterations, or 46 MiB with 1 iteration; SEC-HASH-002)",
106
+ path: ["memoryKiB"],
107
+ }),
108
+ })
109
+ .prefault({})
110
+ .refine((p) => p.minLength <= p.maxLength, {
111
+ message: "minLength must not exceed maxLength",
112
+ path: ["minLength"],
113
+ }),
114
+ sessions: z
115
+ .strictObject({
116
+ strategy: z.enum(["database"]).default("database"),
117
+ idleTimeoutMinutes: int(5, 525_600).default(10_080),
118
+ absoluteTimeoutMinutes: int(5, 525_600).default(43_200),
119
+ touchIntervalSeconds: int(0, 3_600).default(60),
120
+ cookie: z
121
+ .strictObject({
122
+ name: z
123
+ .string()
124
+ .regex(/^[A-Za-z0-9_-]+$/)
125
+ .default("__Host-session"),
126
+ sameSite: z.enum(["lax", "strict", "none"]).default("lax"),
127
+ secure: z.boolean().default(true),
128
+ })
129
+ .prefault({}),
130
+ })
131
+ .prefault({})
132
+ .superRefine((s, ctx) => {
133
+ if (s.idleTimeoutMinutes > s.absoluteTimeoutMinutes) {
134
+ ctx.addIssue({
135
+ code: "custom",
136
+ message: "idleTimeoutMinutes must not exceed absoluteTimeoutMinutes",
137
+ path: ["idleTimeoutMinutes"],
138
+ });
139
+ }
140
+ if (s.cookie.name.startsWith("__Host-") && !s.cookie.secure) {
141
+ ctx.addIssue({
142
+ code: "custom",
143
+ message: "__Host- cookies require secure: true; use another name for local http development",
144
+ path: ["cookie", "name"],
145
+ });
146
+ }
147
+ if (s.cookie.sameSite === "none" && !s.cookie.secure) {
148
+ ctx.addIssue({
149
+ code: "custom",
150
+ message: "sameSite 'none' requires secure: true",
151
+ path: ["cookie", "sameSite"],
152
+ });
153
+ }
154
+ }),
155
+ rateLimit: z
156
+ .strictObject({
157
+ login: rateLimitOp(5, 100),
158
+ passwordChange: rateLimitOp(5, 100),
159
+ register: rateLimitOp(3, 20),
160
+ passwordResetRequest: rateLimitOp(3, 20),
161
+ verificationResend: rateLimitOp(3, 20),
162
+ })
163
+ .prefault({}),
164
+ })
165
+ .prefault({}),
166
+ authorization: z
167
+ .strictObject({
168
+ strategy: z.enum(["rbac"]).default("rbac"),
169
+ permissions: z.array(z.string().regex(PERMISSION_PATTERN)).default([]),
170
+ roles: z
171
+ .record(z.string().regex(ROLE_NAME_PATTERN), z.array(z.string()))
172
+ .default({ user: [] }),
173
+ defaultRoles: z.array(z.string()).min(1).default(["user"]),
174
+ reauthenticationWindowMinutes: int(1, 1_440).default(15),
175
+ })
176
+ .prefault({})
177
+ .superRefine((a, ctx) => {
178
+ const defined = new Set();
179
+ a.permissions.forEach((p, i) => {
180
+ if (p.startsWith("auth.")) {
181
+ ctx.addIssue({
182
+ code: "custom",
183
+ message: "the 'auth.' prefix is reserved for system permissions",
184
+ path: ["permissions", i],
185
+ });
186
+ }
187
+ if (defined.has(p)) {
188
+ ctx.addIssue({
189
+ code: "custom",
190
+ message: `duplicate permission '${p}'`,
191
+ path: ["permissions", i],
192
+ });
193
+ }
194
+ defined.add(p);
195
+ });
196
+ const system = new Set(SYSTEM_PERMISSIONS);
197
+ for (const [role, perms] of Object.entries(a.roles)) {
198
+ perms.forEach((p, i) => {
199
+ if (!defined.has(p) && !system.has(p)) {
200
+ ctx.addIssue({
201
+ code: "custom",
202
+ message: `role '${role}' references undefined permission '${p}'`,
203
+ path: ["roles", role, i],
204
+ });
205
+ }
206
+ });
207
+ }
208
+ a.defaultRoles.forEach((r, i) => {
209
+ if (r === "admin") {
210
+ ctx.addIssue({
211
+ code: "custom",
212
+ message: "'admin' must not be a default role (AUTHZ-ADMIN-005)",
213
+ path: ["defaultRoles", i],
214
+ });
215
+ }
216
+ else if (!(r in a.roles)) {
217
+ ctx.addIssue({
218
+ code: "custom",
219
+ message: `default role '${r}' is not defined in roles`,
220
+ path: ["defaultRoles", i],
221
+ });
222
+ }
223
+ });
224
+ }),
225
+ http: z
226
+ .strictObject({
227
+ bodyLimitBytes: int(1_024, 1_048_576).default(16_384),
228
+ basePath: z
229
+ .string()
230
+ .regex(/^\/[A-Za-z0-9/_-]*$/)
231
+ .default("/auth"),
232
+ trustedOrigins: z.array(originSchema).default([]),
233
+ trustProxy: z
234
+ .union([z.literal(false), int(1, 32), z.array(z.string().min(1)).min(1)])
235
+ .default(false),
236
+ csrf: z
237
+ .strictObject({
238
+ mode: z.enum(["header", "token"]).default("header"),
239
+ headerName: z
240
+ .string()
241
+ .regex(/^[A-Za-z0-9-]+$/)
242
+ .default("X-SelfAuth-CSRF"),
243
+ })
244
+ .prefault({}),
245
+ })
246
+ .prefault({}),
247
+ })
248
+ .superRefine((c, ctx) => {
249
+ if (ADAPTER_PAIRS[c.adapter.database] !== c.adapter.orm) {
250
+ ctx.addIssue({
251
+ code: "custom",
252
+ message: `orm '${c.adapter.orm}' is not supported with database '${c.adapter.database}'`,
253
+ path: ["adapter", "orm"],
254
+ });
255
+ }
256
+ if (c.authentication.sessions.cookie.sameSite === "none" && c.http.csrf.mode !== "token") {
257
+ ctx.addIssue({
258
+ code: "custom",
259
+ message: "sameSite 'none' requires http.csrf.mode 'token' (SEC-COOKIE-005, SEC-CSRF-004)",
260
+ path: ["http", "csrf", "mode"],
261
+ });
262
+ }
263
+ const reg = c.authentication.registration;
264
+ if (reg.signInAfterRegistration) {
265
+ if (!reg.revealExistingEmail) {
266
+ ctx.addIssue({
267
+ code: "custom",
268
+ message: "signInAfterRegistration requires revealExistingEmail: true, because an immediate session reveals whether the email was new (AUTHN-REG-012)",
269
+ path: ["authentication", "registration", "signInAfterRegistration"],
270
+ });
271
+ }
272
+ if (c.authentication.emailVerification.mode === "required") {
273
+ ctx.addIssue({
274
+ code: "custom",
275
+ message: "signInAfterRegistration is not possible with emailVerification.mode 'required' (users are pending until verified)",
276
+ path: ["authentication", "registration", "signInAfterRegistration"],
277
+ });
278
+ }
279
+ }
280
+ const [major] = c.specVersion.split(".");
281
+ if (major !== SPEC_VERSION.split(".")[0]) {
282
+ ctx.addIssue({
283
+ code: "custom",
284
+ message: `specVersion ${c.specVersion} is not supported (this package implements ${SPEC_VERSION})`,
285
+ path: ["specVersion"],
286
+ });
287
+ }
288
+ });
289
+ /** Identity helper giving editor completion in `selfauth.config.ts`. */
290
+ export function defineConfig(config) {
291
+ return config;
292
+ }
293
+ /** Validate and resolve a configuration; throws a ZodError on invalid input. */
294
+ export function parseConfig(config) {
295
+ return selfAuthConfigSchema.parse(config);
296
+ }
297
+ /** JSON Schema (input shape) for adapters written in other languages. */
298
+ export function configJsonSchema() {
299
+ return z.toJSONSchema(selfAuthConfigSchema, { io: "input", unrepresentable: "any" });
300
+ }
301
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC;AAElC,4EAA4E;AAC5E,MAAM,CAAC,MAAM,kBAAkB,GAAG,uCAAuC,CAAC;AAC1E,sBAAsB;AACtB,MAAM,CAAC,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AAEtD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,iBAAiB;IACjB,mBAAmB;IACnB,sBAAsB;IACtB,mBAAmB;IACnB,mBAAmB;IACnB,iBAAiB;CACT,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,MAAM,CAAU,CAAC;AAEvD,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,GAAW,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE7E,+FAA+F;AAC/F,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE;IACpC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE;CAC5B,CAAC;AAEX,MAAM,UAAU,gBAAgB,CAAC,CAA4C;IAC3E,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,EAAE,CACpC,CAAC;KACE,YAAY,CAAC;IACZ,KAAK,EAAE,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACvC,aAAa,EAAE,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;CAC3C,CAAC;KACD,QAAQ,CAAC,EAAE,CAAC,CAAC;AAElB,MAAM,WAAW,GAAG,CAAC,UAAkB,EAAE,UAAkB,EAAE,EAAE,CAC7D,CAAC;KACE,YAAY,CAAC;IACZ,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC;IACnC,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC;CACpC,CAAC;KACD,QAAQ,CAAC,EAAE,CAAC,CAAC;AAElB,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CACpC,CAAC,KAAK,EAAE,EAAE;IACR,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,CAAC;IACzF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,EACD,EAAE,OAAO,EAAE,+EAA+E,EAAE,CAC7F,CAAC;AAEF,MAAM,aAAa,GAA2B;IAC5C,UAAU,EAAE,QAAQ;IACpB,OAAO,EAAE,UAAU;IACnB,MAAM,EAAE,MAAM;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,YAAY,CAAC;IACZ,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,KAAK,CAAC,YAAY,CAAC;SACnB,OAAO,CAAC,YAAY,CAAC;IACxB,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC;QACtB,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC;QAC5B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QAC1D,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACrD,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;KAC5C,CAAC;IACF,cAAc,EAAE,CAAC;SACd,YAAY,CAAC;QACZ,OAAO,EAAE,CAAC;aACP,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;aAC3B,GAAG,CAAC,CAAC,CAAC;aACN,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC;QACxB,iBAAiB,EAAE,CAAC;aACjB,YAAY,CAAC;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;YACjE,eAAe,EAAE,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;SAC/C,CAAC;aACD,QAAQ,CAAC,EAAE,CAAC;QACf,YAAY,EAAE,CAAC;aACZ,YAAY,CAAC;YACZ,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;YAC/C,uBAAuB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;SACpD,CAAC;aACD,QAAQ,CAAC,EAAE,CAAC;QACf,aAAa,EAAE,CAAC;aACb,YAAY,CAAC;YACZ,eAAe,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;SACxC,CAAC;aACD,QAAQ,CAAC,EAAE,CAAC;QACf,QAAQ,EAAE,CAAC;aACR,YAAY,CAAC;YACZ,SAAS,EAAE,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;YACrC,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;YACvC,OAAO,EAAE,CAAC;iBACP,YAAY,CAAC;gBACZ,SAAS,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;gBACrE,UAAU,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;gBACjC,WAAW,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;aACnC,CAAC;iBACD,QAAQ,CAAC,EAAE,CAAC;iBACZ,MAAM,CAAC,gBAAgB,EAAE;gBACxB,OAAO,EACL,iHAAiH;gBACnH,IAAI,EAAE,CAAC,WAAW,CAAC;aACpB,CAAC;SACL,CAAC;aACD,QAAQ,CAAC,EAAE,CAAC;aACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,EAAE;YACzC,OAAO,EAAE,qCAAqC;YAC9C,IAAI,EAAE,CAAC,WAAW,CAAC;SACpB,CAAC;QACJ,QAAQ,EAAE,CAAC;aACR,YAAY,CAAC;YACZ,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;YAClD,kBAAkB,EAAE,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;YACnD,sBAAsB,EAAE,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;YACvD,oBAAoB,EAAE,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/C,MAAM,EAAE,CAAC;iBACN,YAAY,CAAC;gBACZ,IAAI,EAAE,CAAC;qBACJ,MAAM,EAAE;qBACR,KAAK,CAAC,kBAAkB,CAAC;qBACzB,OAAO,CAAC,gBAAgB,CAAC;gBAC5B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;gBAC1D,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;aAClC,CAAC;iBACD,QAAQ,CAAC,EAAE,CAAC;SAChB,CAAC;aACD,QAAQ,CAAC,EAAE,CAAC;aACZ,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;YACtB,IAAI,CAAC,CAAC,kBAAkB,GAAG,CAAC,CAAC,sBAAsB,EAAE,CAAC;gBACpD,GAAG,CAAC,QAAQ,CAAC;oBACX,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,2DAA2D;oBACpE,IAAI,EAAE,CAAC,oBAAoB,CAAC;iBAC7B,CAAC,CAAC;YACL,CAAC;YACD,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC5D,GAAG,CAAC,QAAQ,CAAC;oBACX,IAAI,EAAE,QAAQ;oBACd,OAAO,EACL,mFAAmF;oBACrF,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;iBACzB,CAAC,CAAC;YACL,CAAC;YACD,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACrD,GAAG,CAAC,QAAQ,CAAC;oBACX,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,uCAAuC;oBAChD,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;iBAC7B,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC;QACJ,SAAS,EAAE,CAAC;aACT,YAAY,CAAC;YACZ,KAAK,EAAE,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC;YAC1B,cAAc,EAAE,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC;YACnC,QAAQ,EAAE,WAAW,CAAC,CAAC,EAAE,EAAE,CAAC;YAC5B,oBAAoB,EAAE,WAAW,CAAC,CAAC,EAAE,EAAE,CAAC;YACxC,kBAAkB,EAAE,WAAW,CAAC,CAAC,EAAE,EAAE,CAAC;SACvC,CAAC;aACD,QAAQ,CAAC,EAAE,CAAC;KAChB,CAAC;SACD,QAAQ,CAAC,EAAE,CAAC;IACf,aAAa,EAAE,CAAC;SACb,YAAY,CAAC;QACZ,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QAC1C,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QACtE,KAAK,EAAE,CAAC;aACL,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;aAChE,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACxB,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;QAC1D,6BAA6B,EAAE,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;KACzD,CAAC;SACD,QAAQ,CAAC,EAAE,CAAC;SACZ,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QACtB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC7B,IAAI,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1B,GAAG,CAAC,QAAQ,CAAC;oBACX,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,uDAAuD;oBAChE,IAAI,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;iBACzB,CAAC,CAAC;YACL,CAAC;YACD,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnB,GAAG,CAAC,QAAQ,CAAC;oBACX,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,yBAAyB,CAAC,GAAG;oBACtC,IAAI,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;iBACzB,CAAC,CAAC;YACL,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAS,kBAAkB,CAAC,CAAC;QACnD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACrB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBACtC,GAAG,CAAC,QAAQ,CAAC;wBACX,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,SAAS,IAAI,sCAAsC,CAAC,GAAG;wBAChE,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;qBACzB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QACD,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC9B,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;gBAClB,GAAG,CAAC,QAAQ,CAAC;oBACX,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,sDAAsD;oBAC/D,IAAI,EAAE,CAAC,cAAc,EAAE,CAAC,CAAC;iBAC1B,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,GAAG,CAAC,QAAQ,CAAC;oBACX,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,iBAAiB,CAAC,2BAA2B;oBACtD,IAAI,EAAE,CAAC,cAAc,EAAE,CAAC,CAAC;iBAC1B,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IACJ,IAAI,EAAE,CAAC;SACJ,YAAY,CAAC;QACZ,cAAc,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACrD,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,KAAK,CAAC,qBAAqB,CAAC;aAC5B,OAAO,CAAC,OAAO,CAAC;QACnB,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,UAAU,EAAE,CAAC;aACV,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aACxE,OAAO,CAAC,KAAK,CAAC;QACjB,IAAI,EAAE,CAAC;aACJ,YAAY,CAAC;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;YACnD,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,KAAK,CAAC,iBAAiB,CAAC;iBACxB,OAAO,CAAC,iBAAiB,CAAC;SAC9B,CAAC;aACD,QAAQ,CAAC,EAAE,CAAC;KAChB,CAAC;SACD,QAAQ,CAAC,EAAE,CAAC;CAChB,CAAC;KACD,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;IACtB,IAAI,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACxD,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,qCAAqC,CAAC,CAAC,OAAO,CAAC,QAAQ,GAAG;YACxF,IAAI,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC;SACzB,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACzF,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,gFAAgF;YACzF,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAC/B,CAAC,CAAC;IACL,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,CAAC,cAAc,CAAC,YAAY,CAAC;IAC1C,IAAI,GAAG,CAAC,uBAAuB,EAAE,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC;YAC7B,GAAG,CAAC,QAAQ,CAAC;gBACX,IAAI,EAAE,QAAQ;gBACd,OAAO,EACL,4IAA4I;gBAC9I,IAAI,EAAE,CAAC,gBAAgB,EAAE,cAAc,EAAE,yBAAyB,CAAC;aACpE,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,CAAC,cAAc,CAAC,iBAAiB,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC3D,GAAG,CAAC,QAAQ,CAAC;gBACX,IAAI,EAAE,QAAQ;gBACd,OAAO,EACL,mHAAmH;gBACrH,IAAI,EAAE,CAAC,gBAAgB,EAAE,cAAc,EAAE,yBAAyB,CAAC;aACpE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,KAAK,KAAK,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,eAAe,CAAC,CAAC,WAAW,8CAA8C,YAAY,GAAG;YAClG,IAAI,EAAE,CAAC,aAAa,CAAC;SACtB,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC;AAOL,wEAAwE;AACxE,MAAM,UAAU,YAAY,CAAC,MAA2B;IACtD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,WAAW,CAAC,MAAe;IACzC,OAAO,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,CAAC,YAAY,CAAC,oBAAoB,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,CAGlF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,20 @@
1
+ /** Stable error codes defined in specs/ERRORS.md. */
2
+ export declare const ERROR_CODES: readonly ["VALIDATION_FAILED", "PASSWORD_POLICY_VIOLATION", "INVALID_CREDENTIALS", "UNAUTHENTICATED", "EMAIL_NOT_VERIFIED", "ACCOUNT_UNAVAILABLE", "FORBIDDEN", "REAUTHENTICATION_REQUIRED", "CSRF_FAILED", "NOT_FOUND", "TOKEN_INVALID", "EMAIL_TAKEN", "CONFLICT", "RATE_LIMITED", "PAYLOAD_TOO_LARGE", "INTERNAL_ERROR"];
3
+ export type ErrorCode = (typeof ERROR_CODES)[number];
4
+ /** Recommended HTTP status per code (non-normative HTTP binding). */
5
+ export declare const ERROR_HTTP_STATUS: Readonly<Record<ErrorCode, number>>;
6
+ export interface ErrorDetail {
7
+ field: string;
8
+ issue: string;
9
+ }
10
+ /** Error envelope body (ERR-FORMAT-001). */
11
+ export interface ErrorEnvelope {
12
+ error: {
13
+ code: ErrorCode;
14
+ message: string;
15
+ requestId?: string;
16
+ details?: ErrorDetail[];
17
+ };
18
+ }
19
+ export declare function isErrorCode(value: unknown): value is ErrorCode;
20
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,eAAO,MAAM,WAAW,6TAiBd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAiBjE,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE;QACL,IAAI,EAAE,SAAS,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;KACzB,CAAC;CACH;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D"}
package/dist/errors.js ADDED
@@ -0,0 +1,42 @@
1
+ /** Stable error codes defined in specs/ERRORS.md. */
2
+ export const ERROR_CODES = [
3
+ "VALIDATION_FAILED",
4
+ "PASSWORD_POLICY_VIOLATION",
5
+ "INVALID_CREDENTIALS",
6
+ "UNAUTHENTICATED",
7
+ "EMAIL_NOT_VERIFIED",
8
+ "ACCOUNT_UNAVAILABLE",
9
+ "FORBIDDEN",
10
+ "REAUTHENTICATION_REQUIRED",
11
+ "CSRF_FAILED",
12
+ "NOT_FOUND",
13
+ "TOKEN_INVALID",
14
+ "EMAIL_TAKEN",
15
+ "CONFLICT",
16
+ "RATE_LIMITED",
17
+ "PAYLOAD_TOO_LARGE",
18
+ "INTERNAL_ERROR",
19
+ ];
20
+ /** Recommended HTTP status per code (non-normative HTTP binding). */
21
+ export const ERROR_HTTP_STATUS = {
22
+ VALIDATION_FAILED: 400,
23
+ PASSWORD_POLICY_VIOLATION: 400,
24
+ INVALID_CREDENTIALS: 401,
25
+ UNAUTHENTICATED: 401,
26
+ EMAIL_NOT_VERIFIED: 403,
27
+ ACCOUNT_UNAVAILABLE: 403,
28
+ FORBIDDEN: 403,
29
+ REAUTHENTICATION_REQUIRED: 403,
30
+ CSRF_FAILED: 403,
31
+ NOT_FOUND: 404,
32
+ TOKEN_INVALID: 400,
33
+ EMAIL_TAKEN: 409,
34
+ CONFLICT: 409,
35
+ RATE_LIMITED: 429,
36
+ PAYLOAD_TOO_LARGE: 413,
37
+ INTERNAL_ERROR: 500,
38
+ };
39
+ export function isErrorCode(value) {
40
+ return typeof value === "string" && ERROR_CODES.includes(value);
41
+ }
42
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,mBAAmB;IACnB,2BAA2B;IAC3B,qBAAqB;IACrB,iBAAiB;IACjB,oBAAoB;IACpB,qBAAqB;IACrB,WAAW;IACX,2BAA2B;IAC3B,aAAa;IACb,WAAW;IACX,eAAe;IACf,aAAa;IACb,UAAU;IACV,cAAc;IACd,mBAAmB;IACnB,gBAAgB;CACR,CAAC;AAIX,qEAAqE;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAwC;IACpE,iBAAiB,EAAE,GAAG;IACtB,yBAAyB,EAAE,GAAG;IAC9B,mBAAmB,EAAE,GAAG;IACxB,eAAe,EAAE,GAAG;IACpB,kBAAkB,EAAE,GAAG;IACvB,mBAAmB,EAAE,GAAG;IACxB,SAAS,EAAE,GAAG;IACd,yBAAyB,EAAE,GAAG;IAC9B,WAAW,EAAE,GAAG;IAChB,SAAS,EAAE,GAAG;IACd,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,iBAAiB,EAAE,GAAG;IACtB,cAAc,EAAE,GAAG;CACpB,CAAC;AAiBF,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,WAAiC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzF,CAAC"}
@@ -0,0 +1,9 @@
1
+ import { type Requirement } from "./requirements.js";
2
+ /** Normative specification documents, in reading order. */
3
+ export declare const SPEC_FILES: readonly ["AUTHENTICATION_SPEC.md", "AUTHORIZATION_SPEC.md", "SECURITY_REQUIREMENTS.md", "DATA_MODEL.md", "ERRORS.md", "CONFIGURATION_SPEC.md", "CONFORMANCE.md", "OPTIONAL_CAPABILITIES.md"];
4
+ /** Absolute path of the bundled `specs/` directory. */
5
+ export declare const SPEC_DIR: string;
6
+ export declare function readSpecFile(name: (typeof SPEC_FILES)[number]): Promise<string>;
7
+ /** Parse every requirement defined in the bundled specification. */
8
+ export declare function loadRequirements(): Promise<Requirement[]>;
9
+ //# sourceMappingURL=files.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAExE,2DAA2D;AAC3D,eAAO,MAAM,UAAU,+LASb,CAAC;AAEX,uDAAuD;AACvD,eAAO,MAAM,QAAQ,QAAuD,CAAC;AAE7E,wBAAsB,YAAY,CAAC,IAAI,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAErF;AAED,oEAAoE;AACpE,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAK/D"}