@alpaca-headless/dynamic-renderings-engine 1.0.4694

package/dist/runtime.meta.json

@@ -0,0 +1,4 @@
+{
+  "runtimeHash": "abb8c52c86a0",
+  "bytes": 610422
+}

package/index.d.mts

@@ -0,0 +1,107 @@
+// Types of @alpaca-headless/dynamic-renderings-engine (the JavaScript lives in dist/engine.mjs).
+
+export type Diagnostic = { severity: "error" | "warning"; file?: string; line?: number; column?: number; message: string };
+
+export type CompileRequest = {
+  renderingId: string;
+  kind?: string;
+  name?: string;
+  code: string;
+  /** The rendering's client code, imported by its code as `./client`. */
+  clientCode?: string | null;
+  /** The host's theme file. */
+  themeCss?: string;
+  /** The tenant's theme rendering: custom property declarations. */
+  themeTokens?: string;
+};
+
+export type CompileResult = {
+  ok: boolean;
+  /** True when the failure says nothing about the source (queue full, deadline, thread stopped): never cache it. */
+  transient?: boolean;
+  themeHash?: string;
+  compiledServer?: string;
+  /** The client code as a minified browser ES module; React comes from globalThis.__alpaca_dynamic_react. */
+  compiledClient?: string | null;
+  /** The client code as a CommonJS module for first paints in the render threads. */
+  compiledClientNode?: string | null;
+  clientExports?: string[];
+  css?: string;
+  diagnostics: Diagnostic[];
+  ms?: number;
+};
+
+export type EngineComponent = { key: string; buildId: string; dto: unknown };
+
+export type EngineRenderResult =
+  | { key: string; ok: true; tree: unknown[]; ms?: number }
+  | { key: string; ok: false; code: string; message: string; logs?: string[]; ms?: number };
+
+/** A compiled rendering as the render threads run it: server code and, optionally, the first-paint module. */
+export type EngineModuleSource = { server: string; client?: string; clientExports?: string[] };
+
+export type RenderPageRequest = {
+  tenant: string;
+  components: EngineComponent[];
+  /** Compiled code per buildId, for builds the thread may not have loaded yet. */
+  sources?: Record<string, EngineModuleSource>;
+  deadlineMs?: number;
+  /** Run in a context of its own that is discarded afterwards. */
+  fresh?: boolean;
+};
+
+export type EngineLimits = {
+  sourceBytes: number;
+  cssBytes: number;
+  treeBytes: number;
+  treeDepth: number;
+  treeNodes: number;
+  componentMs: number;
+  pageMs: number;
+  buildMs: number;
+  threadHeapMb: number;
+  runtimeMemoryMb: number;
+  maxThreads: number;
+  maxBuilds: number;
+};
+
+export type EngineOptions = {
+  limits?: Partial<EngineLimits>;
+  compileThreads?: number;
+  compileQueue?: number;
+  renderThreads?: number;
+  idleMs?: number;
+  rate?: { perSecond: number; burst: number };
+};
+
+export type Engine = {
+  limits: EngineLimits;
+  compile(request: CompileRequest): Promise<CompileResult>;
+  renderPage(request: RenderPageRequest): Promise<EngineRenderResult[]>;
+  stats(): unknown;
+  close(): Promise<void>;
+};
+
+export function createEngine(options?: EngineOptions): Engine;
+
+export class CompilePool {
+  constructor(options: { size?: number; compileMs: number; queueLimit?: number; heapMb?: number });
+  compile(request: CompileRequest): Promise<CompileResult>;
+  stats(): { threads: number; idle: number; queued: number };
+  close(): Promise<void>;
+}
+
+export class RenderPool {
+  constructor(options: { limits: EngineLimits; maxThreads?: number; idleMs?: number; rate?: { perSecond: number; burst: number } });
+  renderPage(request: RenderPageRequest): Promise<EngineRenderResult[]>;
+  stats(): unknown;
+  close(): Promise<void>;
+}
+
+export const protocol: {
+  compiledFormat: number;
+  limits: EngineLimits;
+  serverImports: readonly string[];
+  clientImports: readonly string[];
+  browserExports: Readonly<Record<string, readonly string[]>>;
+};

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@alpaca-headless/dynamic-renderings-engine",
+  "version": "1.0.4694",
+  "description": "Isolated dynamic component compiler and QuickJS runtime. No CMS or SDK runtime dependencies.",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.13"
+  },
+  "exports": {
+    ".": {
+      "types": "./index.d.mts",
+      "import": "./dist/engine.mjs"
+    },
+    "./package.json": "./package.json",
+    "./protocol": {
+      "types": "./dist/protocol/index.d.ts",
+      "import": "./dist/protocol/index.js"
+    },
+    "./css-policy": {
+      "types": "./dist/css-policy/css-policy.d.mts",
+      "import": "./dist/css-policy/css-policy.mjs"
+    }
+  },
+  "files": [
+    "dist/",
+    "index.d.mts",
+    "README.md",
+    "THIRD_PARTY_LICENSES",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build:contract": "tsc -p tsconfig.protocol.json && node scripts/copy-contract.mjs",
+    "build": "npm run build:contract && node scripts/build-runtime.mjs && node scripts/pack.mjs",
+    "build:native": "npm run build:contract && node scripts/build-runtime.mjs && node scripts/pack.mjs",
+    "test": "npm run build && node --test \"test/*.test.mjs\""
+  },
+  "dependencies": {
+    "postcss": "^8.5.26",
+    "postcss-selector-parser": "^7.1.0",
+    "postcss-value-parser": "^4.2.0"
+  },
+  "devDependencies": {
+    "@jitl/quickjs-wasmfile-release-sync": "0.32.0",
+    "esbuild-wasm": "0.28.2",
+    "parse5": "7.3.0",
+    "quickjs-emscripten-core": "0.32.0",
+    "react": "19.2.8",
+    "react-dom": "19.2.8",
+    "tailwindcss": "4.3.3",
+    "typescript": "npm:@typescript/typescript6@6.0.2"
+  },
+  "license": "SEE LICENSE IN LICENSE"
+}