mates-fullstack 1.0.0-beta.1

package/dist/asset-manifest.js

@@ -0,0 +1,102 @@
+import fs from "node:fs";
+import path from "node:path";
+import { isPathInside } from "./project-resolver.js";
+export function readAssetManifest(manifestPath) {
+    let raw;
+    try {
+        raw = fs.readFileSync(manifestPath, "utf-8");
+    }
+    catch (err) {
+        throw new Error(`[mates-fullstack] Unable to read asset manifest at ${manifestPath}: ${formatError(err)}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`[mates-fullstack] Invalid asset manifest JSON at ${manifestPath}: ${formatError(err)}`);
+    }
+    if (!isRecord(parsed)) {
+        throw new Error(`[mates-fullstack] Invalid asset manifest at ${manifestPath}: expected an object.`);
+    }
+    if (typeof parsed.client !== "string" || parsed.client.trim() === "") {
+        throw new Error(`[mates-fullstack] Invalid asset manifest at ${manifestPath}: missing string "client" entry.`);
+    }
+    if (parsed.css !== undefined &&
+        parsed.css !== null &&
+        (typeof parsed.css !== "string" || parsed.css.trim() === "")) {
+        throw new Error(`[mates-fullstack] Invalid asset manifest at ${manifestPath}: "css" must be a string or null.`);
+    }
+    return {
+        client: parsed.client,
+        css: typeof parsed.css === "string" ? parsed.css : null,
+    };
+}
+export function resolveAssetManifest(manifestPath) {
+    const manifest = readAssetManifest(manifestPath);
+    const assetsDir = path.dirname(manifestPath);
+    const clientBundlePath = resolveManifestFile(assetsDir, manifest.client, "client", manifestPath);
+    let cssFilename = null;
+    if (manifest.css) {
+        resolveManifestFile(assetsDir, manifest.css, "css", manifestPath);
+        cssFilename = manifest.css;
+    }
+    return {
+        assetsDir,
+        clientBundlePath,
+        clientFilename: manifest.client,
+        cssFilename,
+    };
+}
+export function findProductionAssets(assetsDir, warn = console.warn) {
+    const manifestPath = path.join(assetsDir, "manifest.json");
+    if (fs.existsSync(manifestPath)) {
+        return resolveAssetManifest(manifestPath);
+    }
+    if (!fs.existsSync(assetsDir))
+        return null;
+    warn(`[mates-fullstack] dist/assets/manifest.json was not found; falling back to scanning client*.js. ` +
+        `Run a fresh production build to restore deterministic asset selection.`);
+    const clientFilename = findLatestFile(assetsDir, (file) => file.startsWith("client") && file.endsWith(".js") && !file.endsWith(".map"));
+    if (!clientFilename)
+        return null;
+    const cssFilename = findLatestFile(assetsDir, (file) => file.startsWith("client") && file.endsWith(".css"));
+    return {
+        assetsDir,
+        clientBundlePath: path.join(assetsDir, clientFilename),
+        clientFilename,
+        cssFilename,
+    };
+}
+function resolveManifestFile(assetsDir, filename, key, manifestPath) {
+    if (path.isAbsolute(filename)) {
+        throw new Error(`[mates-fullstack] Invalid asset manifest at ${manifestPath}: "${key}" must be relative, got ${filename}.`);
+    }
+    const resolved = path.resolve(assetsDir, filename);
+    if (!isPathInside(assetsDir, resolved)) {
+        throw new Error(`[mates-fullstack] Invalid asset manifest at ${manifestPath}: "${key}" points outside dist/assets.`);
+    }
+    try {
+        if (fs.statSync(resolved).isFile())
+            return resolved;
+    }
+    catch {
+        /* throw below */
+    }
+    throw new Error(`[mates-fullstack] Asset manifest points to missing ${key} file: ${filename}. ` +
+        `Run 'mates-fullstack build' again.`);
+}
+function findLatestFile(dir, predicate) {
+    return (fs
+        .readdirSync(dir)
+        .filter(predicate)
+        .sort((a, b) => fs.statSync(path.join(dir, b)).mtimeMs -
+        fs.statSync(path.join(dir, a)).mtimeMs)[0] ?? null);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function formatError(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=asset-manifest.js.map

package/dist/asset-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-manifest.js","sourceRoot":"","sources":["../src/asset-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAcrD,MAAM,UAAU,iBAAiB,CAAC,YAAoB;IACpD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,sDAAsD,YAAY,KAAK,WAAW,CAAC,GAAG,CAAC,EAAE,CAC1F,CAAC;IACJ,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,oDAAoD,YAAY,KAAK,WAAW,CAAC,GAAG,CAAC,EAAE,CACxF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,+CAA+C,YAAY,uBAAuB,CACnF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CACb,+CAA+C,YAAY,kCAAkC,CAC9F,CAAC;IACJ,CAAC;IAED,IACE,MAAM,CAAC,GAAG,KAAK,SAAS;QACxB,MAAM,CAAC,GAAG,KAAK,IAAI;QACnB,CAAC,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAC5D,CAAC;QACD,MAAM,IAAI,KAAK,CACb,+CAA+C,YAAY,mCAAmC,CAC/F,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,GAAG,EAAE,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;KACxD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,YAAoB;IAEpB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,gBAAgB,GAAG,mBAAmB,CAC1C,SAAS,EACT,QAAQ,CAAC,MAAM,EACf,QAAQ,EACR,YAAY,CACb,CAAC;IAEF,IAAI,WAAW,GAAkB,IAAI,CAAC;IACtC,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;QACjB,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;QAClE,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC;IAC7B,CAAC;IAED,OAAO;QACL,SAAS;QACT,gBAAgB;QAChB,cAAc,EAAE,QAAQ,CAAC,MAAM;QAC/B,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,SAAiB,EACjB,OAAkC,OAAO,CAAC,IAAI;IAE9C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IAC3D,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,OAAO,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,IAAI,CACF,kGAAkG;QAChG,wEAAwE,CAC3E,CAAC;IAEF,MAAM,cAAc,GAAG,cAAc,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CACxD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAC5E,CAAC;IAEF,IAAI,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IAEjC,MAAM,WAAW,GAAG,cAAc,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CACrD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CACnD,CAAC;IAEF,OAAO;QACL,SAAS;QACT,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC;QACtD,cAAc;QACd,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,SAAiB,EACjB,QAAgB,EAChB,GAAqB,EACrB,YAAoB;IAEpB,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,+CAA+C,YAAY,MAAM,GAAG,2BAA2B,QAAQ,GAAG,CAC3G,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,+CAA+C,YAAY,MAAM,GAAG,+BAA+B,CACpG,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE;YAAE,OAAO,QAAQ,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,sDAAsD,GAAG,UAAU,QAAQ,IAAI;QAC7E,oCAAoC,CACvC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CACrB,GAAW,EACX,SAAoC;IAEpC,OAAO,CACL,EAAE;SACC,WAAW,CAAC,GAAG,CAAC;SAChB,MAAM,CAAC,SAAS,CAAC;SACjB,IAAI,CACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO;QACtC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CACzC,CAAC,CAAC,CAAC,IAAI,IAAI,CACf,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,WAAW,CAAC,GAAY;IAC/B,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC"}

package/dist/browser.d.ts

@@ -0,0 +1,18 @@
+/**
+ * mates-fullstack/browser — browser-safe exports only.
+ *
+ * This file contains only the exports that are safe to use in the browser.
+ * It has zero Node.js dependencies.
+ *
+ * The build plugin replaces any import of "mates-fullstack" from client code
+ * with this file, so only browser-safe code reaches the bundle.
+ *
+ * Users can import from "mates-fullstack" in both client and server code —
+ * the build plugin handles the substitution automatically.
+ */
+export { ServerError, AppError, NotFoundError, AuthError, ForbiddenError, ValidationError, RateLimitError, reconstructError, isMatesError, getErrorStatus, type SerializedError, } from "./errors.js";
+export { Redirect, isMatesRedirect, isExternalUrl, type SerializedRedirect, } from "./redirect.js";
+export { readSseStream } from "./stream.js";
+export { triggerBrowserDownload } from "./download.js";
+export { isDev } from "./log.js";
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EACL,WAAW,EACX,QAAQ,EACR,aAAa,EACb,SAAS,EACT,cAAc,EACd,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AAIrB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,aAAa,EACb,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAIvD,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC"}

package/dist/browser.js

@@ -0,0 +1,25 @@
+/**
+ * mates-fullstack/browser — browser-safe exports only.
+ *
+ * This file contains only the exports that are safe to use in the browser.
+ * It has zero Node.js dependencies.
+ *
+ * The build plugin replaces any import of "mates-fullstack" from client code
+ * with this file, so only browser-safe code reaches the bundle.
+ *
+ * Users can import from "mates-fullstack" in both client and server code —
+ * the build plugin handles the substitution automatically.
+ */
+// ─── Error classes (browser-safe) ────────────────────────────────────────────
+// These are thrown by server functions and reconstructed on the client.
+// They have no Node.js dependencies.
+export { ServerError, AppError, NotFoundError, AuthError, ForbiddenError, ValidationError, RateLimitError, reconstructError, isMatesError, getErrorStatus, } from "./errors.js";
+// ─── Redirect (browser-safe) ─────────────────────────────────────────────────
+export { Redirect, isMatesRedirect, isExternalUrl, } from "./redirect.js";
+// ─── Stream reader (browser-safe) ─────────────────────────────────────────────
+export { readSseStream } from "./stream.js";
+// ─── Download trigger (browser-safe) ─────────────────────────────────────────
+export { triggerBrowserDownload } from "./download.js";
+// ─── isDev (browser-safe) ─────────────────────────────────────────────────────
+export { isDev } from "./log.js";
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,gFAAgF;AAChF,wEAAwE;AACxE,qCAAqC;AAErC,OAAO,EACL,WAAW,EACX,QAAQ,EACR,aAAa,EACb,SAAS,EACT,cAAc,EACd,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,cAAc,GAEf,MAAM,aAAa,CAAC;AAErB,gFAAgF;AAEhF,OAAO,EACL,QAAQ,EACR,eAAe,EACf,aAAa,GAEd,MAAM,eAAe,CAAC;AAEvB,iFAAiF;AAEjF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,gFAAgF;AAEhF,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEvD,iFAAiF;AAEjF,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC"}

package/dist/build-esbuild.d.ts

@@ -0,0 +1,29 @@
+export interface TransformResult {
+    code: string;
+    map?: string;
+}
+export interface DevModuleTransformOptions {
+    projectRoot: string;
+    moduleRoot?: string;
+    modulePrefix?: string;
+    apiDir: string | null;
+    publicEnv: Record<string, string>;
+    sourceUrl?: string;
+    importMap?: Record<string, string>;
+}
+export declare function clearTransformCache(): void;
+export declare function buildDefines(publicEnv: Record<string, string>): Record<string, string>;
+export declare function extractRpcStub(source: string, filePath: string, apiDir: string): string;
+export declare function transformFile(filePath: string, projectRoot: string, apiDir: string | null, publicEnv: Record<string, string>, sourceUrl?: string): Promise<TransformResult | null>;
+/**
+ * Transform one source file for no-bundle dev mode.
+ *
+ * Unlike `transformFile()`, this rewrites ESM specifiers so the browser can load
+ * TypeScript and package files directly from the dev server. Stylesheets are
+ * bundled separately into one linked CSS file; CSS imports are rewritten to a
+ * no-op compatibility module.
+ */
+export declare function transformDevModule(filePath: string, options: DevModuleTransformOptions): Promise<TransformResult | null>;
+export declare function isVirtualFile(pathname: string): boolean;
+export declare function serveVirtualFile(pathname: string): Promise<string | null>;
+//# sourceMappingURL=build-esbuild.d.ts.map

package/dist/build-esbuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-esbuild.d.ts","sourceRoot":"","sources":["../src/build-esbuild.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAQD,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAuBD,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB;AAMD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,CAmDR;AAsBD,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAuFjC;AAWD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAmBjC;AAmiBD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAExB"}