@moxon/api 6.0.0-pre

package/dist/modules/v5/captcha.d.ts

@@ -0,0 +1,27 @@
+import type { ChallengeStorage } from '../../types/storage.js';
+import type { ChallengeVerification } from '../../utils/challenge.js';
+import type { CaptchaOptions } from '../v4/captcha.js';
+export interface CaptchaChallenge {
+    contentType: string;
+    body: Buffer;
+    token: string;
+}
+/**
+ * Generates a hardened captcha whose answer is bound to a signed token instead
+ * of being returned in clear. The answer lives only inside the HMAC, so the
+ * caller holds a token it cannot read the solution from.
+ *
+ * @param options - Captcha configuration options
+ * @returns PNG buffer, content type, and the token to verify the answer against
+ * @throws Error if any option is out of the accepted range
+ */
+export default function captchaChallenge(options: CaptchaOptions): CaptchaChallenge;
+/**
+ * Verifies a captcha answer against its token, then consumes the token.
+ *
+ * @param token - Token issued alongside the challenge image
+ * @param answer - Answer read by the user, compared case-insensitively
+ * @param storage - Store of already consumed nonces
+ * @returns Verification result, with a reason when it fails
+ */
+export declare function verifyCaptcha(token: string, answer: string, storage: ChallengeStorage): ChallengeVerification;

package/dist/modules/v5/captcha.js

@@ -0,0 +1,136 @@
+import { createCanvas } from 'canvas';
+import { signToken, verifyToken } from '../../utils/challenge.js';
+import { normalizeColor } from '../../utils/colors.js';
+const NOISE_LEVELS = new Set(['low', 'medium', 'high']);
+const NOISE_CONFIG = { low: { lines: 8, dots: 80 }, medium: { lines: 25, dots: 300 }, high: { lines: 50, dots: 600 } };
+const CHARSET = 'ABCDEFGHJKLMNPQRSTUVWXYZabcdefghjkmnpqrstuvwxyz23456789';
+const FONTS = ['sans-serif', 'serif', 'monospace', 'cursive'];
+const STYLES = ['', 'bold ', 'italic ', 'bold italic '];
+function generateText(length) {
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        result += CHARSET[Math.floor(Math.random() * CHARSET.length)];
+    }
+    return result;
+}
+function clamp(value, name, def, min, max) {
+    if (value === undefined)
+        return def;
+    if (isNaN(value))
+        throw new Error(`${name} must be a number`);
+    if (value < min || value > max)
+        throw new Error(`${name} must be between ${min} and ${max}`);
+    return Math.floor(value);
+}
+const muted = () => `rgb(${Math.floor(Math.random() * 180)}, ${Math.floor(Math.random() * 180)}, ${Math.floor(Math.random() * 180)})`;
+/**
+ * Renders a CAPTCHA hardened against OCR: glyphs overlap so they cannot be
+ * segmented, ride a sine baseline with per-character shear, mix font families,
+ * and are crossed by occlusion strokes drawn in the same colours as the text so
+ * no colour filter can separate them. Reserved for challenge mode, where the
+ * answer never leaves the server; the generator mode keeps the milder rendering.
+ *
+ * @param options - Captcha configuration options
+ * @returns Object containing the PNG buffer, content type, and the challenge text
+ * @throws Error if any option is out of the accepted range
+ */
+function hardened(options) {
+    const text = options.text || generateText(clamp(options.length, 'length', 6, 1, 20));
+    const height = clamp(options.height, 'height', 120, 50, 400);
+    const width = clamp(options.width, 'width', text.length * 60, 100, 800);
+    const noise = options.noise ?? 'medium';
+    if (!NOISE_LEVELS.has(noise))
+        throw new Error('Noise must be one of: low, medium, high');
+    const { lines, dots } = NOISE_CONFIG[noise];
+    const bg = normalizeColor(options.bg, '#ffffff');
+    const baseColor = options.color ? normalizeColor(options.color, '#000000') : undefined;
+    const canvas = createCanvas(width, height);
+    const ctx = canvas.getContext('2d');
+    ctx.fillStyle = bg;
+    ctx.fillRect(0, 0, width, height);
+    for (let i = 0; i < lines; i++) {
+        ctx.strokeStyle = `rgba(${Math.floor(Math.random() * 180)}, ${Math.floor(Math.random() * 180)}, ${Math.floor(Math.random() * 180)}, ${0.3 + Math.random() * 0.4})`;
+        ctx.beginPath();
+        ctx.moveTo(Math.random() * width, Math.random() * height);
+        ctx.bezierCurveTo(Math.random() * width, Math.random() * height, Math.random() * width, Math.random() * height, Math.random() * width, Math.random() * height);
+        ctx.lineWidth = 1 + Math.random() * 2;
+        ctx.stroke();
+    }
+    const baseFontSize = Math.floor(height * 0.5);
+    const charWidth = width / (text.length * 0.68 + 0.6);
+    for (let i = 0; i < Math.floor(text.length * 1.5); i++) {
+        const size = Math.floor(baseFontSize * (0.4 + Math.random() * 0.3));
+        ctx.font = `${size}px ${FONTS[Math.floor(Math.random() * FONTS.length)]}`;
+        ctx.fillStyle = `rgba(${Math.floor(Math.random() * 180)}, ${Math.floor(Math.random() * 180)}, ${Math.floor(Math.random() * 180)}, ${0.15 + Math.random() * 0.15})`;
+        ctx.fillText(CHARSET[Math.floor(Math.random() * CHARSET.length)], Math.random() * width, Math.random() * height);
+    }
+    const phase = Math.random() * Math.PI * 2;
+    const freq = 0.6 + Math.random() * 0.8;
+    const colors = [];
+    let x = charWidth * 0.25;
+    for (let i = 0; i < text.length; i++) {
+        const size = Math.floor(baseFontSize * (0.8 + Math.random() * 0.4));
+        const y = height / 2 + Math.sin(phase + i * freq) * height * 0.12;
+        const color = baseColor ?? muted();
+        colors.push(color);
+        ctx.font = `${STYLES[Math.floor(Math.random() * STYLES.length)]}${size}px ${FONTS[Math.floor(Math.random() * FONTS.length)]}`;
+        ctx.save();
+        ctx.translate(x + charWidth / 2, y);
+        ctx.rotate((Math.random() - 0.5) * 1.2);
+        ctx.transform(1, (Math.random() - 0.5) * 0.4, (Math.random() - 0.5) * 0.6, 1, 0, 0);
+        if (i % 3 === 1) {
+            ctx.strokeStyle = color;
+            ctx.lineWidth = Math.max(1, size * 0.04);
+            ctx.strokeText(text[i], -charWidth / 2, 0);
+        }
+        else {
+            ctx.fillStyle = color;
+            ctx.fillText(text[i], -charWidth / 2, 0);
+        }
+        ctx.restore();
+        x += charWidth * (0.55 + Math.random() * 0.15);
+    }
+    for (let i = 0; i < 2 + Math.floor(Math.random() * 3); i++) {
+        ctx.strokeStyle = colors[Math.floor(Math.random() * colors.length)];
+        ctx.lineWidth = Math.max(1, baseFontSize * 0.05);
+        ctx.beginPath();
+        const band = () => height * 0.3 + Math.random() * height * 0.4;
+        ctx.moveTo(0, band());
+        ctx.bezierCurveTo(width * 0.3, band(), width * 0.6, band(), width, band());
+        ctx.stroke();
+    }
+    for (let i = 0; i < dots; i++) {
+        ctx.fillStyle =
+            Math.random() < 0.5
+                ? colors[Math.floor(Math.random() * colors.length)]
+                : `rgba(${Math.floor(Math.random() * 180)}, ${Math.floor(Math.random() * 180)}, ${Math.floor(Math.random() * 180)}, ${0.4 + Math.random() * 0.5})`;
+        const dotSize = 1 + Math.random() * 2;
+        ctx.fillRect(Math.floor(Math.random() * width), Math.floor(Math.random() * height), dotSize, dotSize);
+    }
+    return { contentType: 'image/png', body: canvas.toBuffer('image/png'), text };
+}
+/**
+ * Generates a hardened captcha whose answer is bound to a signed token instead
+ * of being returned in clear. The answer lives only inside the HMAC, so the
+ * caller holds a token it cannot read the solution from.
+ *
+ * @param options - Captcha configuration options
+ * @returns PNG buffer, content type, and the token to verify the answer against
+ * @throws Error if any option is out of the accepted range
+ */
+export default function captchaChallenge(options) {
+    const { contentType, body, text } = hardened(options);
+    return { contentType, body, token: signToken('img', text.toLowerCase()) };
+}
+/**
+ * Verifies a captcha answer against its token, then consumes the token.
+ *
+ * @param token - Token issued alongside the challenge image
+ * @param answer - Answer read by the user, compared case-insensitively
+ * @param storage - Store of already consumed nonces
+ * @returns Verification result, with a reason when it fails
+ */
+export function verifyCaptcha(token, answer, storage) {
+    return verifyToken(token, answer.trim().toLowerCase(), storage);
+}
+//# sourceMappingURL=captcha.js.map

package/dist/modules/v5/captcha.js.map

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

package/dist/modules/v5/case.d.ts

@@ -0,0 +1,10 @@
+export interface CaseResult {
+    text: string;
+    to: string;
+    result: string;
+}
+/**
+ * Converts text to the specified case format.
+ * Supports: camel, pascal, snake, kebab, constant, title, sentence, upper, lower.
+ */
+export default function caseConvert(text: string, to?: string): CaseResult;

package/dist/modules/v5/case.js

@@ -0,0 +1,57 @@
+import { MAX_STRING_LENGTH } from '../../constants.js';
+const VALID_TARGETS = ['camel', 'pascal', 'snake', 'kebab', 'constant', 'title', 'sentence', 'upper', 'lower'];
+const capitalize = (w) => w.charAt(0).toUpperCase() + w.slice(1);
+const tokenize = (text) => text
+    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+    .replace(/[_\-.]+/g, ' ')
+    .trim()
+    .split(/\s+/)
+    .filter(Boolean)
+    .map((w) => w.toLowerCase());
+/**
+ * Converts text to the specified case format.
+ * Supports: camel, pascal, snake, kebab, constant, title, sentence, upper, lower.
+ */
+export default function caseConvert(text, to = 'camel') {
+    if (!text)
+        throw new Error('Please provide a text (?text={text})');
+    if (text.length > MAX_STRING_LENGTH)
+        throw new Error(`Text cannot exceed ${MAX_STRING_LENGTH} characters`);
+    if (!VALID_TARGETS.includes(to))
+        throw new Error(`Invalid target case. Valid values: ${VALID_TARGETS.join(', ')}`);
+    const words = tokenize(text);
+    if (words.length === 0)
+        throw new Error('Text must contain at least one alphanumeric character');
+    let result;
+    switch (to) {
+        case 'camel':
+            result = words[0] + words.slice(1).map(capitalize).join('');
+            break;
+        case 'pascal':
+            result = words.map(capitalize).join('');
+            break;
+        case 'snake':
+            result = words.join('_');
+            break;
+        case 'kebab':
+            result = words.join('-');
+            break;
+        case 'constant':
+            result = words.join('_').toUpperCase();
+            break;
+        case 'title':
+            result = words.map(capitalize).join(' ');
+            break;
+        case 'sentence':
+            result = capitalize(words[0]) + (words.length > 1 ? ' ' + words.slice(1).join(' ') : '');
+            break;
+        case 'upper':
+            result = text.toUpperCase();
+            break;
+        case 'lower':
+            result = text.toLowerCase();
+            break;
+    }
+    return { text, to, result: result };
+}
+//# sourceMappingURL=case.js.map

package/dist/modules/v5/case.js.map

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

package/dist/modules/v5/chart.d.ts

@@ -0,0 +1,53 @@
+export type ChartOutput = {
+    contentType: 'image/svg+xml';
+    body: string;
+} | {
+    contentType: 'application/json';
+    body: Record<string, unknown>;
+};
+interface ChartOptions {
+    title?: unknown;
+    width?: unknown;
+    height?: unknown;
+    colors?: unknown;
+    bg?: unknown;
+    legend?: unknown;
+    mode?: unknown;
+}
+/**
+ * Renders a bar chart as SVG or returns its raw data.
+ *
+ * @param data - Chart data with labels and one or more datasets (each with a name and values array)
+ * @param options - Chart options: title, width, height, colors, bg, legend (default true), mode ("svg" or "data")
+ * @returns ChartOutput with contentType image/svg+xml (SVG string) or application/json (raw data) depending on mode
+ * @throws Error if data is missing, malformed, or exceeds the maximum number of labels or datasets
+ */
+export declare function bar(data: unknown, options: ChartOptions): ChartOutput;
+/**
+ * Renders a line chart as SVG or returns its raw data.
+ *
+ * @param data - Chart data with labels and one or more datasets (each with a name and values array)
+ * @param options - Chart options: title, width, height, colors, bg, legend (default true), mode ("svg" or "data")
+ * @returns ChartOutput with contentType image/svg+xml (SVG string) or application/json (raw data) depending on mode
+ * @throws Error if data is missing, malformed, or exceeds the maximum number of labels or datasets
+ */
+export declare function line(data: unknown, options: ChartOptions): ChartOutput;
+/**
+ * Renders a pie chart as SVG or returns its raw data.
+ *
+ * @param data - Chart data with labels and a single dataset (each with a name and values array)
+ * @param options - Chart options: title, width, height, colors, bg, legend (default true), mode ("svg" or "data")
+ * @returns ChartOutput with contentType image/svg+xml (SVG string) or application/json (raw data) depending on mode
+ * @throws Error if data is missing, malformed, or exceeds the maximum number of labels or datasets
+ */
+export declare function pie(data: unknown, options: ChartOptions): ChartOutput;
+/**
+ * Renders a donut chart as SVG or returns its raw data.
+ *
+ * @param data - Chart data with labels and a single dataset (each with a name and values array)
+ * @param options - Chart options: title, width, height, colors, bg, legend (default true), mode ("svg" or "data")
+ * @returns ChartOutput with contentType image/svg+xml (SVG string) or application/json (raw data) depending on mode
+ * @throws Error if data is missing, malformed, or exceeds the maximum number of labels or datasets
+ */
+export declare function donut(data: unknown, options: ChartOptions): ChartOutput;
+export {};