@plitzi/sdk-server 0.30.19

package/dist/src/modules/rsc/handler.d.ts

@@ -0,0 +1,17 @@
+import { TtlCache } from '../../helpers/cache';
+import { PluginManager } from '../../plugins/manager';
+import { SSRRequest, SSRResponseHelpers, SSRServerConfig } from '@plitzi/sdk-shared';
+/**
+ * Handles GET /_rsc requests.
+ *
+ * Calls adapters.getRscData to get server-side data for elements marked
+ * runtime:'server' in the schema, then returns a JSON payload. The SDK
+ * client uses this payload to update server-driven portions of the page
+ * without a full navigation.
+ *
+ * Responses are cached server-side (TtlCache) and via Cache-Control headers:
+ * - main environment: no-store (development, always fresh)
+ * - Authenticated requests: Cache-Control: private, max-age=<ttl>
+ * - Unauthenticated requests: Cache-Control: public, max-age=<ttl>
+ */
+export declare const handleRsc: (req: SSRRequest, res: SSRResponseHelpers, config: SSRServerConfig, _pluginManager: PluginManager, cache?: TtlCache<string>) => Promise<void>;

package/dist/src/modules/ssr/Component.d.ts

@@ -0,0 +1,11 @@
+import { OfflineDataRaw, Environment, RenderMode, Server, SSRPlugin } from '@plitzi/sdk-shared';
+export type ComponentProps = {
+    server: Partial<Server>;
+    renderMode?: Extract<RenderMode, 'raw'>;
+    environment?: Environment;
+    previewMode?: boolean;
+    offlineData?: OfflineDataRaw;
+    plugins?: Record<string, SSRPlugin>;
+};
+declare const Component: ({ server, renderMode, previewMode, offlineData, environment, plugins }: ComponentProps) => import("react/jsx-runtime").JSX.Element;
+export default Component;

package/dist/src/modules/ssr/buildBody.d.ts

@@ -0,0 +1,5 @@
+import { TtlCache } from '../../helpers/cache';
+import { RequestMetrics } from '../../helpers/metrics';
+import { PluginManager } from '../../plugins/manager';
+import { Environment, SSRRequest, SSRServerConfig, SSRTemplateFn } from '@plitzi/sdk-shared';
+export declare const buildBody: (req: SSRRequest, config: SSRServerConfig, spaceId: number, environment: Environment, revision: number, renderFn: SSRTemplateFn, pluginManager: PluginManager, offlineDataCache?: TtlCache<string>, metrics?: RequestMetrics) => Promise<string>;

package/dist/src/modules/ssr/handler.d.ts

@@ -0,0 +1,4 @@
+import { ServerCaches } from '../../helpers/cache';
+import { PluginManager } from '../../plugins/manager';
+import { SSRRequest, SSRResponseHelpers, SSRServerConfig, SSRTemplateFn } from '@plitzi/sdk-shared';
+export declare const renderSSR: (req: SSRRequest, res: SSRResponseHelpers, config: SSRServerConfig, renderFn: SSRTemplateFn, pluginManager: PluginManager, caches: ServerCaches) => Promise<void>;

package/dist/src/modules/ssr/loadPluginComponents.d.ts

@@ -0,0 +1,13 @@
+import { PluginEntry, SSRPlugin } from '@plitzi/sdk-shared';
+/**
+ * Dynamically imports plugin components from their compiled filesystem paths and returns
+ * a Record<keyName, FC> suitable for passing to <PlitziSdk.Plugin>.
+ *
+ * File-source plugins are cached by filePath so subsequent requests skip the import().
+ * Plugins that fail to import are added to a permanent skip-list — they are not retried
+ * and will be rendered client-side instead.
+ * Component-source plugins (already in memory via getComponents()) are merged in directly.
+ */
+export declare const loadPluginComponents: (entries: PluginEntry[], inlineComponents?: Record<string, unknown>) => Promise<Record<string, SSRPlugin>>;
+/** Removes one or all entries from the component and failed-import caches. Call after plugin rebuild. */
+export declare const invalidatePluginComponentCache: (filePath?: string) => void;

package/dist/src/modules/ssr/prepareRender.d.ts

@@ -0,0 +1,13 @@
+import { ComponentProps } from './Component';
+import { TtlCache } from '../../helpers/cache';
+import { RequestMetrics } from '../../helpers/metrics';
+import { PluginManager } from '../../plugins/manager';
+import { Environment, PluginEntry, SSRRequest, SSRServerConfig, SSRTemplateProps } from '@plitzi/sdk-shared';
+export type RenderPrep = {
+    componentProps: ComponentProps;
+    entries: PluginEntry[];
+    templateParams: SSRTemplateProps & {
+        offlineData: string;
+    };
+};
+export declare const prepareRender: (req: SSRRequest, config: SSRServerConfig, spaceId: number, environment: Environment, revision: number, pluginManager: PluginManager, offlineDataCache?: TtlCache<string>, metrics?: RequestMetrics) => Promise<RenderPrep>;

package/dist/src/modules/ssr/registerExternalPlugins.d.ts

@@ -0,0 +1,7 @@
+import { PluginManager } from '../../plugins/manager';
+import { OfflineDataRaw } from '@plitzi/sdk-shared';
+/**
+ * Reads plugins listed in offlineData.plugins, fetches their manifests, downloads and caches
+ * JS/CSS via the PluginManager, and returns the effective plugin keys to pass to getEntries().
+ */
+export declare const registerExternalPlugins: (pluginManager: PluginManager, offlineData: OfflineDataRaw | undefined) => Promise<string[]>;

package/dist/src/modules/ssr/streamBody.d.ts

@@ -0,0 +1,5 @@
+import { TtlCache } from '../../helpers/cache';
+import { RequestMetrics } from '../../helpers/metrics';
+import { PluginManager } from '../../plugins/manager';
+import { Environment, SSRRequest, SSRResponseHelpers, SSRServerConfig, SSRTemplateFn } from '@plitzi/sdk-shared';
+export declare const streamBody: (req: SSRRequest, res: SSRResponseHelpers, config: SSRServerConfig, spaceId: number, environment: Environment, revision: number, renderFn: SSRTemplateFn, pluginManager: PluginManager, offlineDataCache?: TtlCache<string>, htmlCache?: TtlCache<string>, cacheKey?: string, metrics?: RequestMetrics) => Promise<void>;

package/dist/src/modules/ssr/template.d.ts

@@ -0,0 +1,6 @@
+import { SSRTemplateFn, SSRTemplateProps } from '@plitzi/sdk-shared';
+export type TemplateParams = SSRTemplateProps & {
+    html: string;
+    offlineData: string;
+};
+export declare const compileTemplate: () => SSRTemplateFn;

package/dist/src/plugins/compile.d.ts

@@ -0,0 +1,3 @@
+export declare const compilePlugin: (jsPath: string, outDir: string, devMode?: boolean) => Promise<{
+    hasCSS: boolean;
+}>;

package/dist/src/plugins/copy.d.ts

@@ -0,0 +1 @@
+export declare const copyPlugin: (src: string, destDir: string, filename: string) => Promise<void>;

package/dist/src/plugins/detect.d.ts

@@ -0,0 +1,3 @@
+import { PluginAction, PluginSource, PluginSourceComponent } from '@plitzi/sdk-shared';
+export declare const isComponentSource: (source: PluginSource) => source is PluginSourceComponent;
+export declare const detectAction: (js: string) => PluginAction;

package/dist/src/plugins/manager.d.ts

@@ -0,0 +1,40 @@
+import { PluginEntry, PluginSource } from '@plitzi/sdk-shared';
+export declare class PluginManager {
+    readonly urlPrefix = "/sdk-plugins";
+    readonly outputDir: string;
+    private readonly plugins;
+    private readonly ttlMs;
+    private readonly mem;
+    private readonly inflight;
+    private readonly failed;
+    /** Maps base plugin name → most recently registered effective key (may include @version) */
+    private readonly nameIndex;
+    private readonly devMode;
+    constructor(plugins: Record<string, PluginSource>, cacheDir?: string, ttlMs?: number, devMode?: boolean);
+    hasPlugin(name: string): boolean;
+    register(name: string, source: PluginSource): void;
+    /**
+     * Registers a plugin only if it is not yet known under its effective key.
+     * Returns the effective key (`name@version` when version is set, `name` otherwise)
+     * so the caller can pass it directly to getEntries().
+     */
+    ensure(name: string, source: PluginSource): string;
+    /**
+     * Resolves a caller-supplied name to the effective key stored in the plugins map.
+     * Accepts both the exact key (`plitziBuilder@1.0.0`) and the base name (`plitziBuilder`).
+     */
+    private resolveKey;
+    private pluginDir;
+    private isExpired;
+    private toEntry;
+    private isWebUrl;
+    prepare(name: string): Promise<PluginEntry | null>;
+    private build;
+    getEntries(names: string[]): Promise<PluginEntry[]>;
+    getComponents(): Record<string, unknown>;
+    invalidate(name?: string, version?: string): Promise<void>;
+    destroy(): void;
+    private readMeta;
+    private writeMeta;
+    private fileExists;
+}

package/dist/src/standalone/alias-loader.d.mts

@@ -0,0 +1 @@
+export function resolve(specifier: any, context: any, defaultResolve: any): Promise<any>;

package/dist/src/standalone/plugins/ClientInfo.d.ts

@@ -0,0 +1,2 @@
+declare const ClientInfo: () => import("react/jsx-runtime").JSX.Element;
+export default ClientInfo;

package/dist/src/standalone/plugins/ServerInfo.d.ts

@@ -0,0 +1,2 @@
+declare const ServerInfo: () => import("react/jsx-runtime").JSX.Element;
+export default ServerInfo;

package/dist/src/standalone/plugins/SharedInfo.d.ts

@@ -0,0 +1,2 @@
+declare const SharedInfo: () => import("react/jsx-runtime").JSX.Element;
+export default SharedInfo;

package/dist/src/standalone/plugins/styles.d.ts

@@ -0,0 +1,5 @@
+import { CSSProperties } from 'react';
+export declare const card: (color: "green" | "blue" | "purple" | "gray" | "red") => CSSProperties;
+export declare const titleStyle: (color: "green" | "blue" | "purple" | "gray" | "red") => CSSProperties;
+export declare const row: CSSProperties;
+export declare const label: CSSProperties;

package/dist/src/standalone/register-alias.d.mts

@@ -0,0 +1 @@
+export {};

package/dist/src/standalone/server.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@plitzi/sdk-server",
+  "version": "0.30.19",
+  "license": "AGPL-3.0",
+  "files": [
+    "dist"
+  ],
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "repository": {
+    "type": "https",
+    "url": "https://github.com/plitzi/plitzi-workspace.git"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@plitzi/plitzi-sdk": "0.30.19",
+    "@plitzi/sdk-shared": "0.30.19",
+    "ejs": "^5.0.2",
+    "esbuild": "^0.28.0",
+    "zod": "^4.4.1"
+  },
+  "peerDependencies": {
+    "react": "^19",
+    "react-dom": "^19"
+  },
+  "devDependencies": {
+    "@types/ejs": "^3.1.5",
+    "@types/node": "^25.6.0",
+    "@types/react": "^19.2.14",
+    "@vitejs/plugin-react": "^6.0.1",
+    "eslint": "^9.39.4",
+    "eslint-plugin-import": "^2.32.0",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.10",
+    "vite-plugin-dts": "^5.0.0"
+  },
+  "scripts": {
+    "start:dev": "TSX_TSCONFIG_PATH=tsconfig.app.json ALIAS_LOADER_DEBUG=1  node --import ./src/standalone/register-alias.mjs --import tsx --watch src/standalone/server.ts",
+    "start": "TSX_TSCONFIG_PATH=tsconfig.app.json node --import tsx src/standalone/server.ts",
+    "start:watch": "TSX_TSCONFIG_PATH=tsconfig.app.json node --import tsx --watch src/standalone/server.ts",
+    "start:inspect": "TSX_TSCONFIG_PATH=tsconfig.app.json node --import tsx --inspect src/standalone/server.ts",
+    "build:dev": "vite build --mode development",
+    "build:prod": "vite build",
+    "lint": "TIMING=1 eslint ./src",
+    "typecheck": "tsc -p tsconfig.app.json --noEmit"
+  }
+}