@ebowwa/seedinstallation 0.2.4 → 0.4.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Ebowwa Labs
+Copyright (c) 2026 Ebowwa Labs
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,170 +1,62 @@
-# @cheapspaces/seedInstallation
+# @ebowwa/seedinstallation
 
-Composable server installation utilities for edge deployment automation. This package provides a set of utilities for provisioning and managing servers, both locally and via SSH.
+Composable server installation utilities for edge deployment automation.
 
 ## Features
 
-- **Sudo command execution** - Run commands with sudo privileges locally or via SSH
-- **Package management** - Install system packages (apt, dnf, apk)
-- **File operations** - Write to privileged paths with proper permissions
-- **Systemd service management** - Create, enable, and manage systemd services
-- **Runtime installation** - Install and configure runtimes like Bun
-- **Device-code authentication** - Handle OAuth device flows for Doppler, GitHub, Tailscale
-- **Bootstrap tracking** - Track provisioning phases and status
-- **Git cloning** - Composable git clone with shallow/sparse support
+- **systemd** - Create/manage systemd services with security hardening
+- **sudo** - Run commands as root via SSH (remote execution)
+- **bootstrap** - Bootstrap/configure new servers
+- **device-auth** - Device login flows (GitHub, Doppler, Tailscale)
+- **clone** - Clone git repositories
+- **runtime** - Detect runtime environment (VPS vs local)
 
 ## Installation
 
 ```bash
-npm install @cheapspaces/seedInstallation
+npm install @ebowwa/seedinstallation
 ```
 
 ## Usage
 
-### Local Command Execution
-
-```typescript
-import { sudo, pkgInstall } from '@cheapspaces/seedInstallation';
-
-// Run a command with sudo
-const result = await sudo(['apt-get', 'update'], {
-  context: { type: 'local' }
-});
-
-// Install packages
-await pkgInstall(['git', 'curl', 'vim'], {
-  context: { type: 'local' },
-  pm: 'apt'
-});
-```
-
-### Remote SSH Execution
-
-```typescript
-import { sudo, writeFile } from '@cheapspaces/seedInstallation';
-
-// Run commands over SSH
-const result = await sudo(['systemctl', 'status', 'nginx'], {
-  context: {
-    type: 'ssh',
-    host: '192.168.1.100',
-    user: 'root',
-    keyPath: '/path/to/key'
-  }
-});
-
-// Write files to remote server
-await writeFile('/etc/nginx/nginx.conf', configContent, {
-  context: { type: 'ssh', host: '192.168.1.100' },
-  mode: '644'
-});
-```
-
 ### Systemd Service Management
 
 ```typescript
-import {
-  createServiceUnit,
-  enableAndStartService,
-  getServiceStatus
-} from '@cheapspaces/seedInstallation';
-
-// Create a systemd service
-await createServiceUnit('myapp', {
-  description: 'My Application',
-  workingDirectory: '/opt/myapp',
-  execStart: '/usr/bin/node /opt/myapp/index.js',
-  restart: 'always',
-  environment: {
-    NODE_ENV: 'production'
-  }
-}, { context: { type: 'local' } });
-
-// Enable and start the service
-await enableAndStartService('myapp', {
-  context: { type: 'local' }
-});
-
-// Check service status
-const status = await getServiceStatus('myapp', {
-  context: { type: 'local' }
+import { createServiceUnit, SECURITY_PRESETS } from "@ebowwa/seedinstallation/systemd";
+
+await createServiceUnit("my-api", {
+  description: "My API Service",
+  workingDirectory: "/opt/my-api",
+  execStart: "/usr/bin/node index.js",
+  ...SECURITY_PRESETS.network,
+  context: { host: "5.161.83.44", user: "root" }
 });
 ```
 
-### Device-Code Authentication
+### Environment Detection
 
 ```typescript
-import { deviceAuth, dopplerConfig } from '@cheapspaces/seedInstallation';
+import { hasSystemd, safeSystemd } from "@ebowwa/seedinstallation/systemd";
 
-// Authenticate with Doppler via device code
-const result = await deviceAuth(dopplerConfig, {
-  context: { type: 'local' },
-  onPoll: (attempt, result) => {
-    console.log(`Polling... attempt ${attempt}`);
-  }
-});
-
-if (result.success) {
-  console.log(`Visit: ${result.url}`);
-  console.log(`Code: ${result.code}`);
-}
-```
-
-### Git Cloning
-
-```typescript
-import { clone } from '@cheapspaces/seedInstallation/clone';
-
-// Basic clone
-const { path, commit } = await clone({
-  repo: 'https://github.com/user/repo.git'
-});
-
-// Shallow clone of specific branch
-await clone({
-  repo: 'https://github.com/user/repo.git',
-  ref: 'main',
-  depth: 1,
-  dest: 'my-repo'
-});
-
-// Sparse checkout (only specific paths)
-await clone({
-  repo: 'https://github.com/user/repo.git',
-  sparse: ['src/lib', 'src/types'],
-  depth: 1
-});
-```
-
-## API
-
-### Modules
-
-- `.` - Main exports (all utilities)
-- `./clone` - Git clone utilities
-- `./sudo` - Sudo command execution
-- `./runtime` - Runtime installation and PATH management
-- `./systemd` - Systemd service management
-- `./device-auth` - Device-code authentication flows
-- `./bootstrap` - Bootstrap status tracking
-
-### Types
-
-```typescript
-interface ExecContext {
-  type: 'local' | 'ssh';
-  host?: string;
-  user?: string;
-  keyPath?: string;
-  port?: number;
+// Check if systemd is available
+const check = await hasSystemd();
+if (!check.available) {
+  console.log("No systemd - running in container/codespaces");
 }
 
-interface ExecResult {
-  stdout: string;
-  stderr: string;
-  exitCode: number;
-  ok: boolean;
-}
+// Safe wrapper with fallback
+await safeSystemd(
+  async () => {
+    await createServiceUnit("my-service", { ... });
+  },
+  {
+    requireSystemd: false,
+    onNoSystemd: async (check) => {
+      console.log(`No systemd: ${check.message}`);
+      // Fallback: run process directly
+    },
+  }
+);
 ```
 
 ## License

package/dist/bootstrap.d.ts

@@ -3,7 +3,7 @@
  * Manages phase markers, status files, and polling for completion.
  * Works with both local and SSH contexts via ExecContext from sudo.ts.
  */
-import type { SudoOptions, ExecResult } from "./sudo.js";
+import type { SudoOptions, ExecResult } from "./sudo";
 export interface BootstrapPhase {
     /** Phase name (e.g. "bun", "seed", "doppler") */
     name: string;
@@ -30,9 +30,7 @@ export interface BootstrapStatus {
     /** Raw file content */
     raw: string;
 }
-export interface BootstrapPollOptions {
-    /** Execution context for running commands */
-    context: SudoOptions["context"];
+export interface BootstrapPollOptions extends SudoOptions {
     /** Maximum poll attempts (default: 30) */
     maxAttempts?: number;
     /** Interval between polls in ms (default: 2000) */
@@ -101,14 +99,15 @@ export declare function removeMarker(markerPath: string, opts: SudoOptions): Pro
  *
  * Returns the final status (complete or failed/timeout).
  */
-export declare function waitForBootstrap(statusFile: string, opts: BootstrapPollOptions): Promise<{
+export declare function waitForBootstrap(statusFile: string, opts?: BootstrapPollOptions): Promise<{
     completed: boolean;
     status: BootstrapStatus;
 }>;
 /**
  * Poll until a marker file exists.
  */
-export declare function waitForMarker(markerPath: string, opts: BootstrapPollOptions): Promise<{
+export declare function waitForMarker(markerPath: string, opts?: BootstrapPollOptions): Promise<{
     exists: boolean;
     timedOut: boolean;
 }>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

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