@lumy-pack/syncpoint 0.0.1

package/dist/schemas/ajv.d.ts

@@ -0,0 +1,3 @@
+import Ajv from "ajv";
+declare const ajv: Ajv;
+export { ajv };

package/dist/schemas/config.schema.d.ts

@@ -0,0 +1,4 @@
+export declare function validateConfig(data: unknown): {
+    valid: boolean;
+    errors?: string[];
+};

package/dist/schemas/metadata.schema.d.ts

@@ -0,0 +1,4 @@
+export declare function validateMetadata(data: unknown): {
+    valid: boolean;
+    errors?: string[];
+};

package/dist/schemas/template.schema.d.ts

@@ -0,0 +1,4 @@
+export declare function validateTemplate(data: unknown): {
+    valid: boolean;
+    errors?: string[];
+};

package/dist/utils/assets.d.ts

@@ -0,0 +1,2 @@
+export declare function getAssetPath(filename: string): string;
+export declare function readAsset(filename: string): string;

package/dist/utils/format.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Format bytes into a human-readable string.
+ * e.g. 4096 -> "4.0 KB"
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Format a Date to "YYYY-MM-DD HH:mm".
+ */
+export declare function formatDate(date: Date): string;
+/**
+ * Format a Date to "YYYY-MM-DD_HHmmss" for filenames.
+ */
+export declare function formatDatetime(date: Date): string;
+/**
+ * Format a relative time string.
+ * e.g. "2 hours ago", "37 days ago"
+ */
+export declare function formatRelativeTime(date: Date): string;
+/**
+ * Generate a backup filename from the pattern.
+ * Supported placeholders: {hostname}, {date}, {time}, {datetime}, {tag}
+ */
+export declare function generateFilename(pattern: string, options?: {
+    tag?: string;
+    date?: Date;
+    hostname?: string;
+}): string;

package/dist/utils/logger.d.ts

@@ -0,0 +1,6 @@
+export declare const logger: {
+    info(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+};

package/dist/utils/paths.d.ts

@@ -0,0 +1,22 @@
+export declare function getHomeDir(): string;
+/**
+ * Expand ~ to the user's home directory.
+ */
+export declare function expandTilde(p: string): string;
+/**
+ * Contract the home directory prefix back to ~.
+ */
+export declare function contractTilde(p: string): string;
+/**
+ * Resolve a target path (expand tilde, resolve relative).
+ */
+export declare function resolveTargetPath(p: string): string;
+/**
+ * Ensure a directory exists, creating it recursively if needed.
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;
+/**
+ * Check if a file exists.
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+export declare function isInsideDir(filePath: string, dir: string): boolean;

package/dist/utils/sudo.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Check whether sudo credentials are already cached.
+ * Returns true if `sudo -n true` succeeds (no password needed).
+ */
+export declare function isSudoCached(): boolean;
+/**
+ * Ensure sudo credentials are available before Ink captures stdin.
+ *
+ * 1. If already cached, returns silently.
+ * 2. Otherwise, warns the user and runs `sudo -v` which prompts
+ *    for their password using the real terminal.
+ *
+ * Must be called BEFORE Ink render().
+ * Calls process.exit(1) if authentication fails.
+ */
+export declare function ensureSudo(templateName: string): void;

package/dist/utils/system.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Get the machine hostname.
+ */
+export declare function getHostname(): string;
+/**
+ * Get system information for metadata.
+ */
+export declare function getSystemInfo(): {
+    platform: string;
+    release: string;
+    arch: string;
+};
+/**
+ * Sanitize hostname for use in filenames.
+ * Replace dots and spaces with dashes, remove non-alphanumeric except dashes.
+ */
+export declare function formatHostname(name?: string): string;

package/dist/utils/types.d.ts

@@ -0,0 +1,136 @@
+export interface SyncpointConfig {
+    backup: {
+        targets: string[];
+        exclude: string[];
+        filename: string;
+        destination?: string;
+    };
+    scripts: {
+        includeInBackup: boolean;
+    };
+}
+export interface BackupMetadata {
+    version: string;
+    toolVersion: string;
+    createdAt: string;
+    hostname: string;
+    system: {
+        platform: string;
+        release: string;
+        arch: string;
+    };
+    config: {
+        filename: string;
+        destination?: string;
+    };
+    files: FileEntry[];
+    summary: {
+        fileCount: number;
+        totalSize: number;
+    };
+}
+export interface FileEntry {
+    path: string;
+    absolutePath: string;
+    size: number;
+    hash: string;
+    type?: string;
+}
+export interface TemplateConfig {
+    name: string;
+    description: string;
+    backup?: string;
+    sudo?: boolean;
+    steps: TemplateStep[];
+}
+export interface TemplateStep {
+    name: string;
+    description?: string;
+    command: string;
+    skip_if?: string;
+    continue_on_error?: boolean;
+}
+export interface BackupResult {
+    archivePath: string;
+    metadata: BackupMetadata;
+}
+export interface RestoreResult {
+    restoredFiles: string[];
+    skippedFiles: string[];
+    safetyBackupPath?: string;
+}
+export interface RestorePlan {
+    metadata: BackupMetadata;
+    actions: RestoreAction[];
+}
+export interface RestoreAction {
+    path: string;
+    action: "overwrite" | "skip" | "create";
+    currentSize?: number;
+    backupSize?: number;
+    reason: string;
+}
+export interface ProvisionResult {
+    steps: StepResult[];
+    totalDuration: number;
+}
+export interface StepResult {
+    name: string;
+    status: "success" | "skipped" | "failed" | "running" | "pending";
+    duration?: number;
+    error?: string;
+    output?: string;
+}
+export interface BackupOptions {
+    dryRun?: boolean;
+    tag?: string;
+}
+export interface RestoreOptions {
+    dryRun?: boolean;
+}
+export interface ProvisionOptions {
+    dryRun?: boolean;
+    skipRestore?: boolean;
+}
+export interface BackupInfo {
+    filename: string;
+    path: string;
+    size: number;
+    createdAt: Date;
+    hostname?: string;
+    fileCount?: number;
+}
+export interface StatusInfo {
+    backups: {
+        count: number;
+        totalSize: number;
+    };
+    templates: {
+        count: number;
+        totalSize: number;
+    };
+    scripts: {
+        count: number;
+        totalSize: number;
+    };
+    logs: {
+        count: number;
+        totalSize: number;
+    };
+    lastBackup?: Date;
+    oldestBackup?: Date;
+}
+export interface CleanupPolicy {
+    type: "keep-recent" | "older-than" | "select";
+    count?: number;
+    days?: number;
+    indices?: number[];
+}
+export interface InitOptions {
+    template: string;
+    directory?: string;
+    dryRun: boolean;
+}
+export interface CliOptions {
+    verbose?: boolean;
+}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@lumy-pack/syncpoint",
+  "version": "0.0.1",
+  "description": "CLI tool for project synchronization and scaffolding",
+  "keywords": [
+    "cli",
+    "sync",
+    "syncpoint",
+    "scaffolding"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vincent-kk/lumy-pack.git",
+    "directory": "packages/syncpoint"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Vincent K. Kelvin",
+    "email": "lunox273@gmail.com"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "source": "./src/index.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "bin": "./dist/cli.mjs",
+  "files": [
+    "dist",
+    "assets",
+    "README.md"
+  ],
+  "dependencies": {
+    "ajv": "^8.0.0",
+    "ajv-formats": "^3.0.0",
+    "commander": "^12.1.0",
+    "fast-glob": "^3.0.0",
+    "ink": "^5.0.0",
+    "ink-select-input": "^6.0.0",
+    "ink-spinner": "^5.0.0",
+    "picocolors": "^1.1.1",
+    "react": "^18.0.0",
+    "tar": "^7.0.0",
+    "yaml": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@types/react": "^18.0.0",
+    "@types/tar": "^6.1.13",
+    "@vitest/coverage-v8": "^3.2.4",
+    "ink-testing-library": "^4.0.0"
+  },
+  "scripts": {
+    "build": "tsup && pnpm build:types",
+    "build:types": "tsc -p ./tsconfig.declarations.json",
+    "build:publish:npm": "pnpm build && pnpm publish:npm",
+    "dev": "tsx src/cli.ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "lint": "eslint \"src/**/*.ts\"",
+    "publish:npm": "pnpm publish --access public --no-git-checks",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts src/__tests__/e2e/",
+    "test:docker": "vitest run --config vitest.e2e.config.ts src/__tests__/docker/",
+    "test:all": "vitest run && pnpm test:e2e && pnpm test:docker",
+    "version:major": "pnpm version major",
+    "version:minor": "pnpm version minor",
+    "version:patch": "pnpm version patch"
+  }
+}