@starklabs/forge 1.3.25-builtin-configs.0 → 2.0.0

package/dist/fields/zod.fields.d.ts

@@ -0,0 +1,181 @@
+import { z } from "zod";
+/**
+ * =========================
+ * STRING HELPERS
+ * =========================
+ */
+export declare const requiredString: z.ZodString;
+export declare const optionalEmptyString: z.ZodDefault<z.ZodString>;
+export declare const optionalString: z.ZodOptional<z.ZodString>;
+/**
+ * =========================
+ * EMAIL
+ * =========================
+ */
+export declare const email: z.ZodString;
+/**
+ * =========================
+ * PASSWORD
+ * =========================
+ */
+export declare const password: z.ZodString;
+/**
+ * =========================
+ * NUMBER HELPERS
+ * =========================
+ */
+export declare const requiredNumber: z.ZodCoercedNumber<unknown>;
+export declare const optionalNumber: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+/**
+ * =========================
+ * BOOLEAN HELPERS
+ * =========================
+ */
+export declare const boolean: z.ZodBoolean;
+export declare const booleanTrue: z.ZodDefault<z.ZodBoolean>;
+export declare const booleanFalse: z.ZodDefault<z.ZodBoolean>;
+/**
+ * =========================
+ * DATE
+ * =========================
+ */
+export declare const requiredDate: z.ZodCoercedDate<unknown>;
+export declare const optionalDate: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+export declare const dateNow: z.ZodDefault<z.ZodCoercedDate<unknown>>;
+/**
+ * =========================
+ * ARRAYS
+ * =========================
+ */
+export declare const stringArray: z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodString>>, unknown>;
+export declare const requiredStringArray: z.ZodPreprocess<z.ZodArray<z.ZodString>, unknown>;
+export declare const objectArray: z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodObject<{}, z.core.$strip>>>, unknown>;
+export declare const requiredObjectArray: (objSchema: z.ZodTypeAny) => z.ZodPreprocess<z.ZodArray<z.ZodTypeAny<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>, unknown>;
+/**
+ * =========================
+ * OBJECT ID / REFERENCES
+ * =========================
+ */
+export declare const objectId: z.ZodString;
+export declare const requiredObjectId: z.ZodString;
+export declare const userRef: z.ZodString;
+export declare const requiredUserRef: z.ZodString;
+export declare const userRefArray: z.ZodDefault<z.ZodArray<z.ZodString>>;
+/**
+ * =========================
+ * ENUMS
+ * =========================
+ */
+export declare const provider: z.ZodDefault<z.ZodEnum<{
+    amazon: "amazon";
+    apple: "apple";
+    discord: "discord";
+    dropbox: "dropbox";
+    facebook: "facebook";
+    github: "github";
+    gitlab: "gitlab";
+    google: "google";
+    linkedin: "linkedin";
+    local: "local";
+    microsoft: "microsoft";
+    slack: "slack";
+    spotify: "spotify";
+    twitch: "twitch";
+    x: "x";
+}>>;
+export declare const role: z.ZodDefault<z.ZodEnum<{
+    admin: "admin";
+    author: "author";
+    editor: "editor";
+    guest: "guest";
+    manager: "manager";
+    moderator: "moderator";
+    owner: "owner";
+    super_admin: "super_admin";
+    support: "support";
+    user: "user";
+}>>;
+/**
+ * =========================
+ * TIMESTAMPS
+ * =========================
+ */
+export declare const timestamps: {
+    createdAt: z.ZodDefault<z.ZodCoercedDate<unknown>>;
+    updatedAt: z.ZodDefault<z.ZodCoercedDate<unknown>>;
+};
+declare const object: (shape: Record<string, z.ZodTypeAny>) => z.ZodObject<{
+    [x: string]: z.ZodTypeAny<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}, z.core.$strip>;
+/**
+ * =========================
+ * EXPORT ALL
+ * =========================
+ */
+export declare const zodValidations: {
+    readonly requiredString: z.ZodString;
+    readonly optionalString: z.ZodOptional<z.ZodString>;
+    readonly optionalEmptyString: z.ZodDefault<z.ZodString>;
+    readonly email: z.ZodString;
+    readonly password: z.ZodString;
+    readonly requiredNumber: z.ZodCoercedNumber<unknown>;
+    readonly optionalNumber: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    readonly boolean: z.ZodBoolean;
+    readonly booleanTrue: z.ZodDefault<z.ZodBoolean>;
+    readonly booleanFalse: z.ZodDefault<z.ZodBoolean>;
+    readonly dateNow: z.ZodDefault<z.ZodCoercedDate<unknown>>;
+    readonly requiredDate: z.ZodCoercedDate<unknown>;
+    readonly optionalDate: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    readonly stringArray: z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodString>>, unknown>;
+    readonly requiredStringArray: z.ZodPreprocess<z.ZodArray<z.ZodString>, unknown>;
+    readonly objectArray: z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodObject<{}, z.core.$strip>>>, unknown>;
+    readonly requiredObjectArray: typeof requiredObjectArray;
+    readonly objectId: z.ZodString;
+    readonly requiredObjectId: z.ZodString;
+    readonly userRef: z.ZodString;
+    readonly requiredUserRef: z.ZodString;
+    readonly userRefArray: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    readonly timestamps: {
+        createdAt: z.ZodDefault<z.ZodCoercedDate<unknown>>;
+        updatedAt: z.ZodDefault<z.ZodCoercedDate<unknown>>;
+    };
+    readonly provider: z.ZodDefault<z.ZodEnum<{
+        amazon: "amazon";
+        apple: "apple";
+        discord: "discord";
+        dropbox: "dropbox";
+        facebook: "facebook";
+        github: "github";
+        gitlab: "gitlab";
+        google: "google";
+        linkedin: "linkedin";
+        local: "local";
+        microsoft: "microsoft";
+        slack: "slack";
+        spotify: "spotify";
+        twitch: "twitch";
+        x: "x";
+    }>>;
+    readonly object: typeof object;
+    readonly purposeOTP: z.ZodEnum<{
+        [x: string]: string;
+    }>;
+    readonly role: z.ZodDefault<z.ZodEnum<{
+        admin: "admin";
+        author: "author";
+        editor: "editor";
+        guest: "guest";
+        manager: "manager";
+        moderator: "moderator";
+        owner: "owner";
+        super_admin: "super_admin";
+        support: "support";
+        user: "user";
+    }>>;
+};
+export default zodValidations;
+type OnlyZodSchemas<T> = {
+    [K in keyof T as T[K] extends z.ZodTypeAny ? K : never]: T[K];
+};
+export type ZodValidation = OnlyZodSchemas<typeof zodValidations>[keyof OnlyZodSchemas<typeof zodValidations>];
+//# sourceMappingURL=zod.fields.d.ts.map

package/dist/fields/zod.fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.fields.d.ts","sourceRoot":"","sources":["../../src/fields/zod.fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;;GAIG;AAEH,eAAO,MAAM,cAAc,aAG4B,CAAC;AAExD,eAAO,MAAM,mBAAmB,2BAAgC,CAAC;AAEjE,eAAO,MAAM,cAAc,4BAA+B,CAAC;AAE3D;;;;GAIG;AAEH,eAAO,MAAM,KAAK,aAIe,CAAC;AAElC;;;;GAIG;AAEH,eAAO,MAAM,QAAQ,aAGiC,CAAC;AAEvD;;;;GAIG;AAEH,eAAO,MAAM,cAAc,6BAEiB,CAAC;AAE7C,eAAO,MAAM,cAAc,2CAA+B,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,OAAO,cAAc,CAAC;AACnC,eAAO,MAAM,WAAW,4BAA4B,CAAC;AACrD,eAAO,MAAM,YAAY,4BAA6B,CAAC;AAEvD;;;;GAIG;AAEH,eAAO,MAAM,YAAY,2BAAkB,CAAC;AAE5C,eAAO,MAAM,YAAY,0CAA6B,CAAC;AAEvD,eAAO,MAAM,OAAO,yCAA4C,CAAC;AAEjE;;;;GAIG;AAEH,eAAO,MAAM,WAAW,iEAaW,CAAC;AAEpC,eAAO,MAAM,mBAAmB,mDAkB/B,CAAC;AAEF,eAAO,MAAM,WAAW,oFAgBvB,CAAC;AAEF,eAAO,MAAM,mBAAmB,cAAe,CAAC,CAAC,UAAU,qHAmBxD,CAAC;AAEJ;;;;GAIG;AAEH,eAAO,MAAM,QAAQ,aAE4B,CAAC;AAElD,eAAO,MAAM,gBAAgB,aAAW,CAAC;AAEzC,eAAO,MAAM,OAAO,aAAW,CAAC;AAChC,eAAO,MAAM,eAAe,aAAW,CAAC;AAExC,eAAO,MAAM,YAAY,uCAAgC,CAAC;AAE1D;;;;GAIG;AAEH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;GAA2C,CAAC;AACjE,eAAO,MAAM,IAAI;;;;;;;;;;;GAAgC,CAAC;AAElD;;;;GAIG;AAEH,eAAO,MAAM,UAAU;IACrB,SAAS;IACT,SAAS;CACV,CAAC;AAGF,QAAA,MAAM,MAAM,UAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;;iBAElD,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BjB,CAAC;eAEI,cAAc;AAE7B,KAAK,cAAc,CAAC,CAAC,IAAI;KACtB,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;CAC9D,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,cAAc,CACxC,OAAO,cAAc,CACtB,CAAC,MAAM,cAAc,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC"}

package/dist/fields/zod.fields.js

@@ -0,0 +1,196 @@
+import { z } from "zod";
+import otpPurposes from "./otp.purposes.js";
+import { OAUTH_PROVIDERS } from "./oauth.providers.js";
+import { ROLES } from "./roles.js";
+/**
+ * =========================
+ * STRING HELPERS
+ * =========================
+ */
+export const requiredString = z
+    .string()
+    .trim()
+    .min(1, "At least 1 character in string is required");
+export const optionalEmptyString = z.string().trim().default("");
+export const optionalString = z.string().trim().optional();
+/**
+ * =========================
+ * EMAIL
+ * =========================
+ */
+export const email = z
+    .string()
+    .trim()
+    .toLowerCase()
+    .email("Invalid email address");
+/**
+ * =========================
+ * PASSWORD
+ * =========================
+ */
+export const password = z
+    .string()
+    .min(8, "Password must be at least 8 characters")
+    .max(128, "Password must be at most 128 characters");
+/**
+ * =========================
+ * NUMBER HELPERS
+ * =========================
+ */
+export const requiredNumber = z.coerce
+    .number()
+    .min(0.1, "Number must be 0.1 or greater");
+export const optionalNumber = z.coerce.number().default(0);
+/**
+ * =========================
+ * BOOLEAN HELPERS
+ * =========================
+ */
+export const boolean = z.boolean();
+export const booleanTrue = z.boolean().default(true);
+export const booleanFalse = z.boolean().default(false);
+/**
+ * =========================
+ * DATE
+ * =========================
+ */
+export const requiredDate = z.coerce.date();
+export const optionalDate = z.coerce.date().optional();
+export const dateNow = z.coerce.date().default(() => new Date());
+/**
+ * =========================
+ * ARRAYS
+ * =========================
+ */
+export const stringArray = z.preprocess((val) => {
+    if (Array.isArray(val))
+        return val;
+    if (typeof val === "string") {
+        try {
+            const parsed = JSON.parse(val);
+            if (Array.isArray(parsed))
+                return parsed;
+        }
+        catch (e) {
+            return val.split(",").map((v) => v.trim());
+        }
+    }
+    return [];
+}, z.array(z.string()).default([]));
+export const requiredStringArray = z.preprocess((val) => {
+    if (val === undefined || val === null)
+        return undefined;
+    if (Array.isArray(val))
+        return val;
+    if (typeof val === "string") {
+        try {
+            const parsed = JSON.parse(val);
+            if (Array.isArray(parsed))
+                return parsed;
+        }
+        catch {
+            return val.split(",").map((v) => v.trim());
+        }
+    }
+    return val;
+}, z.array(z.string()).min(1, "Array must have at least 1 element"));
+export const objectArray = z.preprocess((val) => {
+    if (Array.isArray(val))
+        return val;
+    if (typeof val === "string") {
+        try {
+            const parsed = JSON.parse(val);
+            if (Array.isArray(parsed))
+                return parsed;
+        }
+        catch (e) {
+            return [{}];
+        }
+    }
+    return [{}];
+}, z.array(z.object({})).default([{}]));
+export const requiredObjectArray = (objSchema) => z.preprocess((val) => {
+    if (val === undefined || val === null)
+        return undefined;
+    if (Array.isArray(val))
+        return val;
+    if (typeof val === "string") {
+        try {
+            const parsed = JSON.parse(val);
+            return Array.isArray(parsed) ? parsed : val;
+        }
+        catch {
+            return val;
+        }
+    }
+    return val;
+}, z.array(objSchema).min(1, `expected array of objects \`[{}]\``));
+/**
+ * =========================
+ * OBJECT ID / REFERENCES
+ * =========================
+ */
+export const objectId = z
+    .string()
+    .regex(/^[0-9a-fA-F]{24}$/, "Invalid ObjectId");
+export const requiredObjectId = objectId;
+export const userRef = objectId;
+export const requiredUserRef = objectId;
+export const userRefArray = z.array(objectId).default([]);
+/**
+ * =========================
+ * ENUMS
+ * =========================
+ */
+export const provider = z.enum(OAUTH_PROVIDERS).default("local");
+export const role = z.enum(ROLES).default("user");
+/**
+ * =========================
+ * TIMESTAMPS
+ * =========================
+ */
+export const timestamps = {
+    createdAt: dateNow,
+    updatedAt: dateNow,
+};
+// files
+const object = (shape) => {
+    return z.object(shape);
+};
+const purposeOTP = z.enum(otpPurposes);
+/**
+ * =========================
+ * EXPORT ALL
+ * =========================
+ */
+export const zodValidations = {
+    requiredString,
+    optionalString,
+    optionalEmptyString,
+    email,
+    password,
+    requiredNumber,
+    optionalNumber,
+    boolean,
+    booleanTrue,
+    booleanFalse,
+    dateNow,
+    requiredDate,
+    optionalDate,
+    stringArray,
+    requiredStringArray,
+    objectArray,
+    requiredObjectArray,
+    objectId,
+    requiredObjectId,
+    userRef,
+    requiredUserRef,
+    userRefArray,
+    timestamps,
+    provider,
+    object,
+    purposeOTP,
+    role,
+};
+export default zodValidations;
+//# sourceMappingURL=zod.fields.js.map

package/dist/fields/zod.fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.fields.js","sourceRoot":"","sources":["../../src/fields/zod.fields.ts"],"names":[],"mappings":"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"}

package/dist/health/HealthModule.d.ts

@@ -0,0 +1,10 @@
+import { FeatureModule, type HandlerFn } from "../core/FeatureModule.js";
+import type { AccessLevel } from "../types/Route.js";
+/** `type: "health"` collections: liveness and database readiness. */
+export declare class HealthModule extends FeatureModule {
+    readonly type = "health";
+    private readonly startedAt;
+    protected handlers(): Readonly<Record<string, HandlerFn>>;
+    protected defaultAuth(): AccessLevel;
+}
+//# sourceMappingURL=HealthModule.d.ts.map

package/dist/health/HealthModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthModule.d.ts","sourceRoot":"","sources":["../../src/health/HealthModule.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,qEAAqE;AACrE,qBAAa,YAAa,SAAQ,aAAa;IAC7C,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IAExC,SAAS,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAuBxD;IAED,UAAmB,WAAW,IAAI,WAAW,CAE5C;CACF"}

package/dist/health/HealthModule.js

@@ -0,0 +1,34 @@
+import { FeatureModule } from "../core/FeatureModule.js";
+/** `type: "health"` collections: liveness and database readiness. */
+export class HealthModule extends FeatureModule {
+    type = "health";
+    startedAt = Date.now();
+    handlers() {
+        const respond = async (req, res, _ctx) => {
+            const database = await this.services.data.ping();
+            const body = {
+                status: database ? "ok" : "degraded",
+                method: req.method,
+                uptimeSeconds: Math.round((Date.now() - this.startedAt) / 1000),
+                database: database ? "up" : "down",
+                timestamp: new Date().toISOString(),
+            };
+            res.status(database ? 200 : 503).json({
+                success: database,
+                message: database ? "Service is healthy." : "Service is degraded.",
+                data: body,
+            });
+        };
+        return {
+            healthGet: respond,
+            healthPost: respond,
+            healthPut: respond,
+            healthPatch: respond,
+            healthDelete: respond,
+        };
+    }
+    defaultAuth() {
+        return "public";
+    }
+}
+//# sourceMappingURL=HealthModule.js.map

package/dist/health/HealthModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthModule.js","sourceRoot":"","sources":["../../src/health/HealthModule.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAkB,MAAM,0BAA0B,CAAC;AAIzE,qEAAqE;AACrE,MAAM,OAAO,YAAa,SAAQ,aAAa;IACpC,IAAI,GAAG,QAAQ,CAAC;IACR,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE9B,QAAQ;QAChB,MAAM,OAAO,GAAc,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;YACnF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACjD,MAAM,IAAI,GAAG;gBACX,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU;gBACpC,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;gBAC/D,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM;gBAClC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;YACF,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACpC,OAAO,EAAE,QAAQ;gBACjB,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,sBAAsB;gBAClE,IAAI,EAAE,IAAI;aACX,CAAC,CAAC;QACL,CAAC,CAAC;QACF,OAAO;YACL,SAAS,EAAE,OAAO;YAClB,UAAU,EAAE,OAAO;YACnB,SAAS,EAAE,OAAO;YAClB,WAAW,EAAE,OAAO;YACpB,YAAY,EAAE,OAAO;SACtB,CAAC;IACJ,CAAC;IAEkB,WAAW;QAC5B,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/health/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./HealthModule.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/health/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/health/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/health/index.js

@@ -0,0 +1,2 @@
+export * from "./HealthModule.js";
+//# sourceMappingURL=index.js.map

package/dist/health/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/health/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/http/Authenticator.d.ts

@@ -0,0 +1,30 @@
+import type { Request, RequestHandler } from "express";
+import type { ForgeConfig } from "../config/ForgeConfig.js";
+import type { DataSource } from "../data/Repository.js";
+import type { TokenService } from "../security/TokenService.js";
+import type { AuthenticatedUser } from "../types/AuthenticatedUser.js";
+import type { AccessLevel } from "../types/Route.js";
+/**
+ * Resolves who is calling and enforces a route's access level.
+ *
+ * The access token is read from `Authorization: Bearer ...` first and from
+ * the access-token cookie second. It is never read from the request body.
+ */
+export declare class Authenticator {
+    private readonly config;
+    private readonly tokens;
+    private readonly data;
+    constructor(config: ForgeConfig, tokens: TokenService, data: DataSource);
+    isAdmin(user: AuthenticatedUser | undefined): boolean;
+    /** True when the user's role is exactly one of `roles`. */
+    hasAnyRole(user: AuthenticatedUser | undefined, roles: readonly string[]): boolean;
+    /**
+     * Middleware factory for one access level, optionally narrowed to specific roles.
+     * `public` routes get no guard. Authentication comes first, so an anonymous caller always gets 401, never 403.
+     */
+    require(level: AccessLevel, roles?: readonly string[]): RequestHandler;
+    authenticate(req: Request): Promise<AuthenticatedUser>;
+    private extractToken;
+    private userModelFromCollections;
+}
+//# sourceMappingURL=Authenticator.d.ts.map

package/dist/http/Authenticator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Authenticator.d.ts","sourceRoot":"","sources":["../../src/http/Authenticator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;GAKG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHvB,YACmB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,UAAU,EAC/B;IAEJ,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,SAAS,GAAG,OAAO,CAEpD;IAED,2DAA2D;IAC3D,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,SAAS,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAEjF;IAED;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,CAwBrE;IAEK,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgB3D;IAED,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,wBAAwB;CAGjC"}

package/dist/http/Authenticator.js

@@ -0,0 +1,84 @@
+import { ErrorCode, ForbiddenError, UnauthorizedError } from "../errors/index.js";
+/**
+ * Resolves who is calling and enforces a route's access level.
+ *
+ * The access token is read from `Authorization: Bearer ...` first and from
+ * the access-token cookie second. It is never read from the request body.
+ */
+export class Authenticator {
+    config;
+    tokens;
+    data;
+    constructor(config, tokens, data) {
+        this.config = config;
+        this.tokens = tokens;
+        this.data = data;
+    }
+    isAdmin(user) {
+        return Boolean(user?.role && this.config.adminRoles.includes(user.role));
+    }
+    /** True when the user's role is exactly one of `roles`. */
+    hasAnyRole(user, roles) {
+        return Boolean(user?.role && roles.includes(user.role));
+    }
+    /**
+     * Middleware factory for one access level, optionally narrowed to specific roles.
+     * `public` routes get no guard. Authentication comes first, so an anonymous caller always gets 401, never 403.
+     */
+    require(level, roles) {
+        if (level === "public")
+            return (_req, _res, next) => next();
+        return async (req, _res, next) => {
+            try {
+                req.user = await this.authenticate(req);
+                if (level === "admin" && !this.isAdmin(req.user)) {
+                    throw new ForbiddenError({
+                        message: "Administrator access is required.",
+                        code: ErrorCode.ADMIN_REQUIRED,
+                    });
+                }
+                if (roles && !this.hasAnyRole(req.user, roles)) {
+                    throw new ForbiddenError({
+                        message: "Your role is not allowed to do this.",
+                        code: ErrorCode.ROLE_NOT_ALLOWED,
+                        hint: `Allowed roles: ${roles.join(", ")}.`,
+                    });
+                }
+                next();
+            }
+            catch (error) {
+                next(error);
+            }
+        };
+    }
+    async authenticate(req) {
+        const claims = this.tokens.verifyAccess(this.extractToken(req));
+        if (!this.config.auth.verifyAccessUser)
+            return { _id: claims.sub };
+        const modelName = this.config.auth.mongooseConfig?.model ?? this.userModelFromCollections();
+        if (!modelName || !this.data.has(modelName))
+            return { _id: claims.sub };
+        const user = await this.data.repository(modelName).findById(claims.sub);
+        if (!user) {
+            throw new UnauthorizedError({
+                message: "The account for this token no longer exists.",
+                code: ErrorCode.ACCESS_USER_NOT_FOUND,
+            });
+        }
+        return { _id: user._id, role: typeof user.role === "string" ? user.role : undefined };
+    }
+    extractToken(req) {
+        const header = req.get("authorization");
+        if (header) {
+            const [scheme, value] = header.split(" ");
+            if (scheme?.toLowerCase() === "bearer" && value)
+                return value;
+        }
+        const cookie = req.cookies?.[this.config.auth.accessTokenName];
+        return typeof cookie === "string" ? cookie : undefined;
+    }
+    userModelFromCollections() {
+        return this.config.collections.find((c) => c.type === "auth" || c.type === "account")?.model;
+    }
+}
+//# sourceMappingURL=Authenticator.js.map

package/dist/http/Authenticator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Authenticator.js","sourceRoot":"","sources":["../../src/http/Authenticator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAMlF;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAEL,MAAM;IACN,MAAM;IACN,IAAI;IAHvB,YACmB,MAAmB,EACnB,MAAoB,EACpB,IAAgB;sBAFhB,MAAM;sBACN,MAAM;oBACN,IAAI;IACpB,CAAC;IAEJ,OAAO,CAAC,IAAmC;QACzC,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,2DAA2D;IAC3D,UAAU,CAAC,IAAmC,EAAE,KAAwB;QACtE,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,KAAkB,EAAE,KAAyB;QACnD,IAAI,KAAK,KAAK,QAAQ;YAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;QAE5D,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAC/B,IAAI,CAAC;gBACH,GAAG,CAAC,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;gBACxC,IAAI,KAAK,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACjD,MAAM,IAAI,cAAc,CAAC;wBACvB,OAAO,EAAE,mCAAmC;wBAC5C,IAAI,EAAE,SAAS,CAAC,cAAc;qBAC/B,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;oBAC/C,MAAM,IAAI,cAAc,CAAC;wBACvB,OAAO,EAAE,sCAAsC;wBAC/C,IAAI,EAAE,SAAS,CAAC,gBAAgB;wBAChC,IAAI,EAAE,kBAAkB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;qBAC5C,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,EAAE,CAAC;YACT,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,KAAK,CAAC,CAAC;YACd,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,GAAY;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;QAEhE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB;YAAE,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;QAEnE,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,IAAI,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAC5F,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;QAExE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACxE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,iBAAiB,CAAC;gBAC1B,OAAO,EAAE,8CAA8C;gBACvD,IAAI,EAAE,SAAS,CAAC,qBAAqB;aACtC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IACxF,CAAC;IAEO,YAAY,CAAC,GAAY;QAC/B,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACxC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1C,IAAI,MAAM,EAAE,WAAW,EAAE,KAAK,QAAQ,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAC;QAChE,CAAC;QACD,MAAM,MAAM,GAAI,GAAG,CAAC,OAA+C,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACxG,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,CAAC;IAEO,wBAAwB;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,KAAK,CAAC;IAC/F,CAAC;CACF"}

package/dist/http/ResponseWriter.d.ts

@@ -0,0 +1,21 @@
+import type { Response } from "express";
+export interface PageMeta {
+    page: number;
+    limit: number;
+    total: number;
+    pages: number;
+}
+export interface SuccessBody {
+    status?: number;
+    message: string;
+    data?: unknown;
+    meta?: PageMeta;
+    /** Extra top-level keys (e.g. tokens when `returnAccessToken` is enabled). */
+    extra?: Record<string, unknown>;
+}
+/** The one place that decides what a successful response looks like. */
+export declare class ResponseWriter {
+    success(res: Response, body: SuccessBody): void;
+    created(res: Response, body: Omit<SuccessBody, "status">): void;
+}
+//# sourceMappingURL=ResponseWriter.d.ts.map

package/dist/http/ResponseWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseWriter.d.ts","sourceRoot":"","sources":["../../src/http/ResponseWriter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,wEAAwE;AACxE,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAQ9C;IAED,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,IAAI,CAE9D;CACF"}

package/dist/http/ResponseWriter.js

@@ -0,0 +1,16 @@
+/** The one place that decides what a successful response looks like. */
+export class ResponseWriter {
+    success(res, body) {
+        res.status(body.status ?? 200).json({
+            success: true,
+            message: body.message,
+            ...(body.data !== undefined ? { data: body.data } : {}),
+            ...(body.meta ? { meta: body.meta } : {}),
+            ...body.extra,
+        });
+    }
+    created(res, body) {
+        this.success(res, { ...body, status: 201 });
+    }
+}
+//# sourceMappingURL=ResponseWriter.js.map

package/dist/http/ResponseWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseWriter.js","sourceRoot":"","sources":["../../src/http/ResponseWriter.ts"],"names":[],"mappings":"AAkBA,wEAAwE;AACxE,MAAM,OAAO,cAAc;IACzB,OAAO,CAAC,GAAa,EAAE,IAAiB;QACtC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;YAClC,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzC,GAAG,IAAI,CAAC,KAAK;SACd,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,GAAa,EAAE,IAAiC;QACtD,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9C,CAAC;CACF"}

package/dist/http/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./ResponseWriter.js";
+export * from "./Authenticator.js";
+export * from "./middleware/ErrorHandler.js";
+export * from "./middleware/RateLimiters.js";
+export * from "./middleware/OriginGuard.js";
+export * from "./middleware/InputSanitizer.js";
+export * from "./middleware/RequestContext.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC"}

package/dist/http/index.js

@@ -0,0 +1,8 @@
+export * from "./ResponseWriter.js";
+export * from "./Authenticator.js";
+export * from "./middleware/ErrorHandler.js";
+export * from "./middleware/RateLimiters.js";
+export * from "./middleware/OriginGuard.js";
+export * from "./middleware/InputSanitizer.js";
+export * from "./middleware/RequestContext.js";
+//# sourceMappingURL=index.js.map