ras-stack 0.1.0

package/dist/realtime/publisher.js

@@ -0,0 +1,176 @@
+export class CentrifugoPublisher {
+    options;
+    pending = new Map();
+    queue = [];
+    idleWaiters = new Set();
+    request;
+    maxConcurrentChannels;
+    maxPendingChannels;
+    active = 0;
+    closed = false;
+    constructor(options) {
+        this.options = options;
+        this.request = options.fetch ?? fetch;
+        this.maxConcurrentChannels = positiveInteger(options.maxConcurrentChannels ?? 8, 'maxConcurrentChannels');
+        this.maxPendingChannels = positiveInteger(options.maxPendingChannels ?? 1_024, 'maxPendingChannels');
+    }
+    publish(channel, data) {
+        if (!this.options.apiUrl)
+            return false;
+        if (this.closed) {
+            this.reportError(new Error('Realtime publisher is closed'), channel);
+            return false;
+        }
+        const pending = this.pending.get(channel);
+        if (pending) {
+            pending.dirty = true;
+            pending.data = data;
+            return true;
+        }
+        if (this.pending.size >= this.maxPendingChannels) {
+            this.reportError(new Error('Realtime publisher queue is full'), channel);
+            return false;
+        }
+        const state = { dirty: true, data, running: false };
+        this.pending.set(channel, state);
+        this.queue.push(channel);
+        this.pump();
+        return true;
+    }
+    idle() {
+        if (this.isIdle())
+            return Promise.resolve();
+        return new Promise((resolve) => this.idleWaiters.add(resolve));
+    }
+    async close() {
+        this.closed = true;
+        await this.idle();
+    }
+    pump() {
+        while (this.active < this.maxConcurrentChannels) {
+            const channel = this.queue.shift();
+            if (!channel)
+                break;
+            const state = this.pending.get(channel);
+            if (!state || state.running)
+                continue;
+            state.running = true;
+            this.active++;
+            void this.flush(channel, state).finally(() => {
+                this.active--;
+                this.pump();
+                this.resolveIdle();
+            });
+        }
+    }
+    async flush(channel, state) {
+        let failure;
+        try {
+            while (state.dirty) {
+                state.dirty = false;
+                // Publications for one channel must preserve mutation order.
+                // oxlint-disable-next-line no-await-in-loop
+                await this.deliver(channel, state.data);
+            }
+        }
+        catch (error) {
+            failure = error;
+        }
+        finally {
+            if (this.pending.get(channel) === state)
+                this.pending.delete(channel);
+        }
+        if (failure) {
+            if (state.dirty) {
+                this.pending.set(channel, { dirty: true, data: state.data, running: false });
+                this.queue.push(channel);
+                this.pump();
+            }
+            this.reportError(failure, channel);
+        }
+    }
+    async deliver(channel, data) {
+        const maxRetries = this.options.maxRetries ?? 3;
+        for (let retries = 0;; retries++) {
+            try {
+                // Retrying must finish before a later publication can overtake this one.
+                // oxlint-disable-next-line no-await-in-loop
+                await this.deliverOnce(channel, data);
+                return;
+            }
+            catch (error) {
+                if (!(error instanceof TransientPublishError))
+                    throw error;
+                if (retries >= maxRetries)
+                    throw error;
+                this.options.onRetry?.(error, channel);
+                // oxlint-disable-next-line no-await-in-loop
+                await new Promise((resolve) => setTimeout(resolve, this.options.retryMs ?? 1_000));
+            }
+        }
+    }
+    async deliverOnce(channel, data) {
+        let response;
+        try {
+            response = await this.request(`${this.options.apiUrl.replace(/\/$/, '')}/publish`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', 'X-API-Key': this.options.apiKey },
+                body: JSON.stringify({ channel, data }),
+                signal: AbortSignal.timeout(this.options.timeoutMs ?? 5_000),
+            });
+        }
+        catch (error) {
+            if (error instanceof TypeError || isTimeout(error))
+                throw new TransientPublishError('Realtime publish request failed', { cause: error });
+            throw error;
+        }
+        if (!response.ok) {
+            const message = `Realtime publish failed with status ${response.status}`;
+            if (response.status >= 500 || response.status === 429)
+                throw new TransientPublishError(message);
+            throw new Error(message);
+        }
+        const result = await response.json();
+        const error = centrifugoError(result);
+        if (!error)
+            return;
+        const message = `Realtime publish failed: ${error.message ?? `code ${error.code ?? 'unknown'}`}`;
+        if (error.code === 100)
+            throw new TransientPublishError(message);
+        throw new Error(message);
+    }
+    reportError(error, channel) {
+        try {
+            this.options.onError(error, channel);
+        }
+        catch { }
+    }
+    isIdle() {
+        return this.pending.size === 0 && this.active === 0 && this.queue.length === 0;
+    }
+    resolveIdle() {
+        if (!this.isIdle())
+            return;
+        for (const resolve of this.idleWaiters)
+            resolve();
+        this.idleWaiters.clear();
+    }
+}
+class TransientPublishError extends Error {
+}
+function isTimeout(error) {
+    return error instanceof DOMException && error.name === 'TimeoutError';
+}
+function centrifugoError(result) {
+    if (!result || typeof result !== 'object' || !('error' in result) || !result.error || typeof result.error !== 'object')
+        return undefined;
+    const code = 'code' in result.error && typeof result.error.code === 'number' ? result.error.code : undefined;
+    const message = 'message' in result.error && typeof result.error.message === 'string' ? result.error.message : undefined;
+    return { ...(code === undefined ? {} : { code }), ...(message === undefined ? {} : { message }) };
+}
+function positiveInteger(value, name) {
+    if (!Number.isSafeInteger(value) || value < 1)
+        throw new RangeError(`${name} must be a positive integer`);
+    return value;
+}
+//# sourceMappingURL=publisher.js.map

package/dist/realtime/publisher.js.map

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

package/dist/realtime/tokens.d.ts

@@ -0,0 +1,6 @@
+export type RealtimeTokenOptions = {
+    secret: string;
+    now?: number;
+    ttlSeconds?: number;
+};
+export declare function signRealtimeToken(subject: string, claims: Record<string, unknown>, options: RealtimeTokenOptions): string;

package/dist/realtime/tokens.js

@@ -0,0 +1,13 @@
+import crypto from 'node:crypto';
+export function signRealtimeToken(subject, claims, options) {
+    const now = options.now ?? Math.floor(Date.now() / 1000);
+    return sign({ ...claims, sub: subject, exp: now + (options.ttlSeconds ?? 5 * 60) }, options.secret);
+}
+function sign(payload, secret) {
+    const header = Buffer.from(JSON.stringify({ alg: 'HS256', typ: 'JWT' })).toString('base64url');
+    const claims = Buffer.from(JSON.stringify(payload)).toString('base64url');
+    const unsigned = `${header}.${claims}`;
+    const signature = crypto.createHmac('sha256', secret).update(unsigned).digest('base64url');
+    return `${unsigned}.${signature}`;
+}
+//# sourceMappingURL=tokens.js.map

package/dist/realtime/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/realtime/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAA;AAQhC,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,MAA+B,EAAE,OAA6B;IAC/G,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;IACxD,OAAO,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;AACrG,CAAC;AAED,SAAS,IAAI,CAAC,OAAgC,EAAE,MAAc;IAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;IAC9F,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;IACzE,MAAM,QAAQ,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAA;IACtC,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAC1F,OAAO,GAAG,QAAQ,IAAI,SAAS,EAAE,CAAA;AACnC,CAAC"}

package/dist/server/canonical-host.d.ts

@@ -0,0 +1,5 @@
+export type CanonicalRedirectOptions = {
+    canonicalUrl?: string;
+    pathsServedOnAnyHost?: ReadonlySet<string>;
+};
+export declare function canonicalRedirect(requestUrl: string, options: CanonicalRedirectOptions): string | null;

package/dist/server/canonical-host.js

@@ -0,0 +1,15 @@
+export function canonicalRedirect(requestUrl, options) {
+    if (!options.canonicalUrl?.trim())
+        return null;
+    try {
+        const canonical = new URL(options.canonicalUrl);
+        const incoming = new URL(requestUrl);
+        if (incoming.host === canonical.host || options.pathsServedOnAnyHost?.has(incoming.pathname))
+            return null;
+        return new URL(incoming.pathname + incoming.search + incoming.hash, canonical.origin).toString();
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=canonical-host.js.map

package/dist/server/canonical-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-host.js","sourceRoot":"","sources":["../../src/server/canonical-host.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,OAAiC;IACrF,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,EAAE;QAAE,OAAO,IAAI,CAAA;IAC9C,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;QAC/C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAA;QACpC,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC,oBAAoB,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAA;QACzG,OAAO,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAA;IAClG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/server/health.d.ts

@@ -0,0 +1,4 @@
+export type HealthResponseOptions = {
+    errorMessage?: (error: unknown) => string;
+};
+export declare function healthResponse(check: () => Promise<void> | void, options?: HealthResponseOptions): Promise<Response>;

package/dist/server/health.js

@@ -0,0 +1,10 @@
+export async function healthResponse(check, options = {}) {
+    try {
+        await check();
+        return Response.json({ ok: true });
+    }
+    catch (error) {
+        return Response.json({ ok: false, error: options.errorMessage?.(error) ?? 'health check failed' }, { status: 503 });
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/server/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/server/health.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAiC,EAAE,OAAO,GAA0B,EAAE;IACzG,IAAI,CAAC;QACH,MAAM,KAAK,EAAE,CAAA;QACb,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,IAAI,qBAAqB,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;IACrH,CAAC;AACH,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,3 @@
+export * from './canonical-host.js';
+export * from './health.js';
+export * from './rpc.js';

package/dist/server/index.js

@@ -0,0 +1,4 @@
+export * from './canonical-host.js';
+export * from './health.js';
+export * from './rpc.js';
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA"}

package/dist/server/rpc.d.ts

@@ -0,0 +1,13 @@
+export type RpcLogger = (error: unknown, context: {
+    method?: string;
+    path?: string;
+}) => void;
+export type RpcOptions = {
+    getRequest?: () => Request;
+    requireMutation?: (request: Request) => void;
+    logError?: RpcLogger;
+};
+export declare function createRpc(options?: RpcOptions): {
+    rpc: <T>(work: () => Promise<T> | T) => Promise<T>;
+    mutationRpc: <T>(work: () => Promise<T> | T, request?: Request | undefined) => Promise<T>;
+};

package/dist/server/rpc.js

@@ -0,0 +1,32 @@
+export function createRpc(options = {}) {
+    async function rpc(work) {
+        try {
+            return await work();
+        }
+        catch (error) {
+            if (error instanceof Response)
+                throw new Error((await error.text()) || `request failed (${error.status})`, { cause: error });
+            options.logError?.(error, requestContext(options.getRequest));
+            throw error;
+        }
+    }
+    function mutationRpc(work, request = options.getRequest?.()) {
+        return rpc(() => {
+            if (!request)
+                throw new Error('mutation request is unavailable');
+            options.requireMutation?.(request);
+            return work();
+        });
+    }
+    return { rpc, mutationRpc };
+}
+function requestContext(getRequest) {
+    try {
+        const request = getRequest?.();
+        return request ? { method: request.method, path: new URL(request.url).pathname } : {};
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=rpc.js.map

package/dist/server/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/server/rpc.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,SAAS,CAAC,OAAO,GAAe,EAAE;IAChD,KAAK,UAAU,GAAG,CAAI,IAA0B;QAC9C,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,EAAE,CAAA;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,mBAAmB,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;YAC5H,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAA;YAC7D,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED,SAAS,WAAW,CAAI,IAA0B,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,EAAE;QAClF,OAAO,GAAG,CAAC,GAAG,EAAE;YACd,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;YAChE,OAAO,CAAC,eAAe,EAAE,CAAC,OAAO,CAAC,CAAA;YAClC,OAAO,IAAI,EAAE,CAAA;QACf,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,CAAA;AAC7B,CAAC;AAED,SAAS,cAAc,CAAC,UAAuC;IAC7D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,UAAU,EAAE,EAAE,CAAA;QAC9B,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACvF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC"}

package/dist/uploads/index.d.ts

@@ -0,0 +1,30 @@
+import { Upload, type UploadOptions } from 'tus-js-client';
+export type TusUploadProgress = {
+    sent: number;
+    total: number;
+    percent: number;
+};
+export type TusUploadOptions = {
+    endpoint: string;
+    file: File;
+    metadata: Record<string, string>;
+    chunkSize?: number;
+    retryDelays?: readonly number[];
+    fingerprint?: UploadOptions['fingerprint'];
+    removeFingerprintOnSuccess?: boolean;
+    shouldRetry?: (status: number | undefined, retryAttempt: number) => boolean;
+    onProgress?: (progress: TusUploadProgress) => void;
+};
+export type TusUploadResult = {
+    responseBody: string;
+    responseStatus: number | undefined;
+    uploadUrl: string | null;
+};
+export declare function createTusUpload(options: TusUploadOptions): Upload;
+export declare function startTusUpload(upload: Upload, resume?: boolean): Promise<TusUploadResult>;
+export declare function uploadWithTus(options: TusUploadOptions, resume?: boolean): Promise<TusUploadResult>;
+export declare function tusResponseMessage(error: unknown): string | undefined;
+export declare function tusResponse(error: unknown): {
+    status: number | undefined;
+    body: string;
+} | undefined;

package/dist/uploads/index.js

@@ -0,0 +1,77 @@
+import { defaultOptions, Upload } from 'tus-js-client';
+export function createTusUpload(options) {
+    return new Upload(options.file, {
+        endpoint: options.endpoint,
+        metadata: options.metadata,
+        retryDelays: [...(options.retryDelays ?? [0, 1_000, 3_000, 5_000])],
+        ...(options.chunkSize === undefined ? {} : { chunkSize: options.chunkSize }),
+        ...(options.fingerprint === undefined ? {} : { fingerprint: options.fingerprint }),
+        ...(options.removeFingerprintOnSuccess === undefined ? {} : { removeFingerprintOnSuccess: options.removeFingerprintOnSuccess }),
+        onShouldRetry: (error, retryAttempt, uploadOptions) => {
+            const status = error.originalResponse?.getStatus();
+            if (options.shouldRetry && !options.shouldRetry(status, retryAttempt))
+                return false;
+            return defaultOptions.onShouldRetry?.(error, retryAttempt, uploadOptions) === true;
+        },
+        onProgress: (sent, total) => options.onProgress?.({ sent, total, percent: total ? Math.round((sent / total) * 100) : 0 }),
+    });
+}
+export async function startTusUpload(upload, resume = true) {
+    if (resume) {
+        const previous = await upload.findPreviousUploads();
+        if (previous[0])
+            upload.resumeFromPreviousUpload(previous[0]);
+    }
+    return new Promise((resolve, reject) => {
+        const previousError = upload.options.onError;
+        const previousSuccess = upload.options.onSuccess;
+        upload.options.onError = (error) => {
+            try {
+                previousError?.(error);
+            }
+            finally {
+                reject(error);
+            }
+        };
+        upload.options.onSuccess = (event) => {
+            try {
+                previousSuccess?.(event);
+                resolve({
+                    responseBody: event.lastResponse.getBody(),
+                    responseStatus: event.lastResponse.getStatus(),
+                    uploadUrl: upload.url,
+                });
+            }
+            catch (error) {
+                reject(error);
+            }
+        };
+        upload.start();
+    });
+}
+export function uploadWithTus(options, resume = true) {
+    return startTusUpload(createTusUpload(options), resume);
+}
+export function tusResponseMessage(error) {
+    const response = responseFromError(error);
+    if (response)
+        return response.body;
+    const message = error instanceof Error ? error.message : undefined;
+    return message ? /response text: ([^,]+)/.exec(message)?.[1]?.trim() : undefined;
+}
+export function tusResponse(error) {
+    return responseFromError(error);
+}
+function responseFromError(error) {
+    if (!error || typeof error !== 'object' || !('originalResponse' in error))
+        return undefined;
+    const response = error.originalResponse;
+    if (!response || typeof response !== 'object' || !('getStatus' in response) || !('getBody' in response))
+        return undefined;
+    if (typeof response.getStatus !== 'function' || typeof response.getBody !== 'function')
+        return undefined;
+    const status = response.getStatus();
+    const body = response.getBody();
+    return { status: typeof status === 'number' ? status : undefined, body: typeof body === 'string' ? body : '' };
+}
+//# sourceMappingURL=index.js.map

package/dist/uploads/index.js.map

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

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "ras-stack",
+  "version": "0.1.0",
+  "description": "Composable full-stack primitives shared across Richard Solomou's applications.",
+  "keywords": [
+    "authentication",
+    "centrifugo",
+    "fullstack",
+    "tanstack",
+    "tus"
+  ],
+  "homepage": "https://github.com/richardsolomou/ras-stack#readme",
+  "bugs": "https://github.com/richardsolomou/ras-stack/issues",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/richardsolomou/ras-stack.git"
+  },
+  "files": [
+    "dist",
+    "config"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    "./auth": {
+      "types": "./dist/auth/index.d.ts",
+      "default": "./dist/auth/index.js"
+    },
+    "./email": {
+      "types": "./dist/email/index.d.ts",
+      "default": "./dist/email/index.js"
+    },
+    "./realtime": {
+      "types": "./dist/realtime/index.d.ts",
+      "default": "./dist/realtime/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "default": "./dist/server/index.js"
+    },
+    "./uploads": {
+      "types": "./dist/uploads/index.d.ts",
+      "default": "./dist/uploads/index.js"
+    },
+    "./config/oxlint": "./config/oxlint.json",
+    "./config/typescript/browser": "./config/typescript/browser.json",
+    "./config/typescript/library": "./config/typescript/library.json",
+    "./config/typescript/tanstack": "./config/typescript/tanstack.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "config:check": "tsc -p test/config-consumer/tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint --type-aware --deny-warnings .",
+    "format": "oxfmt --write .",
+    "format:check": "oxfmt --check .",
+    "test": "vitest run",
+    "check": "pnpm format:check && pnpm lint && pnpm config:check && pnpm typecheck && pnpm test && pnpm build"
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.0",
+    "@types/nodemailer": "^8.0.1",
+    "nodemailer": "^9.0.3",
+    "oxfmt": "^0.59.0",
+    "oxlint": "^1.74.0",
+    "oxlint-tsgolint": "^7.0.2001",
+    "tus-js-client": "^4.3.1",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
+  },
+  "peerDependencies": {
+    "nodemailer": ">=9 <10",
+    "tus-js-client": ">=4 <5"
+  },
+  "peerDependenciesMeta": {
+    "nodemailer": {
+      "optional": true
+    },
+    "tus-js-client": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=24 <25"
+  },
+  "packageManager": "pnpm@11.15.0"
+}