metaharness 0.4.3 → 0.4.5

package/dist/meta-proxy-service.d.ts

@@ -0,0 +1,72 @@
+/** Reverse-DNS label, shared by the launchd job and the scheduled task. */
+export declare const SERVICE_LABEL = "one.cognitum.meta-proxy";
+export interface ServiceCommand {
+    command: string;
+    args: string[];
+}
+export interface CommandOutcome {
+    ok: boolean;
+    output: string;
+    error?: string;
+}
+export type CommandRunner = (invocation: ServiceCommand) => CommandOutcome;
+export interface ServiceResult {
+    ok: boolean;
+    message: string;
+    /** The unit/plist/task definition written, when one was. */
+    unitPath?: string;
+}
+export interface ServiceState {
+    supported: boolean;
+    /** The service manager currently has the job/unit/task loaded. */
+    installed: boolean;
+    unitPath: string | null;
+    managerState: 'enabled' | 'disabled' | 'unknown';
+    definitionPresent: boolean;
+    /** Whether the service manager currently has the job/unit/task loaded. */
+    loaded: boolean | null;
+    /** Whether the service remains configured to start on the user's next login. */
+    enabledAtLogin: boolean;
+    /** null means the manager answered but does not expose a portable run state. */
+    running: boolean | null;
+    pid: number | null;
+}
+export declare function launchAgentPath(home?: string, label?: string): string;
+export declare function systemdUnitPath(home?: string): string;
+/** The XML definition handed to `schtasks /create /xml`. */
+export declare function scheduledTaskPath(home?: string, label?: string): string;
+export declare function serviceUnitPath(platform: NodeJS.Platform, home?: string, label?: string): string | null;
+/**
+ * launchd job. `RunAtLoad` covers start-at-login and `KeepAlive.SuccessfulExit
+ * = false` covers restart-after-crash while still letting a deliberate
+ * `proxy stop` (SIGTERM, exit 0) stay stopped — a plain `KeepAlive: true` would
+ * fight the user's own stop command forever.
+ */
+export declare function renderLaunchAgent(binaryPath: string, logPath: string, label?: string): string;
+/**
+ * systemd **user** unit. `default.target` is the user-session target, so this is
+ * start-at-login rather than start-at-boot; booting a machine nobody has logged
+ * into should not run a user's proxy. `Restart=on-failure` matches the launchd
+ * choice: a clean stop stays stopped.
+ */
+export declare function renderSystemdUnit(binaryPath: string): string;
+/** Task Scheduler definition — Windows has no launchd/systemd equivalent. */
+export declare function renderScheduledTask(binaryPath: string): string;
+export declare function enableCommands(platform: NodeJS.Platform, unitPath: string, label?: string): ServiceCommand[];
+export declare function disableCommands(platform: NodeJS.Platform, unitPath: string, label?: string): ServiceCommand[];
+export declare function serviceStateCommand(platform: NodeJS.Platform, label?: string): ServiceCommand | null;
+export declare function metaProxyServiceState(platform?: NodeJS.Platform, home?: string, run?: CommandRunner, label?: string): ServiceState;
+export interface ServiceOptions {
+    home?: string;
+    platform?: NodeJS.Platform;
+    run?: CommandRunner;
+    /** Test/enterprise isolation hook; normal users always use SERVICE_LABEL. */
+    label?: string;
+    /** Bounded synchronous polling seam; production waits without spawning. */
+    wait?: (milliseconds: number) => void;
+}
+export declare function enableMetaProxyService(options?: ServiceOptions): ServiceResult;
+export declare function startMetaProxyService(options?: ServiceOptions): ServiceResult;
+export declare function stopMetaProxyService(options?: ServiceOptions): ServiceResult;
+export declare function disableMetaProxyService(options?: ServiceOptions): ServiceResult;
+//# sourceMappingURL=meta-proxy-service.d.ts.map

package/dist/meta-proxy-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-proxy-service.d.ts","sourceRoot":"","sources":["../src/meta-proxy-service.ts"],"names":[],"mappings":"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"}