@mbsks/rspfx-manifest-server 0.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RSPFX contributors
+
+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,28 @@
+# @mbsks/rspfx-manifest-server
+
+Development certificates for [RSPFX](https://github.com/master8848/rspfx) — an SPFx-compatible build toolchain powered by Rspack.
+
+Generates and caches the self-signed TLS key/cert pair used by the local HTTPS dev server (the compiler-rspack dev server; serving itself is handled there, not here). Certificates live in `~/.rspfx/certs` and are reused across runs.
+
+## Install
+
+```sh
+npm i @mbsks/rspfx-manifest-server
+```
+
+## Usage
+
+```ts
+import { ensureCertificates } from '@mbsks/rspfx-manifest-server';
+
+const { key, cert } = await ensureCertificates('.rspfx/certs');
+```
+
+## API
+
+- `ensureCertificates(dir)` — generate/load self-signed key + cert (writes `key.pem`, `cert.pem`, and `cert.pem.trust.txt` with trust instructions)
+
+## Links
+
+- [RSPFX documentation](https://github.com/master8848/rspfx/tree/main/docs)
+- License: MIT

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export declare function ensureCertificates(certsDir: string): Promise<{
+    key: string;
+    cert: string;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAsDA,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAqCjG"}

package/dist/index.js

@@ -0,0 +1,55 @@
+import { readFile, mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { createRequire } from 'node:module';
+import { createLogger } from '@mbsks/rspfx-diagnostics';
+const TRUST_NOTES = [
+    'RSPFX development certificate (self-signed, 825 days)',
+    '',
+    'key.pem / cert.pem are used by the local HTTPS dev server for localhost and 127.0.0.1.',
+    '',
+    'To make browsers and SharePoint trust this certificate, import cert.pem into the',
+    'trusted root store of your OS or browser, then restart the browser:',
+    '',
+    '  macOS:    sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain cert.pem',
+    '  Windows:  certutil -addstore -user Root cert.pem',
+    '  Linux:    import cert.pem into the browser or system trust store',
+    ''
+].join('\n');
+const require = createRequire(import.meta.url);
+const selfsigned = require('selfsigned');
+const logger = createLogger('rspfx');
+export async function ensureCertificates(certsDir) {
+    const keyPath = path.join(certsDir, 'key.pem');
+    const certPath = path.join(certsDir, 'cert.pem');
+    try {
+        const [key, cert] = await Promise.all([readFile(keyPath, 'utf8'), readFile(certPath, 'utf8')]);
+        return { key, cert };
+    }
+    catch {
+        // fall through to generation
+    }
+    await mkdir(certsDir, { recursive: true });
+    const pems = selfsigned.generate([{ name: 'commonName', value: 'localhost' }], {
+        keySize: 2048,
+        days: 825,
+        algorithm: 'sha256',
+        extensions: [
+            { name: 'extKeyUsage', serverAuth: true },
+            {
+                name: 'subjectAltName',
+                altNames: [
+                    { type: 2, value: 'localhost' },
+                    { type: 7, ip: '127.0.0.1' }
+                ]
+            }
+        ]
+    });
+    await Promise.all([
+        writeFile(keyPath, pems.private, { mode: 0o600 }),
+        writeFile(certPath, pems.cert),
+        writeFile(path.join(certsDir, 'cert.pem.trust.txt'), TRUST_NOTES)
+    ]);
+    logger.info(`Generated self-signed dev certificate in ${certsDir}. See cert.pem.trust.txt for trust instructions.`);
+    return { key: pems.private, cert: pems.cert };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,WAAW,GAAG;IAClB,uDAAuD;IACvD,EAAE;IACF,wFAAwF;IACxF,EAAE;IACF,kFAAkF;IAClF,qEAAqE;IACrE,EAAE;IACF,2GAA2G;IAC3G,oDAAoD;IACpD,oEAAoE;IACpE,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AA6Bb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,CAEtC,CAAC;AAEF,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;AAErC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/F,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;IACD,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAC9B,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,EAC5C;QACE,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,GAAG;QACT,SAAS,EAAE,QAAQ;QACnB,UAAU,EAAE;YACV,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE;YACzC;gBACE,IAAI,EAAE,gBAAgB;gBACtB,QAAQ,EAAE;oBACR,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE;oBAC/B,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE;iBAC7B;aACF;SACF;KACF,CACF,CAAC;IACF,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACjD,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC;QAC9B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,oBAAoB,CAAC,EAAE,WAAW,CAAC;KAClE,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CACT,4CAA4C,QAAQ,kDAAkD,CACvG,CAAC;IACF,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;AAChD,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@mbsks/rspfx-manifest-server",
+  "version": "0.0.3",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "selfsigned": "^2.4.1",
+    "@mbsks/rspfx-diagnostics": "0.0.3",
+    "@mbsks/rspfx-core": "0.0.3"
+  },
+  "description": "RSPFX HTTPS manifest server for the SharePoint workbench (:4321)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/master8848/rspfx.git"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run"
+  }
+}