@kici-dev/orchestrator 0.11.0 → 0.13.0

package/dist/cli/service/windows-env-file.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Whether a Windows service launch runs a release that reads KICI_ENV_FILE.
+ *
+ * A Windows service is registered with the path of its env file in
+ * KICI_ENV_FILE, never with the values in the file: any local account reads the
+ * command line of a service with `sc.exe qc`. A release from before
+ * KICI_ENV_FILE ignores the path and starts without its configuration, and the
+ * only registration that would run it puts the values back on the command line.
+ * So every command that registers a Windows service, or switches one to another
+ * release, refuses such a release before it changes anything.
+ */
+/**
+ * The `@kici-dev/shared` export that loads the env file KICI_ENV_FILE names. A
+ * release publishes it, and imports it first in each entry, only when it reads
+ * KICI_ENV_FILE.
+ */
+export declare const ENV_FILE_LOADER_EXPORT = "./load-service-env-file";
+/**
+ * The file that names a launch's release: the npm entry among its arguments,
+ * or else the executable itself.
+ */
+export declare function launchedRelease(launch: {
+    executablePath: string;
+    args?: string[];
+}): string;
+/**
+ * Whether the process a Windows service launch starts reads KICI_ENV_FILE.
+ *
+ * A KiCI package runs as `<dir>\<name>.cmd` beside its bundle
+ * `<dir>\lib\<name>.cjs`, which names KICI_ENV_FILE when the release reads it.
+ * An npm install runs node with the `@kici-dev/<component>/dist/<entry>.js`
+ * entry, which then imports the env-file loader. Any other launch, such as a
+ * batch file with no KiCI bundle beside it or a custom executable, is taken to
+ * read it.
+ */
+export declare function launchReadsEnvFile(launch: {
+    executablePath: string;
+    args?: string[];
+}): boolean;
+/**
+ * Why a Windows service may not run `release`, a release from before
+ * KICI_ENV_FILE, and what the operator can do instead.
+ */
+export declare function envFileRefusal(release: string, envFilePath: string): string;
+//# sourceMappingURL=windows-env-file.d.ts.map

package/dist/cli/service/windows.d.ts

@@ -30,6 +30,8 @@ export declare class WindowsServiceManager implements ServiceManager {
      * not exist; exit 0 means it exists (possibly pending-delete).
      */
     private serviceExists;
+    /** The service's STATE code from `sc.exe query`, or undefined when the query fails. */
+    private queryStateCode;
     install(config: ServiceConfig): Promise<void>;
     uninstall(config: ServiceConfig): Promise<void>;
     start(config: ServiceConfig): Promise<void>;
@@ -39,6 +41,17 @@ export declare class WindowsServiceManager implements ServiceManager {
     logs(config: ServiceConfig, _options: LogOptions): Promise<void>;
     isInstalled(config: ServiceConfig): Promise<boolean>;
     list(isUserLevel: boolean): Promise<DiscoveredInstance[]>;
+    /**
+     * The command line a service is registered with.
+     *
+     * `sc.exe qc` answers most registrations, but it fails (error 1734) once the
+     * line is longer than about 4000 characters, as an older CLI's registration
+     * with every env-file value on it can be. It also prints in the console code
+     * page, so a path outside ASCII, such as one under the profile of a user
+     * named Jürgen, decodes to U+FFFD. In either case the registry value it reads
+     * (`ImagePath`) is read through PowerShell, printed as UTF-8.
+     */
+    private registeredCommandLine;
     readLaunchSpec(config: ServiceConfig): Promise<LaunchSpec | null>;
 }
 //# sourceMappingURL=windows.d.ts.map