@idleberg/vite-plugin-devcert 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Jan T. Sott
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,60 @@
+# @idleberg/vite-plugin-devcert
+
+> A Vite plugin to generate trusted SSL/TLS certificates for local development.
+
+[![License](https://img.shields.io/github/license/idleberg/vite-plugin-devcert?color=blue&style=for-the-badge)](https://github.com/idleberg/vite-plugin-devcert/blob/main/LICENSE)
+[![Version: npm](https://img.shields.io/npm/v/@idleberg/vite-plugin-devcert?style=for-the-badge)](https://www.npmjs.org/package/@idleberg/vite-plugin-devcert)
+[![Version: jsr](https://img.shields.io/jsr/v/@idleberg/vite-plugin-devcert?style=for-the-badge)](https://jsr.io/@idleberg/vite-plugin-devcert)
+[![CI: Node](https://img.shields.io/github/actions/workflow/status/idleberg/vite-plugin-devcert/node.yml?logo=nodedotjs&logoColor=white&style=for-the-badge)](https://github.com/idleberg/vite-plugin-devcert/actions/workflows/node.yml)
+[![CI: Deno](https://img.shields.io/github/actions/workflow/status/idleberg/vite-plugin-devcert/deno.yml?logo=deno&logoColor=white&style=for-the-badge)](https://github.com/idleberg/vite-plugin-devcert/actions/workflows/deno.yml)
+
+> ![NOTE]
+> This plugin is based on `@expo/devcert`, an actively maintained version of `devcert`. Read about [How it works](https://github.com/expo/devcert/tree/master?tab=readme-ov-file#how-it-works) and what the [Security Concerns](https://github.com/expo/devcert/tree/master?tab=readme-ov-file#security-concerns).
+
+## Installation
+
+On NodeJS or Bun you can install from npm
+
+```shell
+npm install @idleberg/vite-plugin-devcert
+```
+
+On Deno you can install using JSR
+
+```shell
+deno add jsr:@idleberg/vite-plugin-devcert
+```
+
+## Usage
+
+```javascript
+import { defineConfig } from "vite";
+import devCert from "@idleberg/vite-plugin-devcert";
+
+export default defineConfig({
+	plugins: [devCert()],
+});
+```
+
+### API
+
+`devCert(options?)`
+
+### Options
+
+#### `options.skipHostsFile`
+
+If `certutil` is not installed already (for updating NSS databases; e.g. Firefox), do not attempt to install it. [Read more](https://github.com/expo/devcert#skiphostsfile).
+
+### `options.skipCertutil``
+
+Do not update your systems host file with the domain name of the certificate. [Read more](https://github.com/expo/devcert#skipcertutil).
+
+## Related
+
+- [vite-plugin-basic-ssl](https://github.com/vitejs/vite-plugin-basic-ssl)
+- [vite-plugin-mkcert](https://github.com/vite-plugin/vite-plugin-mkcert)
+
+## License
+
+This work is licensed under [The MIT License](LICENSE).

package/dist/plugin.d.ts

@@ -0,0 +1,13 @@
+import { CommonServerOptions, UserConfig, Plugin } from 'vite';
+
+type PluginOptions = CommonServerOptions & {
+    overrides?: Pick<UserConfig, 'base' | 'cacheDir' | 'clearScreen' | 'customLogger' | 'define' | 'envDir' | 'envPrefix' | 'mode' | 'plugins' | 'publicDir' | 'root'>;
+};
+/**
+ * Exports a Vite plugin launches multiple servers.
+ * @param options - an array of server options and Vite overrides
+ * @returns a Vite plugins
+ */
+declare function MultiserverPlugin(options: PluginOptions | PluginOptions[]): Plugin;
+
+export { MultiserverPlugin as default };

package/dist/plugin.js

@@ -0,0 +1,34 @@
+import { certificateFor } from '@expo/devcert';
+import logSymbols from 'log-symbols';
+
+// src/plugin.ts
+function DevcertPlugin(options) {
+  return {
+    name: "@idleberg/vite-plugin-devcert",
+    config: async (userConfig, { command }) => {
+      if (command !== "serve") {
+        return;
+      }
+      const { server } = userConfig;
+      if (server?.https?.key && server?.https?.cert) {
+        console.warn(`${logSymbols.warning} Skipping devcert, key and cert already provided.`);
+        return userConfig;
+      }
+      const domain = server?.host && typeof server.host === "string" ? server.host : "localhost";
+      const { key, cert } = await certificateFor(domain, options);
+      return {
+        ...userConfig,
+        server: {
+          ...server,
+          https: {
+            ...server?.https,
+            key: key ?? void 0,
+            cert: cert ?? void 0
+          }
+        }
+      };
+    }
+  };
+}
+
+export { DevcertPlugin as default };

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@idleberg/vite-plugin-devcert",
+  "version": "0.1.0",
+  "description": "A Vite plugin to generate trusted SSL/TLS certificates for local development",
+  "license": "MIT",
+  "author": "Jan T. Sott",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/idleberg/vite-plugin-devcert"
+  },
+  "keywords": [
+    "vite-plugin",
+    "vite-server",
+    "server",
+    "http-server",
+    "certificate",
+    "ssl",
+    "tls"
+  ],
+  "type": "module",
+  "exports": "./dist/plugin.js",
+  "types": "./dist/plugin.d.ts",
+  "engines": {
+    "node": "^18.0.0 || ^20.0.0 || >=22.0.0"
+  },
+  "files": [
+    "dist/",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "@expo/devcert": "^1.2.0",
+    "log-symbols": "^7.0.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@total-typescript/tsconfig": "^1.0.4",
+    "@types/node": "^22.15.21",
+    "lefthook": "^1.11.13",
+    "np": "^10.2.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3",
+    "vite": "^6.3.5"
+  },
+  "peerDependencies": {
+    "vite": ">=1.0.0 <7.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "biome check --no-errors-on-unmatched --vcs-enabled=true --vcs-use-ignore-file=true",
+    "publish:jsr": "deno publish",
+    "publish:npm": "np --any-branch",
+    "test": "echo \"No tests specified\" && exit 0"
+  }
+}