mates-fullstack 1.0.0-beta.1

package/dist/upload.d.ts

@@ -0,0 +1,69 @@
+/**
+ * mates-ssr — upload.ts
+ *
+ * Multipart/form-data parsing for file uploads.
+ *
+ * Uses Bun's native req.formData() for parsing.
+ * Validates non-file fields using the same ValidatorFn system as validate().
+ * File validation (type, content) is left to the developer.
+ *
+ * @example
+ * export async function POST(req: Request) {
+ *   const { fields, files } = await parseUpload(req);
+ *
+ *   // fields — validated form text fields
+ *   // files  — raw File objects, validate yourself
+ *
+ *   await Bun.write(`./uploads/${files.photo.name}`, files.photo);
+ *   return Response.json({ ok: true });
+ * }
+ */
+import { ServerError } from "./server-fn.js";
+import type { ValidatorFn } from "./validate.js";
+export interface UploadOptions {
+    /**
+     * Maximum total upload size in bytes.
+     * Defaults to server.maxUploadSize from config (10mb).
+     */
+    maxSize?: number;
+    /**
+     * Validate non-file form fields.
+     * Keys are field names, values are arrays of ValidatorFn.
+     * Files are never validated here — that's up to you.
+     *
+     * @example
+     * fieldValidators: {
+     *   title: [isRequired, maxLength(100)],
+     *   description: [maxLength(500)],
+     * }
+     */
+    fieldValidators?: Record<string, ValidatorFn[]>;
+    /**
+     * Required file fields — throw 400 if any are missing.
+     */
+    requiredFiles?: string[];
+}
+export interface ParsedUpload {
+    /** Text form fields */
+    fields: Record<string, string>;
+    /** File objects keyed by field name — validate and store yourself */
+    files: Record<string, File>;
+    /** Multiple files with the same field name */
+    multiFiles: Record<string, File[]>;
+}
+export declare class UploadError extends ServerError {
+    constructor(message: string, status?: number, code?: string);
+}
+/**
+ * Parse a multipart/form-data request.
+ *
+ * Separates text fields from files.
+ * Validates text fields if fieldValidators are provided.
+ * Never validates files — that's the developer's responsibility.
+ *
+ * @throws UploadError if Content-Type is not multipart/form-data or url-encoded
+ * @throws UploadError if required files are missing
+ * @throws ValidationError if field validation fails
+ */
+export declare function parseUpload(req: Request, options?: UploadOptions): Promise<ParsedUpload>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAEhD;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;CACpC;AAED,qBAAa,WAAY,SAAQ,WAAW;gBAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,SAAM,EAAE,IAAI,SAAiB;CAIjE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAwFvB"}

package/dist/upload.js

@@ -0,0 +1,110 @@
+/**
+ * mates-ssr — upload.ts
+ *
+ * Multipart/form-data parsing for file uploads.
+ *
+ * Uses Bun's native req.formData() for parsing.
+ * Validates non-file fields using the same ValidatorFn system as validate().
+ * File validation (type, content) is left to the developer.
+ *
+ * @example
+ * export async function POST(req: Request) {
+ *   const { fields, files } = await parseUpload(req);
+ *
+ *   // fields — validated form text fields
+ *   // files  — raw File objects, validate yourself
+ *
+ *   await Bun.write(`./uploads/${files.photo.name}`, files.photo);
+ *   return Response.json({ ok: true });
+ * }
+ */
+import { ServerError } from "./server-fn.js";
+import { validate } from "./validate.js";
+export class UploadError extends ServerError {
+    constructor(message, status = 400, code = "UPLOAD_ERROR") {
+        super(status, message, { code });
+        this.name = "UploadError";
+    }
+}
+/**
+ * Parse a multipart/form-data request.
+ *
+ * Separates text fields from files.
+ * Validates text fields if fieldValidators are provided.
+ * Never validates files — that's the developer's responsibility.
+ *
+ * @throws UploadError if Content-Type is not multipart/form-data or url-encoded
+ * @throws UploadError if required files are missing
+ * @throws ValidationError if field validation fails
+ */
+export async function parseUpload(req, options = {}) {
+    const contentType = req.headers.get("content-type") ?? "";
+    if (!contentType.includes("multipart/form-data") &&
+        !contentType.includes("application/x-www-form-urlencoded")) {
+        throw new UploadError("Expected multipart/form-data or application/x-www-form-urlencoded", 415, "UNSUPPORTED_MEDIA_TYPE");
+    }
+    // Check content-length against maxSize if provided
+    if (options.maxSize !== undefined) {
+        const contentLength = req.headers.get("content-length");
+        if (contentLength && parseInt(contentLength, 10) > options.maxSize) {
+            throw new UploadError(`Upload too large. Maximum size is ${formatBytes(options.maxSize)}`, 413, "UPLOAD_TOO_LARGE");
+        }
+    }
+    let formData;
+    try {
+        formData = await req.formData();
+    }
+    catch (err) {
+        throw new UploadError(`Failed to parse form data: ${err?.message ?? String(err)}`, 400, "PARSE_ERROR");
+    }
+    const fields = {};
+    const files = {};
+    const multiFiles = {};
+    for (const [key, value] of formData.entries()) {
+        if (typeof value === "object" &&
+            value !== null &&
+            "size" in value &&
+            "type" in value) {
+            // File — store as-is, no validation here
+            const file = value;
+            if (!files[key]) {
+                files[key] = file;
+                multiFiles[key] = [file];
+            }
+            else {
+                multiFiles[key].push(file);
+            }
+        }
+        else {
+            // Text field — collect for validation
+            fields[key] = String(value);
+        }
+    }
+    // Check required files
+    if (options.requiredFiles?.length) {
+        for (const name of options.requiredFiles) {
+            if (!files[name]) {
+                throw new UploadError(`Missing required file: "${name}"`, 400, "MISSING_FILE");
+            }
+        }
+    }
+    // Validate text fields using the ValidatorFn system
+    if (options.fieldValidators) {
+        for (const [fieldName, validators] of Object.entries(options.fieldValidators)) {
+            if (validators.length > 0) {
+                // validate() throws ValidationError (status 400) on failure
+                validate(fields[fieldName], validators, fieldName);
+            }
+        }
+    }
+    return { fields, files, multiFiles };
+}
+// ─── Internal helpers ─────────────────────────────────────────────────────────
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+//# sourceMappingURL=upload.js.map

package/dist/upload.js.map

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

package/dist/validate.d.ts

@@ -0,0 +1,58 @@
+/**
+ * mates-ssr — validate.ts
+ *
+ * Server-side validation helper. Uses the same ValidatorFn type as mates'
+ * client-side formAtom validators — same rule, runs on both ends.
+ *
+ * @example
+ * import { validate } from "mates-ssr";
+ * import { isRequired, isEmail, minLength } from "mates";
+ *
+ * export async function POST(req: Request) {
+ *   const body = await req.json();
+ *   validate(body.email, [isRequired, isEmail]);
+ *   validate(body.name,  [isRequired, minLength(2)]);
+ *   // ... proceed knowing data is valid
+ * }
+ */
+import { ServerError } from "./server-fn.js";
+export type ValidatorFn<T = any> = (value: T) => string | null;
+/**
+ * Thrown when validate() finds errors. Has status=400 for the server
+ * error handler to map to an HTTP 400 response.
+ */
+export declare class ValidationError extends ServerError {
+    readonly errors: string[];
+    readonly field?: string;
+    fieldErrors?: Record<string, string[]>;
+    constructor(errors: string[], field?: string);
+}
+/**
+ * Validate a single value against an array of validators.
+ * Throws ValidationError (status 400) if any validator fails.
+ * Returns cleanly if all pass.
+ *
+ * Uses the same ValidatorFn type as mates formAtom — import validators
+ * from "mates" and reuse them on the server.
+ *
+ * @param value       The value to validate
+ * @param validators  Array of validator functions
+ * @param field       Optional field name for error context
+ */
+export declare function validate<T>(value: T, validators: ValidatorFn<T>[], field?: string): void;
+/**
+ * Validate multiple fields at once.
+ * Collects ALL errors across all fields before throwing — unlike validate()
+ * which throws on the first failing field.
+ *
+ * @example
+ * validateAll({
+ *   email:    { value: body.email,    validators: [isRequired, isEmail] },
+ *   password: { value: body.password, validators: [isRequired, isStrongPassword()] },
+ * });
+ */
+export declare function validateAll(fields: Record<string, {
+    value: any;
+    validators: ValidatorFn[];
+}>): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,CAAC;AAE/D;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAE3B,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM;CAS7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,KAAK,EAAE,CAAC,EACR,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,EAC5B,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAQN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,GAAG,CAAC;IAAC,UAAU,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC,GAChE,IAAI,CAuBN"}

package/dist/validate.js

@@ -0,0 +1,89 @@
+/**
+ * mates-ssr — validate.ts
+ *
+ * Server-side validation helper. Uses the same ValidatorFn type as mates'
+ * client-side formAtom validators — same rule, runs on both ends.
+ *
+ * @example
+ * import { validate } from "mates-ssr";
+ * import { isRequired, isEmail, minLength } from "mates";
+ *
+ * export async function POST(req: Request) {
+ *   const body = await req.json();
+ *   validate(body.email, [isRequired, isEmail]);
+ *   validate(body.name,  [isRequired, minLength(2)]);
+ *   // ... proceed knowing data is valid
+ * }
+ */
+import { ServerError } from "./server-fn.js";
+/**
+ * Thrown when validate() finds errors. Has status=400 for the server
+ * error handler to map to an HTTP 400 response.
+ */
+export class ValidationError extends ServerError {
+    errors;
+    field;
+    fieldErrors;
+    constructor(errors, field) {
+        super(400, errors.join("; "), {
+            code: "VALIDATION_ERROR",
+            ...(field ? { field } : {}),
+        });
+        this.name = "ValidationError";
+        this.errors = errors;
+        this.field = field;
+    }
+}
+/**
+ * Validate a single value against an array of validators.
+ * Throws ValidationError (status 400) if any validator fails.
+ * Returns cleanly if all pass.
+ *
+ * Uses the same ValidatorFn type as mates formAtom — import validators
+ * from "mates" and reuse them on the server.
+ *
+ * @param value       The value to validate
+ * @param validators  Array of validator functions
+ * @param field       Optional field name for error context
+ */
+export function validate(value, validators, field) {
+    const errors = validators
+        .map((fn) => fn(value))
+        .filter((e) => typeof e === "string" && e.length > 0);
+    if (errors.length > 0) {
+        throw new ValidationError(errors, field);
+    }
+}
+/**
+ * Validate multiple fields at once.
+ * Collects ALL errors across all fields before throwing — unlike validate()
+ * which throws on the first failing field.
+ *
+ * @example
+ * validateAll({
+ *   email:    { value: body.email,    validators: [isRequired, isEmail] },
+ *   password: { value: body.password, validators: [isRequired, isStrongPassword()] },
+ * });
+ */
+export function validateAll(fields) {
+    const allErrors = {};
+    let hasErrors = false;
+    for (const [field, { value, validators }] of Object.entries(fields)) {
+        const errors = validators
+            .map((fn) => fn(value))
+            .filter((e) => typeof e === "string" && e.length > 0);
+        if (errors.length > 0) {
+            allErrors[field] = errors;
+            hasErrors = true;
+        }
+    }
+    if (hasErrors) {
+        const messages = Object.entries(allErrors)
+            .map(([f, errs]) => `${f}: ${errs.join(", ")}`)
+            .join("; ");
+        const err = new ValidationError([messages]);
+        err.fieldErrors = allErrors;
+        throw err;
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAI7C;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,WAAW;IACrC,MAAM,CAAW;IACjB,KAAK,CAAU;IACxB,WAAW,CAA4B;IAEvC,YAAY,MAAgB,EAAE,KAAc;QAC1C,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC5B,IAAI,EAAE,kBAAkB;YACxB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5B,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAQ,EACR,UAA4B,EAC5B,KAAc;IAEd,MAAM,MAAM,GAAG,UAAU;SACtB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;SACtB,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAErE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CACzB,MAAiE;IAEjE,MAAM,SAAS,GAA6B,EAAE,CAAC;IAC/C,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,KAAK,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACpE,MAAM,MAAM,GAAG,UAAU;aACtB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;aACtB,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAErE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,SAAS,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;YAC1B,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;aACvC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;aAC9C,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5C,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC;QAC5B,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/verify-package.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function verifyPackage(projectRoot?: string): string[];
+//# sourceMappingURL=verify-package.d.ts.map

package/dist/verify-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-package.d.ts","sourceRoot":"","sources":["../src/verify-package.ts"],"names":[],"mappings":";AA4BA,wBAAgB,aAAa,CAAC,WAAW,SAAoB,GAAG,MAAM,EAAE,CAmDvE"}

package/dist/verify-package.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const LEGACY_OUTPUTS = [
+    "api-router",
+    "auth",
+    "auth-routes",
+    "cli",
+    "env",
+    "fn-registry",
+    "oauth-providers",
+    "rest-router",
+    "route-guard",
+    "routes-router",
+    "ws-router",
+    "ws-publish",
+];
+export function verifyPackage(projectRoot = findPackageRoot()) {
+    const errors = [];
+    const pkgPath = path.join(projectRoot, "package.json");
+    const pkg = readPackageJson(pkgPath, errors);
+    if (!pkg)
+        return errors;
+    const files = pkg.files ?? [];
+    if (!files.includes("dist")) {
+        errors.push(`package.json files[] must include "dist".`);
+    }
+    if (files.includes("src")) {
+        errors.push(`package.json files[] must not include "src".`);
+    }
+    if (!fs.existsSync(path.join(projectRoot, "dist"))) {
+        errors.push(`dist/ is missing. Run npm run build before publishing.`);
+    }
+    checkPackagePath(projectRoot, pkg.main, "main", errors);
+    checkPackagePath(projectRoot, pkg.types, "types", errors);
+    if (!pkg.exports || typeof pkg.exports !== "object") {
+        errors.push(`package.json exports is missing or invalid.`);
+    }
+    else {
+        for (const [exportName, target] of Object.entries(pkg.exports)) {
+            for (const rel of collectExportTargets(target)) {
+                checkPackagePath(projectRoot, rel, `exports[${exportName}]`, errors);
+            }
+        }
+    }
+    if (!pkg.bin) {
+        errors.push(`package.json bin is missing.`);
+    }
+    else if (typeof pkg.bin === "string") {
+        checkBinPath(projectRoot, pkg.bin, "bin", errors);
+    }
+    else {
+        for (const [name, rel] of Object.entries(pkg.bin)) {
+            checkBinPath(projectRoot, rel, `bin[${name}]`, errors);
+        }
+    }
+    for (const stem of LEGACY_OUTPUTS) {
+        for (const ext of [".js", ".d.ts", ".js.map", ".d.ts.map"]) {
+            const rel = `dist/${stem}${ext}`;
+            if (fs.existsSync(path.join(projectRoot, rel))) {
+                errors.push(`legacy output must not be published: ${rel}`);
+            }
+        }
+    }
+    return errors;
+}
+function readPackageJson(pkgPath, errors) {
+    try {
+        return JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+    }
+    catch (err) {
+        errors.push(`Unable to read package.json: ${formatError(err)}`);
+        return null;
+    }
+}
+function collectExportTargets(value) {
+    if (typeof value === "string")
+        return [value];
+    if (!value || typeof value !== "object")
+        return [];
+    const targets = [];
+    for (const nested of Object.values(value)) {
+        targets.push(...collectExportTargets(nested));
+    }
+    return targets;
+}
+function checkPackagePath(projectRoot, rel, label, errors) {
+    if (!rel) {
+        errors.push(`package.json ${label} is missing.`);
+        return;
+    }
+    if (!rel.startsWith("./")) {
+        errors.push(`package.json ${label} must be a relative package path: ${rel}`);
+        return;
+    }
+    if (!fs.existsSync(path.resolve(projectRoot, rel))) {
+        errors.push(`package.json ${label} points to missing file: ${rel}`);
+    }
+}
+function checkBinPath(projectRoot, rel, label, errors) {
+    checkPackagePath(projectRoot, rel, label, errors);
+    const fullPath = path.resolve(projectRoot, rel);
+    if (!fs.existsSync(fullPath))
+        return;
+    const firstLine = fs.readFileSync(fullPath, "utf-8").split(/\r?\n/, 1)[0];
+    if (!firstLine.startsWith("#!")) {
+        errors.push(`package.json ${label} target is missing a shebang: ${rel}`);
+    }
+}
+function findPackageRoot() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(here, "..");
+}
+function formatError(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+    const errors = verifyPackage();
+    if (errors.length > 0) {
+        console.error("[mates-fullstack] package verification failed:");
+        for (const error of errors)
+            console.error(`  - ${error}`);
+        process.exit(1);
+    }
+    console.log("[mates-fullstack] package verification passed");
+}
+//# sourceMappingURL=verify-package.js.map

package/dist/verify-package.js.map

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

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "mates-fullstack",
+  "version": "1.0.0-beta.1",
+  "type": "module",
+  "description": "Full-stack Node.js framework built on the Mates SPA framework. RPC server functions, SSR, WebSockets, file-system routing.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    },
+    "./server": {
+      "types": "./dist/server-public.d.ts",
+      "import": "./dist/server-public.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "import": "./dist/internal.js"
+    }
+  },
+  "bin": {
+    "mates-fullstack": "./dist/cli-new.js"
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "prebuild": "npm run clean",
+    "build": "tsc -p tsconfig.build.json",
+    "prepack": "npm run build",
+    "verify:package": "npm run build && node ./dist/verify-package.js",
+    "pack:smoke": "npm run verify:package && npm pack --dry-run",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --config vitest.config.ts",
+    "test:coverage": "vitest run --config vitest.config.ts --coverage"
+  },
+  "keywords": [
+    "mates",
+    "fullstack",
+    "ssr",
+    "ssg",
+    "rpc",
+    "server-functions",
+    "node",
+    "framework"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@jridgewell/trace-mapping": "0.3.31",
+    "arctic": "^3.7.0",
+    "chokidar": "4.0.3",
+    "esbuild": "0.24.0",
+    "ws": "8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "20.0.0",
+    "@types/ws": "8.5.13",
+    "@vitest/coverage-v8": "2.0.0",
+    "typescript": "5.3.2",
+    "vitest": "2.0.0"
+  },
+  "peerDependencies": {
+    "mates": "^0.4.0-beta.1"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}