Compare commits
2
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
7f587b5e36 | ||
|
|
ee0559a52f |
No files matched your search
@@ -486,3 +486,96 @@ Seeders in `wwv-data-engine/src/seeders/` provide the backend data.
|
|||||||
- **Cron Seeder**: Uses `registerSeeder({ name: "plugin-id", cron: "..." })` and pushes to Redis via `setLiveSnapshot()`.
|
- **Cron Seeder**: Uses `registerSeeder({ name: "plugin-id", cron: "..." })` and pushes to Redis via `setLiveSnapshot()`.
|
||||||
- **Init Seeder**: High-frequency or persistent websockets via `init: () => void`.
|
- **Init Seeder**: High-frequency or persistent websockets via `init: () => void`.
|
||||||
- **Constraint**: Seeder `name` MUST exactly match the frontend plugin `id`. Do not bundle workspace dependencies like `ws` or `zod` into the seeder `dist`.
|
- **Constraint**: Seeder `name` MUST exactly match the frontend plugin `id`. Do not bundle workspace dependencies like `ws` or `zod` into the seeder `dist`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Plugin Bundle Footguns
|
||||||
|
|
||||||
|
### 1. CSP blocks CDN stylesheets -- use `?inline` + `<style>` injection
|
||||||
|
|
||||||
|
The host app's `style-src` policy includes `'unsafe-inline'` but does **not** include external CDN origins like `unpkg.com` or `cdn.jsdelivr.net`. Any plugin that loads CSS via a runtime `<link href="https://unpkg.com/...">` will have that stylesheet **silently blocked** by the browser -- no console error, just broken styling and broken layout (elements fall back to `position: static`).
|
||||||
|
|
||||||
|
**Wrong:**
|
||||||
|
```typescript
|
||||||
|
// In useEffect:
|
||||||
|
link.href = "https://unpkg.com/gridstack@11/dist/gridstack.min.css";
|
||||||
|
document.head.appendChild(link);
|
||||||
|
```
|
||||||
|
|
||||||
|
**Correct -- bundle CSS as inline string and inject via `<style>` tag:**
|
||||||
|
```typescript
|
||||||
|
import gridstackCSS from "gridstack/dist/gridstack.min.css?inline";
|
||||||
|
|
||||||
|
// In useEffect:
|
||||||
|
const style = document.createElement("style");
|
||||||
|
style.textContent = gridstackCSS;
|
||||||
|
document.head.appendChild(style);
|
||||||
|
```
|
||||||
|
|
||||||
|
Vite's `?inline` suffix imports CSS as a plain string. The `<style>` tag is allowed by `'unsafe-inline'`. This is the only CSP-safe pattern for third-party CSS in plugin bundles.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2. `inlineDynamicImports: true` -- not `codeSplitting: false`
|
||||||
|
|
||||||
|
`codeSplitting: false` is **not a valid Rollup option**. It is silently ignored, and Rollup will still produce code-split chunks. The host can only load a single `frontend.mjs` -- any sibling chunk (e.g. `gridstack-XXXXX.js`) will 404.
|
||||||
|
|
||||||
|
**Wrong:**
|
||||||
|
```js
|
||||||
|
rollupOptions: {
|
||||||
|
output: { codeSplitting: false } // silently ignored
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Correct:**
|
||||||
|
```js
|
||||||
|
rollupOptions: {
|
||||||
|
output: { inlineDynamicImports: true } // prevents all code splitting
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Both `vite.config.ts` (for manual `pnpm build`) and `scripts/sync-local-plugins.mjs` must use `inlineDynamicImports: true`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 3. `process.env.NODE_ENV` in CJS deps -- needs inline Rollup transform, not Vite `define`
|
||||||
|
|
||||||
|
CJS dependencies like `recharts`, `prop-types`, and `react-is` reference `process.env.NODE_ENV` inside their CommonJS module body. Vite's top-level `define: { 'process.env.NODE_ENV': '"production"' }` does NOT reach inside Rollup's `__commonJSMin()` wrappers -- those run after the `define` substitution phase.
|
||||||
|
|
||||||
|
**Wrong:**
|
||||||
|
```js
|
||||||
|
// In vite.config.ts or sync-local-plugins.mjs:
|
||||||
|
define: { 'process.env.NODE_ENV': '"production"' } // doesn't reach CJS wrappers
|
||||||
|
```
|
||||||
|
|
||||||
|
**Correct -- add an inline Rollup transform plugin inside `rollupOptions.plugins`:**
|
||||||
|
```js
|
||||||
|
rollupOptions: {
|
||||||
|
plugins: [
|
||||||
|
{
|
||||||
|
name: 'replace-process-env',
|
||||||
|
transform(code) {
|
||||||
|
if (!code.includes('process.env.NODE_ENV')) return null;
|
||||||
|
return {
|
||||||
|
code: code.replace(/process\.env\.NODE_ENV/g, '"production"'),
|
||||||
|
map: null,
|
||||||
|
};
|
||||||
|
},
|
||||||
|
},
|
||||||
|
// ... other plugins
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
This plugin runs on each module source before Rollup wraps it, so it correctly replaces `process.env.NODE_ENV` in CJS sub-dependencies.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 4. Yahoo Finance and third-party data APIs -- CORS from the browser
|
||||||
|
|
||||||
|
Yahoo Finance's chart API (`query1.finance.yahoo.com`) does **not** return `Access-Control-Allow-Origin` headers. Direct `fetch()` from a plugin bundle running in the browser will be CORS-blocked.
|
||||||
|
|
||||||
|
**Architectural preference (in order):**
|
||||||
|
1. **Best:** Have the wwv-data-engine seeder fetch the data server-side and stream it to the plugin via WebSocket -- no CORS issue.
|
||||||
|
2. **Acceptable stopgap:** Use `corsproxy.io` relay: `fetch('https://corsproxy.io/?url=' + encodeURIComponent(apiUrl))`. This adds a third-party relay dependency.
|
||||||
|
3. **Do not do:** Assume browser `fetch()` to third-party financial APIs will work -- most do not send CORS headers.
|
||||||
Generated
+646
File diff suppressed because it is too large.
Load diff
@@ -251,10 +251,22 @@ export async function buildPlugin({ dir, manifest, pkg, pluginDir }) {
|
|||||||
external: Object.keys(EXTERNAL_GLOBALS),
|
external: Object.keys(EXTERNAL_GLOBALS),
|
||||||
output: {
|
output: {
|
||||||
globals: EXTERNAL_GLOBALS,
|
globals: EXTERNAL_GLOBALS,
|
||||||
codeSplitting: false,
|
inlineDynamicImports: true,
|
||||||
banner: '"use client";',
|
banner: '"use client";',
|
||||||
},
|
},
|
||||||
plugins: [(await import("rollup-plugin-external-globals")).default(EXTERNAL_GLOBALS)],
|
plugins: [
|
||||||
|
{
|
||||||
|
name: 'replace-process-env',
|
||||||
|
transform(code) {
|
||||||
|
if (!code.includes('process.env.NODE_ENV')) return null;
|
||||||
|
return {
|
||||||
|
code: code.replace(/process\.env\.NODE_ENV/g, '"production"'),
|
||||||
|
map: null,
|
||||||
|
};
|
||||||
|
},
|
||||||
|
},
|
||||||
|
(await import("rollup-plugin-external-globals")).default(EXTERNAL_GLOBALS),
|
||||||
|
],
|
||||||
onwarn(warning, warn) {
|
onwarn(warning, warn) {
|
||||||
if (warning.code === 'MODULE_LEVEL_DIRECTIVE' && warning.message.includes('"use client"')) {
|
if (warning.code === 'MODULE_LEVEL_DIRECTIVE' && warning.message.includes('"use client"')) {
|
||||||
return;
|
return;
|
||||||
@@ -292,6 +304,13 @@ export function syncToPublic({ dir, manifest, pluginDir }, { quiet = false } = {
|
|||||||
if (fs.existsSync(distMap)) {
|
if (fs.existsSync(distMap)) {
|
||||||
fs.copyFileSync(distMap, path.join(targetDir, "frontend.mjs.map"));
|
fs.copyFileSync(distMap, path.join(targetDir, "frontend.mjs.map"));
|
||||||
}
|
}
|
||||||
|
// Copy any CSS files emitted alongside the bundle (e.g. from gridstack imports)
|
||||||
|
const distDir = path.join(pluginDir, "dist");
|
||||||
|
for (const f of fs.readdirSync(distDir)) {
|
||||||
|
if (f.endsWith(".css")) {
|
||||||
|
fs.copyFileSync(path.join(distDir, f), path.join(targetDir, f));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
// Generate plugin.json manifest for the marketplace load route
|
// Generate plugin.json manifest for the marketplace load route
|
||||||
const pluginJson = {
|
const pluginJson = {
|
||||||
|
|||||||
Reference in new issue
Block a user