rlz-engine 1.0.57 → 1.0.58

package/README.md

@@ -29,14 +29,15 @@ import { syncItems } from 'rlz-engine/client/sync.js'
 
 Each backend feature lives in a cohesive directory and exposes an uppercase `<FEATURE>_MODULE` object from `module.ts`. The object contains only the integration factories that feature supports. Applications invoke the factories for the integrations they want, then pass the returned facet values to `composeModules()`.
 
-| Module          | Facets                                    | Purpose                                                             |
-| --------------- | ----------------------------------------- | ------------------------------------------------------------------- |
-| `AUTH_MODULE`   | `makeRpc(storage, options?)`, `makeCli()` | Signup/signin/session/logout RPC endpoints and admin secret command |
-| `HTTP_MODULE`   | `makeCli(params, options?)`                | `http start` server command                                         |
-| `LOGGER_MODULE` | `makeCli()`, `makeAdmRpc()`               | Audit-log reader command and protected audit query endpoint         |
-| `RPC_MODULE`    | `makeDevCli(options)`                     | Generate user and administrative RPC clients during development     |
+| Module               | Facets                                    | Purpose                                                             |
+| -------------------- | ----------------------------------------- | ------------------------------------------------------------------- |
+| `AUTH_MODULE`        | `makeRpc(storage, options?)`, `makeCli()` | Signup/signin/session/logout RPC endpoints and admin secret command |
+| `CERTIFICATE_MODULE` | `makeCli()`, `makeAdmRpc()`, `makeAdm()`  | ACME account registration and certificate status                    |
+| `HTTP_MODULE`        | `makeCli(params, options?)`               | `http start` server command                                         |
+| `LOGGER_MODULE`      | `makeCli()`, `makeAdmRpc()`               | Audit-log reader command and protected audit query endpoint         |
+| `RPC_MODULE`         | `makeDevCli(options)`                     | Generate user and administrative RPC clients during development     |
 
-The composer groups selected operational CLI, development CLI, user RPC, and administrative RPC facets. It rejects duplicate names within each facet kind before startup. It deliberately leaves factory arguments with the application: server settings, route handlers, working directories, and generated-client paths are application-specific. The React administration UI and certificate-status module remain planned; the administrative RPC transport and audit-log endpoint are available now.
+The composer groups selected operational CLI, development CLI, user RPC, and administrative RPC facets. It rejects duplicate names within each facet kind before startup. It deliberately leaves factory arguments with the application: server settings, route handlers, working directories, and generated-client paths are application-specific. The React administration UI, audit-log viewer, and certificate-status module are available as opt-in modules.
 
 ### CLI composition
 
@@ -46,6 +47,7 @@ The composer groups selected operational CLI, development CLI, user RPC, and adm
 import { CliEngine, DevCliEngine } from 'rlz-engine/back/cli/cli-engine.js'
 import { composeModules } from 'rlz-engine/back/module/composer.js'
 import { AUTH_MODULE } from 'rlz-engine/back/auth/module.js'
+import { CERTIFICATE_MODULE } from 'rlz-engine/back/certificate/module.js'
 import { HTTP_MODULE } from 'rlz-engine/back/http/module.js'
 import { LOGGER_MODULE } from 'rlz-engine/back/logger/module.js'
 import { RPC_MODULE } from 'rlz-engine/back/rpc/module.js'
@@ -55,7 +57,12 @@ const applicationPlugin = async (server) => {
 }
 
 const applicationModules = composeModules({
-    cli: [AUTH_MODULE.makeCli(), HTTP_MODULE.makeCli(serverParams, { plugins: [applicationPlugin] }), LOGGER_MODULE.makeCli()],
+    cli: [
+        AUTH_MODULE.makeCli(),
+        CERTIFICATE_MODULE.makeCli(),
+        HTTP_MODULE.makeCli(serverParams, { plugins: [applicationPlugin] }),
+        LOGGER_MODULE.makeCli()
+    ],
     rpc: userRpcPlugins,
     admRpc: [LOGGER_MODULE.makeAdmRpc()]
 })

package/dist/back/certificate/cli.d.ts

@@ -0,0 +1,3 @@
+import type { CliModule } from '../cli/cli-engine.js';
+/** Create the ACME account registration command. */
+export declare function makeCertificateCli(): CliModule;

package/dist/back/certificate/cli.js

@@ -0,0 +1,17 @@
+import { registerAcmeAccountCli } from 'fastify-acme';
+/** Create the ACME account registration command. */
+export function makeCertificateCli() {
+    return {
+        name: 'certificates',
+        description: 'Manage server certificate setup.',
+        commands: {
+            'register-acme': {
+                description: 'Register the ACME account used for TLS certificates.',
+                handler: async () => {
+                    await registerAcmeAccountCli();
+                }
+            }
+        }
+    };
+}
+//# sourceMappingURL=cli.js.map

package/dist/back/certificate/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/back/certificate/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAIrD,oDAAoD;AACpD,MAAM,UAAU,kBAAkB;IAC9B,OAAO;QACH,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,kCAAkC;QAC/C,QAAQ,EAAE;YACN,eAAe,EAAE;gBACb,WAAW,EAAE,sDAAsD;gBACnE,OAAO,EAAE,KAAK,IAAI,EAAE;oBAChB,MAAM,sBAAsB,EAAE,CAAA;gBAClC,CAAC;aACJ;SACJ;KACJ,CAAA;AACL,CAAC"}

package/dist/back/certificate/module.d.ts

@@ -1,5 +1,6 @@
 import type { AdmModule } from '../../client/adm/admin.js';
 import { makeCertificateAdmRpc } from './adm-rpc.js';
+import { makeCertificateCli } from './cli.js';
 export interface CertificateModuleOptions {
     certDir: string;
     domain: string;
@@ -7,6 +8,7 @@ export interface CertificateModuleOptions {
 declare function makeAdm(): AdmModule;
 /** TLS certificate status integrations. */
 export declare const CERTIFICATE_MODULE: {
+    makeCli: typeof makeCertificateCli;
     makeAdmRpc: typeof makeCertificateAdmRpc;
     makeAdm: typeof makeAdm;
 };

package/dist/back/certificate/module.js

@@ -1,6 +1,7 @@
 import { admRpcCall } from '../../client/rpc.js';
 import { CertificateStatus } from '../../client/adm/certificate.js';
 import { makeCertificateAdmRpc } from './adm-rpc.js';
+import { makeCertificateCli } from './cli.js';
 function makeAdm() {
     return {
         name: 'certificate',
@@ -13,6 +14,7 @@ function makeAdm() {
 }
 /** TLS certificate status integrations. */
 export const CERTIFICATE_MODULE = {
+    makeCli: makeCertificateCli,
     makeAdmRpc: makeCertificateAdmRpc,
     makeAdm
 };

package/dist/back/certificate/module.js.map

@@ -1 +1 @@
-{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../src/back/certificate/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAEnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAOpD,SAAS,OAAO;IACZ,OAAO;QACH,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,aAAa;QACpB,SAAS,EAAE,iBAAiB;QAC5B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACnB,MAAM,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;QAC1D,CAAC;KACJ,CAAA;AACL,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAC9B,UAAU,EAAE,qBAAqB;IACjC,OAAO;CACV,CAAA"}
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../src/back/certificate/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAEnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAO7C,SAAS,OAAO;IACZ,OAAO;QACH,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,aAAa;QACpB,SAAS,EAAE,iBAAiB;QAC5B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACnB,MAAM,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;QAC1D,CAAC;KACJ,CAAA;AACL,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAC9B,OAAO,EAAE,kBAAkB;IAC3B,UAAU,EAAE,qBAAqB;IACjC,OAAO;CACV,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "rlz-engine",
-    "version": "1.0.57",
+    "version": "1.0.58",
     "description": "Deps and tools for my style of development",
     "engines": {
         "node": ">=22.13.0"