praetom 0.1.0

package/dist/webpack/loader.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Webpack loader half of praetom-webpack. Called per-module by webpack
+ * with the file's source. We check whether the file matches a feature
+ * path (the plugin half sets the feature map on the loader's context)
+ * and rewrite the source if so.
+ *
+ * Registered by the plugin via `compiler.options.module.rules`. Not
+ * meant to be added manually to webpack config.
+ */
+import type { FeatureMapEntry } from "./shared.js";
+interface LoaderContext {
+    resource?: string;
+    resourcePath?: string;
+    rootContext?: string;
+    query?: {
+        features?: readonly FeatureMapEntry[];
+    };
+    getOptions?: () => {
+        features?: readonly FeatureMapEntry[];
+    };
+    async?: () => (err: Error | null, content?: string) => void;
+    callback?: (err: Error | null, content?: string) => void;
+    emitWarning?: (warning: Error) => void;
+}
+export default function praetomLoader(this: LoaderContext, source: string): string | void;
+export {};
+//# sourceMappingURL=loader.d.ts.map

package/dist/webpack/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/webpack/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,UAAU,aAAa;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;KAAE,CAAC;IAClD,UAAU,CAAC,EAAE,MAAM;QAAE,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;KAAE,CAAC;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,KAAK,IAAI,CAAC;CACxC;AAED,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8CxF"}

package/dist/webpack/loader.js

@@ -0,0 +1,54 @@
+/**
+ * Webpack loader half of praetom-webpack. Called per-module by webpack
+ * with the file's source. We check whether the file matches a feature
+ * path (the plugin half sets the feature map on the loader's context)
+ * and rewrite the source if so.
+ *
+ * Registered by the plugin via `compiler.options.module.rules`. Not
+ * meant to be added manually to webpack config.
+ */
+import { matchFeatureForPath, wrapModuleSource } from "./shared.js";
+export default function praetomLoader(source) {
+    const options = typeof this.getOptions === "function" ? this.getOptions() : (this.query ?? {});
+    const features = options.features ?? [];
+    if (features.length === 0)
+        return source;
+    const resourcePath = this.resourcePath ?? this.resource ?? "";
+    if (!resourcePath)
+        return source;
+    if (resourcePath.includes("/node_modules/"))
+        return source;
+    // Try both rootContext-relative AND repo-root-relative. Feature paths
+    // from praetom are repo-root-relative (e.g. "apps/web/src/app/.../route.ts"),
+    // but webpack's rootContext may be a workspace subdir (e.g. apps/web).
+    // Match against both forms so the path attribution works regardless.
+    const root = this.rootContext ?? "";
+    const candidates = new Set();
+    candidates.add(resourcePath);
+    if (root && resourcePath.startsWith(root)) {
+        candidates.add(resourcePath.slice(root.length).replace(/^\//, ""));
+    }
+    // Also try stripping any monorepo root prefix — find common substrings
+    // like "/apps/" or "/packages/" and use what follows.
+    const idx = resourcePath.search(/\/(apps|packages)\//);
+    if (idx > 0) {
+        candidates.add(resourcePath.slice(idx + 1));
+    }
+    let match = null;
+    for (const candidate of candidates) {
+        match = matchFeatureForPath(features, candidate);
+        if (match)
+            break;
+    }
+    if (!match)
+        return source;
+    const wrapped = wrapModuleSource(source, match.slug, match.entrySymbol);
+    if (!wrapped) {
+        if (this.emitWarning) {
+            this.emitWarning(new Error(`[praetom] could not wrap ${resourcePath} (export shape not recognized; skipping)`));
+        }
+        return source;
+    }
+    return wrapped;
+}
+//# sourceMappingURL=loader.js.map

package/dist/webpack/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/webpack/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAcpE,MAAM,CAAC,OAAO,UAAU,aAAa,CAAsB,MAAc;IACvE,MAAM,OAAO,GACX,OAAO,IAAI,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;IACxC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAEzC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC9D,IAAI,CAAC,YAAY;QAAE,OAAO,MAAM,CAAC;IACjC,IAAI,YAAY,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAAE,OAAO,MAAM,CAAC;IAE3D,sEAAsE;IACtE,8EAA8E;IAC9E,uEAAuE;IACvE,qEAAqE;IACrE,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;IACpC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC7B,IAAI,IAAI,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,uEAAuE;IACvE,sDAAsD;IACtD,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACvD,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACZ,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,KAAK,GAAkD,IAAI,CAAC;IAChE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,KAAK,GAAG,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACjD,IAAI,KAAK;YAAE,MAAM;IACnB,CAAC;IACD,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IACxE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,WAAW,CACd,IAAI,KAAK,CACP,4BAA4B,YAAY,0CAA0C,CACnF,CACF,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/webpack/shared.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared source-rewrite logic. Identical conceptually to the regex
+ * transform in praetom-vite and the runtime ESM loader hook. Lives here
+ * because the webpack plugin needs the same transform but webpack
+ * exposes it through a loader function (vite uses `transform`).
+ */
+export interface FeatureMapEntry {
+    slug: string;
+    paths: string[];
+    entrySymbol?: string;
+}
+export interface RuntimeConfigResponse {
+    workspaceSlug: string;
+    repo: string;
+    etag: string;
+    features: FeatureMapEntry[];
+}
+export declare function matchFeatureForPath(features: readonly FeatureMapEntry[], relPath: string): {
+    slug: string;
+    entrySymbol?: string;
+} | null;
+export declare function shouldWrap(name: string, entrySymbol: string | undefined): boolean;
+export declare function wrapModuleSource(source: string, slug: string, entrySymbol?: string): string | null;
+export declare function fetchFeatureMap(configEndpoint: string, ingestToken: string): Promise<RuntimeConfigResponse>;
+//# sourceMappingURL=shared.d.ts.map

package/dist/webpack/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/webpack/shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAcD,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,eAAe,EAAE,EACpC,OAAO,EAAE,MAAM,GACd;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO/C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAGjF;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,GAAG,IAAI,CAkCf;AAED,wBAAsB,eAAe,CACnC,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,qBAAqB,CAAC,CAQhC"}

package/dist/webpack/shared.js

@@ -0,0 +1,63 @@
+/**
+ * Shared source-rewrite logic. Identical conceptually to the regex
+ * transform in praetom-vite and the runtime ESM loader hook. Lives here
+ * because the webpack plugin needs the same transform but webpack
+ * exposes it through a loader function (vite uses `transform`).
+ */
+const HTTP_METHODS = new Set([
+    "GET",
+    "POST",
+    "PUT",
+    "PATCH",
+    "DELETE",
+    "OPTIONS",
+    "HEAD",
+]);
+const PRAETOM_IMPORT_MARKER = "__praetom_wrap_import__";
+export function matchFeatureForPath(features, relPath) {
+    for (const feature of features) {
+        if (feature.paths.some((p) => relPath === p || relPath.endsWith(`/${p}`))) {
+            return { slug: feature.slug, entrySymbol: feature.entrySymbol };
+        }
+    }
+    return null;
+}
+export function shouldWrap(name, entrySymbol) {
+    if (entrySymbol)
+        return name === entrySymbol;
+    return HTTP_METHODS.has(name) || name === "handler";
+}
+export function wrapModuleSource(source, slug, entrySymbol) {
+    if (source.includes(PRAETOM_IMPORT_MARKER))
+        return null;
+    const targets = new Set();
+    let rewritten = source.replace(/^export\s+(async\s+)?function\s+([A-Za-z_$][\w$]*)\s*\(/gm, (_m, asyncKw, name) => {
+        if (!shouldWrap(name, entrySymbol))
+            return _m;
+        targets.add(name);
+        return `${asyncKw ?? ""}function __praetom_orig_${name}(`;
+    });
+    rewritten = rewritten.replace(/^export\s+const\s+([A-Za-z_$][\w$]*)\s*=/gm, (_m, name) => {
+        if (!shouldWrap(name, entrySymbol))
+            return _m;
+        targets.add(name);
+        return `const __praetom_orig_${name} =`;
+    });
+    if (targets.size === 0)
+        return null;
+    const importLine = `import { __praetomWrapEntryPoint as ${PRAETOM_IMPORT_MARKER} } from "praetom";\n`;
+    const wraps = [...targets]
+        .map((name) => `export const ${name} = ${PRAETOM_IMPORT_MARKER}(${JSON.stringify(slug)}, ${JSON.stringify(name)}, __praetom_orig_${name});`)
+        .join("\n");
+    return `${importLine}${rewritten}\n${wraps}\n`;
+}
+export async function fetchFeatureMap(configEndpoint, ingestToken) {
+    const res = await fetch(configEndpoint, {
+        headers: { authorization: `Bearer ${ingestToken}` },
+    });
+    if (!res.ok) {
+        throw new Error(`runtime/config returned HTTP ${res.status}`);
+    }
+    return (await res.json());
+}
+//# sourceMappingURL=shared.js.map

package/dist/webpack/shared.js.map

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

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "praetom",
+  "version": "0.1.0",
+  "description": "Praetom — production intelligence for AI-generated code. One package: runtime SDK, bundler plugins, and CLI. `register()` once, the praetom server defines what gets wrapped at runtime; the bundler plugin handles bundled code; the CLI wires it all up from the terminal.",
+  "private": false,
+  "type": "module",
+  "main": "./dist/server.js",
+  "types": "./dist/server.d.ts",
+  "bin": {
+    "praetom": "./dist/cli/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "edge-light": {
+        "types": "./dist/edge.d.ts",
+        "default": "./dist/edge.js"
+      },
+      "workerd": {
+        "types": "./dist/edge.d.ts",
+        "default": "./dist/edge.js"
+      },
+      "browser": {
+        "types": "./dist/browser.d.ts",
+        "default": "./dist/browser.js"
+      },
+      "node": {
+        "types": "./dist/server.d.ts",
+        "default": "./dist/server.js"
+      },
+      "default": {
+        "types": "./dist/server.d.ts",
+        "default": "./dist/server.js"
+      }
+    },
+    "./vite": {
+      "types": "./dist/vite/index.d.ts",
+      "default": "./dist/vite/index.js"
+    },
+    "./webpack": {
+      "types": "./dist/webpack/index.d.ts",
+      "default": "./dist/webpack/index.js"
+    },
+    "./webpack/loader": {
+      "types": "./dist/webpack/loader.d.ts",
+      "default": "./dist/webpack/loader.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://praetom.com",
+  "scripts": {
+    "build": "tsc -p tsconfig.json && chmod +x dist/cli/cli.js",
+    "prepare": "tsc -p tsconfig.json && chmod +x dist/cli/cli.js",
+    "lint": "eslint src",
+    "dev": "tsc -p tsconfig.json --watch"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "peerDependencies": {
+    "vite": ">=4.0.0",
+    "webpack": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": { "optional": true },
+    "webpack": { "optional": true }
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "typescript": "^5",
+    "vite": "^5",
+    "webpack": "^5"
+  }
+}