nixos/paperless: expose manage package (#405610)

nixos/doc/manual/release-notes/rl-2505.section.md

@@ -598,8 +598,9 @@ Alongside many enhancements to NixOS modules and general system improvements, th
 
 - There is a new set of NixOS test tools for testing virtual Wi-Fi networks in many different topologies. See the {option}`services.vwifi` module, {option}`services.kismet` NixOS test, and [manual](https://nixos.org/manual/nixpkgs/unstable/#sec-nixos-test-wifi) for documentation and examples.
 
-- The paperless module now has an option for regular automatic export of
-  documents data using the integrated document exporter.
+- The paperless module now has an option for regular automatic export of documents data using the integrated document exporter.
+
+- Exposed the `paperless-manage` script package via the `services.paperless.manage` read-only option.
 
 - New options for the declarative configuration of the user space part of ALSA have been introduced under [hardware.alsa](options.html#opt-hardware.alsa.enable), including setting the default capture and playback device, defining sound card aliases and volume controls.
   Note: these are intended for users not running a sound server like PulseAudio or PipeWire, but having ALSA as their only sound system.

nixos/modules/services/misc/paperless.nix

@@ -366,11 +366,21 @@ in
         Whether to configure Tika and Gotenberg to process Office and e-mail files with OCR.
       '';
     };
+
+    manage = lib.mkOption {
+      type = lib.types.package;
+      readOnly = true;
+      description = ''
+        The package derivation for the `paperless-manage` wrapper script.
+        Useful for other modules that need to add this specific script to a service's PATH.
+      '';
+    };
   };
 
   config = lib.mkIf cfg.enable (
     lib.mkMerge [
       {
+        services.paperless.manage = manage;
         environment.systemPackages = [ manage ];
 
         services.redis.servers.paperless.enable = lib.mkIf enableRedis true;