@graphoria/server 0.2.3 → 0.3.0

package/dist/src/types/zod/configuration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../../../src/types/zod/configuration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCxB,CAAC"}
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../../../src/types/zod/configuration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCxB,CAAC"}

package/dist/src/utils/rateLimit.d.ts

@@ -0,0 +1,65 @@
+export type ConsumeResult = {
+    allowed: boolean;
+    retryAfterMs: number;
+};
+/**
+ * One method, everything per call: a role with its own limit shares the store
+ * with every other role rather than needing an instance of its own.
+ */
+export interface RateLimitStore {
+    consume(key: string, capacity: number, refillPerMs: number, ttlMs: number): Promise<ConsumeResult>;
+}
+export type MemoryRateLimitStoreOptions = {
+    now?: () => number;
+    maxKeys?: number;
+};
+export declare const createMemoryRateLimitStore: ({ now, maxKeys, }?: MemoryRateLimitStoreOptions) => RateLimitStore;
+export type RateLimitRedisClient = {
+    send(command: string, args: string[]): Promise<unknown>;
+};
+type RateLimitLogger = {
+    warn(obj: object, msg: string): void;
+};
+export type RedisRateLimitStoreOptions = {
+    now?: () => number;
+    log?: RateLimitLogger;
+};
+export declare const createRedisRateLimitStore: (client: RateLimitRedisClient, { now, log }?: RedisRateLimitStoreOptions) => RateLimitStore;
+export type RateLimitSettings = {
+    max: number;
+    anonymousMax: number;
+    windowMs: number;
+    trustProxy: boolean;
+};
+type RoleRateLimit = {
+    rateLimit?: {
+        max: number;
+        windowMs?: number;
+    } | undefined;
+};
+export type RateLimiter = {
+    check(session: {
+        role?: string | undefined;
+        sub?: string | undefined;
+    } | null, address: string | undefined): Promise<ConsumeResult>;
+};
+export type CreateRateLimiterOptions = {
+    settings: RateLimitSettings;
+    anonymousRole: string;
+    permissions?: Record<string, RoleRateLimit | undefined>;
+    /** A factory is only called once a limit is configured, so a disabled
+     * limiter never constructs a store — or a Redis client. */
+    store?: RateLimitStore | (() => RateLimitStore);
+};
+export declare const resolveClientAddress: (req: Request, server: {
+    requestIP(req: Request): {
+        address: string;
+    } | null;
+} | undefined, trustProxy: boolean) => string | undefined;
+/**
+ * `undefined` when nothing is configured, so the caller can skip the wrapper
+ * entirely and the shipped default costs nothing per request.
+ */
+export declare const createRateLimiter: ({ settings, anonymousRole, permissions, store, }: CreateRateLimiterOptions) => RateLimiter | undefined;
+export {};
+//# sourceMappingURL=rateLimit.d.ts.map

package/dist/src/utils/rateLimit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimit.d.ts","sourceRoot":"","sources":["../../../src/utils/rateLimit.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,aAAa,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CACL,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3B;AAID,MAAM,MAAM,2BAA2B,GAAG;IACxC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAIF,eAAO,MAAM,0BAA0B,uBAGpC,2BAA2B,KAAQ,cAuBrC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzD,CAAC;AAEF,KAAK,eAAe,GAAG;IAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAEhE,MAAM,MAAM,0BAA0B,GAAG;IACvC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,eAAe,CAAC;CACvB,CAAC;AAiBF,eAAO,MAAM,yBAAyB,WAC5B,oBAAoB,iBACoB,0BAA0B,KACzE,cAoCF,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,KAAK,aAAa,GAAG;IAAE,SAAS,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;CAAE,CAAC;AAEpF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,CACH,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,IAAI,EACvE,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC,CAAC;IACxD;+DAC2D;IAC3D,KAAK,CAAC,EAAE,cAAc,GAAG,CAAC,MAAM,cAAc,CAAC,CAAC;CACjD,CAAC;AAMF,eAAO,MAAM,oBAAoB,QAC1B,OAAO,UACJ;IAAE,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAAE,GAAG,SAAS,cAC/D,OAAO,KAClB,MAAM,GAAG,SAOX,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,qDAK3B,wBAAwB,KAAG,WAAW,GAAG,SAkC3C,CAAC"}

package/dist/src/utils/rateLimit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rateLimit.test.d.ts.map

package/dist/src/utils/rateLimit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimit.test.d.ts","sourceRoot":"","sources":["../../../src/utils/rateLimit.test.ts"],"names":[],"mappings":""}

package/dist/src/utils/responses.d.ts

@@ -13,6 +13,9 @@ export declare class S401 extends ClientResponse {
 export declare class S404 extends ClientResponse {
     constructor(body?: object | null, init?: ResponseInit);
 }
+export declare class S429 extends ClientResponse {
+    constructor(retryAfterMs: number);
+}
 export declare class S500 extends ClientResponse {
     constructor(body?: object | null, init?: ResponseInit);
 }

package/dist/src/utils/responses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../../src/utils/responses.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,YAAY,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,YAAY,EASpD;CACF;AAED,qBAAa,IAAK,SAAQ,cAAc;IACtC,YAAY,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,YAAY,EAEpD;CACF;AAED,qBAAa,IAAK,SAAQ,cAAc;IACtC,YAAY,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,YAAY,EAEpD;CACF;AAED,qBAAa,IAAK,SAAQ,cAAc;IACtC,YAAY,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,YAAY,EAEpD;CACF;AAED,qBAAa,IAAK,SAAQ,cAAc;IACtC,YAAY,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,YAAY,EAEpD;CACF;AAED,qBAAa,IAAK,SAAQ,cAAc;IACtC,YAAY,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,YAAY,EAEpD;CACF"}
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../../src/utils/responses.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,YAAY,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,YAAY,EASpD;CACF;AAED,qBAAa,IAAK,SAAQ,cAAc;IACtC,YAAY,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,YAAY,EAEpD;CACF;AAED,qBAAa,IAAK,SAAQ,cAAc;IACtC,YAAY,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,YAAY,EAEpD;CACF;AAED,qBAAa,IAAK,SAAQ,cAAc;IACtC,YAAY,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,YAAY,EAEpD;CACF;AAED,qBAAa,IAAK,SAAQ,cAAc;IACtC,YAAY,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,YAAY,EAEpD;CACF;AAED,qBAAa,IAAK,SAAQ,cAAc;IACtC,YAAY,YAAY,EAAE,MAAM,EAM/B;CACF;AAED,qBAAa,IAAK,SAAQ,cAAc;IACtC,YAAY,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,YAAY,EAEpD;CACF"}