{"id":22297,"library":"rollup-plugin-zephyr","title":"rollup-plugin-zephyr","description":"Rollup plugin for Zephyr, a cloud deployment platform. Current stable version is 1.0.2 (released after v1.0.0 breaking changes). This plugin integrates Rollup builds with Zephyr's deployment pipeline, enabling automatic upload of build artifacts. It requires Rollup ^4.0.0 as a peer dependency. Key differentiators: built-in support for Zephyr's staged deployments, automatic version tracking, and integration with Zephyr's cloud infrastructure. Release cadence is irregular with patches for dependency updates and security fixes.","status":"active","version":"1.0.2","language":"javascript","source_language":"en","source_url":"https://github.com/ZephyrCloudIO/zephyr-packages","tags":["javascript","rollup","rollup-plugin","zephyr","deploy","typescript"],"install":[{"cmd":"npm install rollup-plugin-zephyr","lang":"bash","label":"npm"},{"cmd":"yarn add rollup-plugin-zephyr","lang":"bash","label":"yarn"},{"cmd":"pnpm add rollup-plugin-zephyr","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency: requires Rollup ^4.0.0 for plugin API.","package":"rollup","optional":false}],"imports":[{"note":"Default export is the plugin function. Named export 'zephyr' does not exist. Valid for ESM.","wrong":"import { zephyr } from 'rollup-plugin-zephyr'","symbol":"default (plugin)","correct":"import zephyr from 'rollup-plugin-zephyr'"},{"note":"Named export available in ESM. CommonJS require yields default export, not named.","wrong":"const zephyrPlugin = require('rollup-plugin-zephyr')","symbol":"zephyrPlugin (named)","correct":"import { zephyrPlugin } from 'rollup-plugin-zephyr'"},{"note":"Type import to avoid runtime overhead. Type is exported for TypeScript users.","wrong":"import { ZephyrOptions } from 'rollup-plugin-zephyr'","symbol":"type ZephyrOptions","correct":"import type { ZephyrOptions } from 'rollup-plugin-zephyr'"},{"note":"CommonJS require returns the default export. Named destructuring will be undefined.","wrong":"const { zephyrPlugin } = require('rollup-plugin-zephyr')","symbol":"require (CommonJS)","correct":"const zephyr = require('rollup-plugin-zephyr')"}],"quickstart":{"code":"import zephyr from 'rollup-plugin-zephyr';\n\nexport default {\n  input: 'src/index.js',\n  output: {\n    dir: 'dist',\n    format: 'esm',\n  },\n  plugins: [\n    zephyr({\n      // Zephyr deployment configuration\n      url: process.env.ZEPHYR_URL ?? '',\n      apiKey: process.env.ZEPHYR_API_KEY ?? '',\n      // Optional: specify project\n      project: 'my-app',\n    }),\n  ],\n};\n","lang":"typescript","description":"Basic Rollup configuration using rollup-plugin-zephyr with environment variables for authentication and deployment settings."},"warnings":[{"fix":"Update plugin configuration to match v1 API. Review changelog at https://github.com/ZephyrCloudIO/zephyr-packages/releases/tag/v1.0.0","message":"Version 1.0.0 introduced breaking changes. Check migration guide from v0.x.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Upgrade Rollup to v4+: npm install rollup@^4.0.0","message":"Plugin now requires Rollup ^4.0.0; older Rollup versions are not supported.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Use default import: import zephyr from 'rollup-plugin-zephyr' or require('rollup-plugin-zephyr') (no destructuring).","message":"Named export 'zephyrPlugin' is available but default export is the plugin function. CommonJS require only gives default.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Ensure Node.js >=18 and zephyr-agent properly installed (if applicable).","message":"Plugin may require specific Node.js version or Zephyr agent. Check documentation for compatibility.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Upgrade to v1.0.2: npm install rollup-plugin-zephyr@latest","message":"Older versions (v0.1.x) may have security vulnerabilities; remediations in v1.0.1+ include pnpm advisory patches.","severity":"deprecated","affected_versions":"<1.0.1"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Change to: import zephyr from 'rollup-plugin-zephyr'","cause":"Using default import incorrectly (e.g., named import '{ zephyr }' instead of default).","error":"TypeError: zephyr is not a function"},{"fix":"Install rollup: npm install rollup@^4.0.0","cause":"Missing peer dependency rollup ^4.0.0.","error":"Error: Cannot find module 'rollup'"},{"fix":"Use: const zephyr = require('rollup-plugin-zephyr')","cause":"Using CommonJS require with named destructuring on a default export package.","error":"SyntaxError: Unexpected token 'export'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}