@lumy-pack/syncpoint 0.0.10 → 0.0.12

package/dist/commands/Link.d.ts

@@ -0,0 +1,9 @@
+import { Command } from 'commander';
+import React from 'react';
+interface LinkViewProps {
+    refPath?: string;
+    yes: boolean;
+}
+export declare const LinkView: React.FC<LinkViewProps>;
+export declare function registerLinkCommand(program: Command): void;
+export {};

package/dist/commands/Unlink.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerUnlinkCommand(program: Command): void;

package/dist/core/link.d.ts

@@ -0,0 +1,19 @@
+import type { LinkOptions, LinkResult, UnlinkOptions, UnlinkResult } from '../utils/types.js';
+/**
+ * Move ~/.syncpoint to {destination}/.syncpoint/ and create a symlink.
+ * If ~/.syncpoint is already a symlink, unlink and restore before re-linking.
+ */
+export declare function linkSyncpoint(destination: string, _options?: LinkOptions): Promise<LinkResult>;
+/**
+ * Create a symlink ~/.syncpoint → <refPath>/.syncpoint.
+ * For backwards compatibility, if refPath already points to a .syncpoint directory,
+ * it is used as-is.
+ * If ~/.syncpoint already exists, the caller must handle confirmation before invoking this.
+ */
+export declare function linkSyncpointByRef(refPath: string): Promise<LinkResult>;
+/**
+ * Remove the symlink at ~/.syncpoint and restore its contents by copying
+ * from the symlink target back to ~/.syncpoint.
+ * With options.clean=true, also removes the destination copy.
+ */
+export declare function unlinkSyncpoint(options?: UnlinkOptions): Promise<UnlinkResult>;

package/dist/errors.d.ts

@@ -7,6 +7,8 @@ export declare const SyncpointErrorCode: {
     readonly PROVISION_FAILED: "PROVISION_FAILED";
     readonly MISSING_ARGUMENT: "MISSING_ARGUMENT";
     readonly INVALID_ARGUMENT: "INVALID_ARGUMENT";
+    readonly LINK_FAILED: "LINK_FAILED";
+    readonly UNLINK_FAILED: "UNLINK_FAILED";
     readonly UNKNOWN: "UNKNOWN";
 };
 export type SyncpointErrorCode = (typeof SyncpointErrorCode)[keyof typeof SyncpointErrorCode];

package/dist/index.cjs

@@ -51,6 +51,7 @@ var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
 // src/core/config.ts
 var import_promises2 = require("fs/promises");
 var import_node_path4 = require("path");
+var import_common_utils2 = require("@winglet/common-utils");
 var import_yaml = __toESM(require("yaml"), 1);
 
 // src/constants.ts
@@ -126,6 +127,9 @@ function getSubDir(sub) {
   return (0, import_node_path2.join)(getAppDir(), sub);
 }
 
+// src/schemas/config.schema.ts
+var import_common_utils = require("@winglet/common-utils");
+
 // assets/schemas/config.schema.json
 var config_schema_default = {
   $schema: "http://json-schema.org/draft-07/schema#",
@@ -299,9 +303,10 @@ var validate2 = ajv.compile(config_schema_default);
 function validateConfig(data) {
   const valid = validate2(data);
   if (valid) return { valid: true };
-  const errors = validate2.errors?.map(
+  const errors = validate2.errors ? (0, import_common_utils.map)(
+    validate2.errors,
     (e) => `${e.instancePath || "/"} ${e.message ?? "unknown error"}`
-  );
+  ) : void 0;
   return { valid: false, errors };
 }
 
@@ -327,7 +332,7 @@ function readAsset(filename) {
 // src/core/config.ts
 function stripDangerousKeys(obj) {
   if (obj === null || typeof obj !== "object") return obj;
-  if (Array.isArray(obj)) return obj.map(stripDangerousKeys);
+  if ((0, import_common_utils2.isArray)(obj)) return (0, import_common_utils2.map)(obj, stripDangerousKeys);
   const cleaned = {};
   for (const [key, value] of Object.entries(obj)) {
     if (["__proto__", "constructor", "prototype"].includes(key)) continue;
@@ -401,6 +406,7 @@ async function initDefaultConfig() {
 // src/core/backup.ts
 var import_promises6 = require("fs/promises");
 var import_node_path7 = require("path");
+var import_common_utils5 = require("@winglet/common-utils");
 var import_fast_glob = __toESM(require("fast-glob"), 1);
 
 // src/utils/system.ts
@@ -510,6 +516,10 @@ var logger = {
 // src/core/metadata.ts
 var import_node_crypto = require("crypto");
 var import_promises4 = require("fs/promises");
+var import_common_utils4 = require("@winglet/common-utils");
+
+// src/schemas/metadata.schema.ts
+var import_common_utils3 = require("@winglet/common-utils");
 
 // assets/schemas/metadata.schema.json
 var metadata_schema_default = {
@@ -639,14 +649,15 @@ var validate3 = ajv.compile(metadata_schema_default);
 function validateMetadata(data) {
   const valid = validate3(data);
   if (valid) return { valid: true };
-  const errors = validate3.errors?.map(
+  const errors = validate3.errors ? (0, import_common_utils3.map)(
+    validate3.errors,
     (e) => `${e.instancePath || "/"} ${e.message ?? "unknown error"}`
-  );
+  ) : void 0;
   return { valid: false, errors };
 }
 
 // src/version.ts
-var VERSION = "0.0.10";
+var VERSION = "0.0.12";
 
 // src/core/metadata.ts
 var METADATA_VERSION = "1.0.0";
@@ -670,7 +681,7 @@ function createMetadata(files, config) {
   };
 }
 function parseMetadata(data) {
-  const str = typeof data === "string" ? data : data.toString("utf-8");
+  const str = (0, import_common_utils4.isString)(data) ? data : data.toString("utf-8");
   const parsed = JSON.parse(str);
   const result = validateMetadata(parsed);
   if (!result.valid) {
@@ -824,7 +835,8 @@ async function scanTargets(config) {
             "**/Library/**",
             "**/.cache/**",
             "**/node_modules/**",
-            ...config.backup.exclude.filter(
+            ...(0, import_common_utils5.filter)(
+              config.backup.exclude,
               (p) => detectPatternType(p) === "glob"
             )
           ]
@@ -995,6 +1007,7 @@ async function createBackup(config, options = {}) {
 // src/core/restore.ts
 var import_promises7 = require("fs/promises");
 var import_node_path8 = require("path");
+var import_common_utils6 = require("@winglet/common-utils");
 async function getBackupList(config) {
   const backupDir = config?.backup.destination ? resolveTargetPath(config.backup.destination) : getSubDir(BACKUPS_DIR);
   const exists = await fileExists(backupDir);
@@ -1099,15 +1112,26 @@ async function restoreBackup(archivePath, options = {}) {
   const plan = await getRestorePlan(archivePath);
   const restoredFiles = [];
   const skippedFiles = [];
-  const overwritePaths = plan.actions.filter((a) => a.action === "overwrite").map((a) => a.path);
+  const overwritePaths = [];
+  (0, import_common_utils6.forEach)(plan.actions, (a) => {
+    if (a.action === "overwrite") overwritePaths.push(a.path);
+  });
   let safetyBackupPath;
   if (overwritePaths.length > 0 && !options.dryRun) {
     safetyBackupPath = await createSafetyBackup(overwritePaths);
   }
   if (options.dryRun) {
+    const restoredFiles2 = [];
+    (0, import_common_utils6.forEach)(plan.actions, (a) => {
+      if (a.action !== "skip") restoredFiles2.push(a.path);
+    });
+    const skippedFiles2 = [];
+    (0, import_common_utils6.forEach)(plan.actions, (a) => {
+      if (a.action === "skip") skippedFiles2.push(a.path);
+    });
     return {
-      restoredFiles: plan.actions.filter((a) => a.action !== "skip").map((a) => a.path),
-      skippedFiles: plan.actions.filter((a) => a.action === "skip").map((a) => a.path),
+      restoredFiles: restoredFiles2,
+      skippedFiles: skippedFiles2,
       safetyBackupPath
     };
   }
@@ -1154,8 +1178,12 @@ async function restoreBackup(archivePath, options = {}) {
 var import_node_child_process = require("child_process");
 var import_promises8 = require("fs/promises");
 var import_node_path9 = require("path");
+var import_common_utils8 = require("@winglet/common-utils");
 var import_yaml2 = __toESM(require("yaml"), 1);
 
+// src/schemas/template.schema.ts
+var import_common_utils7 = require("@winglet/common-utils");
+
 // assets/schemas/template.schema.json
 var template_schema_default = {
   $schema: "http://json-schema.org/draft-07/schema#",
@@ -1224,9 +1252,10 @@ var validate4 = ajv.compile(template_schema_default);
 function validateTemplate(data) {
   const valid = validate4(data);
   if (valid) return { valid: true };
-  const errors = validate4.errors?.map(
+  const errors = validate4.errors ? (0, import_common_utils7.map)(
+    validate4.errors,
     (e) => `${e.instancePath || "/"} ${e.message ?? "unknown error"}`
-  );
+  ) : void 0;
   return { valid: false, errors };
 }
 
@@ -1338,7 +1367,7 @@ async function executeStep(step) {
   }
   try {
     const { stdout, stderr } = await execAsync(step.command);
-    const output = [stdout, stderr].filter(Boolean).join("\n").trim();
+    const output = (0, import_common_utils8.filter)([stdout, stderr], import_common_utils8.isTruthy).join("\n").trim();
     return {
       name: step.name,
       status: "success",
@@ -1349,7 +1378,7 @@ async function executeStep(step) {
     const error = err instanceof Error ? err : new Error(String(err));
     const stdout = err?.stdout ?? "";
     const stderr = err?.stderr ?? "";
-    const errorOutput = [stdout, stderr, error.message].filter(Boolean).join("\n").trim();
+    const errorOutput = (0, import_common_utils8.filter)([stdout, stderr, error.message], import_common_utils8.isTruthy).join("\n").trim();
     return {
       name: step.name,
       status: "failed",

package/dist/index.mjs

@@ -1,6 +1,7 @@
 // src/core/config.ts
 import { readFile, writeFile } from "fs/promises";
 import { join as join4 } from "path";
+import { isArray, map as map2 } from "@winglet/common-utils";
 import YAML from "yaml";
 
 // src/constants.ts
@@ -76,6 +77,9 @@ function getSubDir(sub) {
   return join2(getAppDir(), sub);
 }
 
+// src/schemas/config.schema.ts
+import { map } from "@winglet/common-utils";
+
 // assets/schemas/config.schema.json
 var config_schema_default = {
   $schema: "http://json-schema.org/draft-07/schema#",
@@ -249,9 +253,10 @@ var validate2 = ajv.compile(config_schema_default);
 function validateConfig(data) {
   const valid = validate2(data);
   if (valid) return { valid: true };
-  const errors = validate2.errors?.map(
+  const errors = validate2.errors ? map(
+    validate2.errors,
     (e) => `${e.instancePath || "/"} ${e.message ?? "unknown error"}`
-  );
+  ) : void 0;
   return { valid: false, errors };
 }
 
@@ -277,7 +282,7 @@ function readAsset(filename) {
 // src/core/config.ts
 function stripDangerousKeys(obj) {
   if (obj === null || typeof obj !== "object") return obj;
-  if (Array.isArray(obj)) return obj.map(stripDangerousKeys);
+  if (isArray(obj)) return map2(obj, stripDangerousKeys);
   const cleaned = {};
   for (const [key, value] of Object.entries(obj)) {
     if (["__proto__", "constructor", "prototype"].includes(key)) continue;
@@ -351,6 +356,7 @@ async function initDefaultConfig() {
 // src/core/backup.ts
 import { readdir } from "fs/promises";
 import { basename, join as join7 } from "path";
+import { filter } from "@winglet/common-utils";
 import fg from "fast-glob";
 
 // src/utils/system.ts
@@ -460,6 +466,10 @@ var logger = {
 // src/core/metadata.ts
 import { createHash } from "crypto";
 import { lstat, readFile as readFile2, readlink } from "fs/promises";
+import { isString } from "@winglet/common-utils";
+
+// src/schemas/metadata.schema.ts
+import { map as map3 } from "@winglet/common-utils";
 
 // assets/schemas/metadata.schema.json
 var metadata_schema_default = {
@@ -589,14 +599,15 @@ var validate3 = ajv.compile(metadata_schema_default);
 function validateMetadata(data) {
   const valid = validate3(data);
   if (valid) return { valid: true };
-  const errors = validate3.errors?.map(
+  const errors = validate3.errors ? map3(
+    validate3.errors,
     (e) => `${e.instancePath || "/"} ${e.message ?? "unknown error"}`
-  );
+  ) : void 0;
   return { valid: false, errors };
 }
 
 // src/version.ts
-var VERSION = "0.0.10";
+var VERSION = "0.0.12";
 
 // src/core/metadata.ts
 var METADATA_VERSION = "1.0.0";
@@ -620,7 +631,7 @@ function createMetadata(files, config) {
   };
 }
 function parseMetadata(data) {
-  const str = typeof data === "string" ? data : data.toString("utf-8");
+  const str = isString(data) ? data : data.toString("utf-8");
   const parsed = JSON.parse(str);
   const result = validateMetadata(parsed);
   if (!result.valid) {
@@ -774,7 +785,8 @@ async function scanTargets(config) {
             "**/Library/**",
             "**/.cache/**",
             "**/node_modules/**",
-            ...config.backup.exclude.filter(
+            ...filter(
+              config.backup.exclude,
               (p) => detectPatternType(p) === "glob"
             )
           ]
@@ -945,6 +957,7 @@ async function createBackup(config, options = {}) {
 // src/core/restore.ts
 import { copyFile, lstat as lstat2, readdir as readdir2, stat as stat2 } from "fs/promises";
 import { dirname as dirname2, join as join8 } from "path";
+import { forEach } from "@winglet/common-utils";
 async function getBackupList(config) {
   const backupDir = config?.backup.destination ? resolveTargetPath(config.backup.destination) : getSubDir(BACKUPS_DIR);
   const exists = await fileExists(backupDir);
@@ -1049,15 +1062,26 @@ async function restoreBackup(archivePath, options = {}) {
   const plan = await getRestorePlan(archivePath);
   const restoredFiles = [];
   const skippedFiles = [];
-  const overwritePaths = plan.actions.filter((a) => a.action === "overwrite").map((a) => a.path);
+  const overwritePaths = [];
+  forEach(plan.actions, (a) => {
+    if (a.action === "overwrite") overwritePaths.push(a.path);
+  });
   let safetyBackupPath;
   if (overwritePaths.length > 0 && !options.dryRun) {
     safetyBackupPath = await createSafetyBackup(overwritePaths);
   }
   if (options.dryRun) {
+    const restoredFiles2 = [];
+    forEach(plan.actions, (a) => {
+      if (a.action !== "skip") restoredFiles2.push(a.path);
+    });
+    const skippedFiles2 = [];
+    forEach(plan.actions, (a) => {
+      if (a.action === "skip") skippedFiles2.push(a.path);
+    });
     return {
-      restoredFiles: plan.actions.filter((a) => a.action !== "skip").map((a) => a.path),
-      skippedFiles: plan.actions.filter((a) => a.action === "skip").map((a) => a.path),
+      restoredFiles: restoredFiles2,
+      skippedFiles: skippedFiles2,
       safetyBackupPath
     };
   }
@@ -1104,8 +1128,12 @@ async function restoreBackup(archivePath, options = {}) {
 import { exec } from "child_process";
 import { readFile as readFile4, readdir as readdir3 } from "fs/promises";
 import { join as join9 } from "path";
+import { filter as filter2, isTruthy } from "@winglet/common-utils";
 import YAML2 from "yaml";
 
+// src/schemas/template.schema.ts
+import { map as map4 } from "@winglet/common-utils";
+
 // assets/schemas/template.schema.json
 var template_schema_default = {
   $schema: "http://json-schema.org/draft-07/schema#",
@@ -1174,9 +1202,10 @@ var validate4 = ajv.compile(template_schema_default);
 function validateTemplate(data) {
   const valid = validate4(data);
   if (valid) return { valid: true };
-  const errors = validate4.errors?.map(
+  const errors = validate4.errors ? map4(
+    validate4.errors,
     (e) => `${e.instancePath || "/"} ${e.message ?? "unknown error"}`
-  );
+  ) : void 0;
   return { valid: false, errors };
 }
 
@@ -1288,7 +1317,7 @@ async function executeStep(step) {
   }
   try {
     const { stdout, stderr } = await execAsync(step.command);
-    const output = [stdout, stderr].filter(Boolean).join("\n").trim();
+    const output = filter2([stdout, stderr], isTruthy).join("\n").trim();
     return {
       name: step.name,
       status: "success",
@@ -1299,7 +1328,7 @@ async function executeStep(step) {
     const error = err instanceof Error ? err : new Error(String(err));
     const stdout = err?.stdout ?? "";
     const stderr = err?.stderr ?? "";
-    const errorOutput = [stdout, stderr, error.message].filter(Boolean).join("\n").trim();
+    const errorOutput = filter2([stdout, stderr, error.message], isTruthy).join("\n").trim();
     return {
       name: step.name,
       status: "failed",

package/dist/utils/types.d.ts

@@ -144,3 +144,18 @@ export interface InitOptions {
 export interface CliOptions {
     verbose?: boolean;
 }
+export interface LinkOptions {
+}
+export interface UnlinkOptions {
+    clean?: boolean;
+}
+export interface LinkResult {
+    appDir: string;
+    targetDir: string;
+    wasAlreadyLinked: boolean;
+}
+export interface UnlinkResult {
+    appDir: string;
+    targetDir: string;
+    cleaned: boolean;
+}

package/dist/version.d.ts

@@ -2,4 +2,4 @@
  * Current package version from package.json
  * Automatically synchronized during build process
  */
-export declare const VERSION = "0.0.10";
+export declare const VERSION = "0.0.12";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumy-pack/syncpoint",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "description": "CLI tool for project synchronization and scaffolding",
   "keywords": [
     "cli",
@@ -56,6 +56,8 @@
     "version:patch": "yarn version patch"
   },
   "dependencies": {
+    "@winglet/common-utils": "^0.11.2",
+    "@winglet/react-utils": "^0.11.2",
     "ajv": "^8.0.0",
     "ajv-formats": "^3.0.0",
     "commander": "^12.1.0",