ds-01 1.0.13 → 1.1.1

package/dist/utils/secureKeyStore.d.ts

@@ -1,8 +1,3 @@
-/**
- * ---------------------------------------------------------
- * PUBLIC API
- * ---------------------------------------------------------
- */
 export declare function createDeviceKey(): Promise<void>;
 export declare function getDevicePublicKey(): Promise<string>;
 export declare function signWithDeviceKey(data: Uint8Array): Promise<Uint8Array>;

package/dist/utils/secureKeyStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"secureKeyStore.d.ts","sourceRoot":"","sources":["../../src/utils/secureKeyStore.ts"],"names":[],"mappings":"AA2WA;;;;GAIG;AAEH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CASrD;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAQ1D;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,UAAU,CAAC,CAQrB;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CASrD"}
+{"version":3,"file":"secureKeyStore.d.ts","sourceRoot":"","sources":["../../src/utils/secureKeyStore.ts"],"names":[],"mappings":"AAoUA,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CASrD;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAQ1D;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAQ7E;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CASrD"}

package/dist/utils/secureKeyStore.js

@@ -7,7 +7,11 @@ import { fileURLToPath } from "node:url";
 const execFileAsync = promisify(execFile);
 const KEY_NAME = "DS01-CLI-Device-Key";
 const __filename = fileURLToPath(import.meta.url);
+// import.meta.ur -- current module ka location URL form mein deta hai
 const __dirname = path.dirname(__filename);
+//C:\Projects\DS01\cli\dist\utils
+// __filename = where is THIS FILE?
+// __dirname  = which folder contains THIS FILE?
 function getMacHelperPath() {
     return path.resolve(__dirname, "../native/macos-key-helper.swift");
 }
@@ -17,11 +21,7 @@ function ensureSupportedOS() {
         throw new Error("DS01 secure device keys currently support Windows and macOS.");
     }
 }
-/**
- * ---------------------------------------------------------
- * WINDOWS
- * ---------------------------------------------------------
- */
+// for windows
 async function createWindowsDeviceKey() {
     const script = `
 $ErrorActionPreference = "Stop"
@@ -84,15 +84,6 @@ Write-Output "CREATED"
         throw new Error("Failed to create Windows DS01 device key.");
     }
 }
-/**
- * Find exactly one valid DS01 certificate.
- *
- * We intentionally do not use Select-Object -First 1.
- *
- * 0 certificates  -> error
- * 1 certificate   -> use it
- * 2+ certificates -> error
- */
 function getWindowsCertificateLookup() {
     return `
 $certificates = @(Get-ChildItem Cert:\\CurrentUser\\My |
@@ -113,6 +104,10 @@ if ($certificates.Count -gt 1) {
 $cert = [System.Security.Cryptography.X509Certificates.X509Certificate2]$certificates[0]
 `;
 }
+// cert - just a variable holding the certificate object
+// X509Certificate2 is a Windows/.NET certificate object 
+// that gives the code a standard way to work with the certificate and its associated key information
+// X509Certificate2 a class/type, rather than simply a "format"
 async function getWindowsPublicKey() {
     const script = `
 $ErrorActionPreference = "Stop"
@@ -218,11 +213,7 @@ Write-Output "DELETED"
         windowsHide: true,
     });
 }
-/**
- * ---------------------------------------------------------
- * MACOS
- * ---------------------------------------------------------
- */
+// for Mac
 async function runMacHelper(operation, data) {
     const helper = getMacHelperPath();
     const args = [helper, operation];
@@ -236,10 +227,8 @@ async function runMacHelper(operation, data) {
 }
 async function createMacDeviceKey() {
     const result = await runMacHelper("create");
-    if (result !== "CREATED" &&
-        result !== "EXISTS") {
-        throw new Error(result ||
-            "Failed to create macOS Secure Enclave device key.");
+    if (result !== "CREATED" && result !== "EXISTS") {
+        throw new Error(result || "Failed to create macOS Secure Enclave device key.");
     }
 }
 async function getMacPublicKey() {
@@ -259,11 +248,7 @@ async function signMacDeviceKey(data) {
 async function deleteMacDeviceKey() {
     await runMacHelper("delete");
 }
-/**
- * ---------------------------------------------------------
- * PUBLIC API
- * ---------------------------------------------------------
- */
+// Public APIs which we use this for creating keys and certificate
 export async function createDeviceKey() {
     ensureSupportedOS();
     if (os.platform() === "win32") {

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "ds-01",
-  "version": "1.0.13",
+  "version": "1.1.01",
   "description": "Make your site best with DS01",
   "type": "module",
   "bin": {
     "ds01": "dist/index.js"
   },
   "scripts": {
-    "build": "tsc && node scripts/copy-native.js"
+    "build": "tsc && node scripts/copy-native.js && node scripts/build-macos-helper.js"
   },
   "publishConfig": {
     "access": "public"

package/scripts/build-macos-helper.js

@@ -0,0 +1,52 @@
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+
+if (process.platform !== "darwin") {
+  console.log("Skipping macOS native helper build.");
+  process.exit(0);
+}
+
+const root = process.cwd();
+
+const source = path.join(
+  root,
+  "src",
+  "native",
+  "macos-key-helper.swift",
+);
+
+const nativeDir = path.join(
+  root,
+  "dist",
+  "native",
+);
+
+const output = path.join(
+  nativeDir,
+  "macos-key-helper",
+);
+
+if (!fs.existsSync(source)) {
+  throw new Error(`Swift helper not found: ${source}`);
+}
+
+fs.mkdirSync(nativeDir, {
+  recursive: true,
+});
+
+console.log("Building macOS native helper...");
+
+execFileSync(
+  "swiftc",
+  [
+    source,
+    "-o",
+    output,
+  ],
+  {
+    stdio: "inherit",
+  },
+);
+
+console.log("macOS native helper built successfully.");

package/src/commands/add.ts

@@ -12,12 +12,9 @@ import machineIdPkg from "node-machine-id";
 
 const { machineIdSync } = machineIdPkg;
 
-const API_BASE_URL =
-  process.env.DS01_API_URL || "https://ds-01.vercel.app";
+const API_BASE_URL = process.env.DS01_API_URL || "https://ds-01.vercel.app";
 
-// ---------------------------------------------------------
-// Helper: Verify Tailwind exists
-// ---------------------------------------------------------
+// function for tailwind dependency check
 
 function checkTailwindInstallation() {
   const targetDir = process.cwd();
@@ -33,9 +30,7 @@ function checkTailwindInstallation() {
     process.exit(1);
   }
 
-  const pkgJson = JSON.parse(
-    fs.readFileSync(pkgJsonPath, "utf-8"),
-  );
+  const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, "utf-8"));
 
   const allDeps = {
     ...pkgJson.dependencies,
@@ -44,47 +39,33 @@ function checkTailwindInstallation() {
 
   if (!allDeps["tailwindcss"]) {
     cancel(
-      pc.red(
-        "Tailwind CSS is missing from your project dependencies.\n",
-      ) +
+      pc.red("Tailwind CSS is missing from your project dependencies.\n") +
         pc.gray(
           "DS01 components rely strictly on Tailwind CSS for styling.\n\n",
         ) +
         pc.white(
           "Kindly install it and configure your project, then retry:\n",
         ) +
-        pc.cyan(
-          "  npm install tailwindcss @tailwindcss/postcss postcss\n\n",
-        ) +
+        pc.cyan("  npm install tailwindcss @tailwindcss/postcss postcss\n\n") +
         pc.gray("Official Setup Guide: ") +
-        pc.underline(
-          "https://tailwindcss.com/docs/installation",
-        ),
+        pc.underline("https://tailwindcss.com/docs/installation"),
     );
 
     process.exit(1);
   }
 }
 
-// ---------------------------------------------------------
-// Helper: Find dependencies that are actually missing
-// ---------------------------------------------------------
+// function to Find dependencies that are actually missing
 
-function getMissingDependencies(
-  dependencies: string[],
-): string[] {
-  const packageJsonPath = path.join(
-    process.cwd(),
-    "package.json",
-  );
+function getMissingDependencies(dependencies: string[]): string[] {
+  const packageJsonPath = path.join(process.cwd(), "package.json");
 
+  // I cannot check what is installed, so treat all required dependencies as missing
   if (!fs.existsSync(packageJsonPath)) {
     return dependencies;
   }
 
-  const packageJson = JSON.parse(
-    fs.readFileSync(packageJsonPath, "utf-8"),
-  );
+  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
 
   const installedDependencies = {
     ...(packageJson.dependencies || {}),
@@ -96,17 +77,10 @@ function getMissingDependencies(
   );
 }
 
-// ---------------------------------------------------------
-// ADD COMMAND
-// ---------------------------------------------------------
-
 export const add = new Command()
   .name("add")
   .description("Add a component from DS01 to your project")
-  .argument(
-    "<component>",
-    "The name of the component (e.g., premium-section)",
-  )
+  .argument("<component>", "The name of the component (e.g., premium-section)")
   .action(async (componentName: string) => {
     console.log();
 
@@ -116,62 +90,39 @@ export const add = new Command()
       )}`,
     );
 
-    // -----------------------------------------------------
-    // 1. Validate project
-    // -----------------------------------------------------
+    // validatin
 
     checkTailwindInstallation();
 
     const cwd = process.cwd();
 
-    const configPath = path.join(
-      cwd,
-      "ds01.config.json",
-    );
+    const configPath = path.join(cwd, "ds01.config.json");
 
     if (!fs.existsSync(configPath)) {
-      cancel(
-        pc.red(
-          "ds01.config.json not found. Run 'npx ds-01 init' first.",
-        ),
-      );
+      cancel(pc.red("ds01.config.json not found. Run 'npx ds-01 init' first."));
 
       process.exit(1);
     }
 
-    const config = JSON.parse(
-      fs.readFileSync(configPath, "utf-8"),
-    );
+    const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
 
-    // -----------------------------------------------------
-    // 2. Authentication
-    // -----------------------------------------------------
+    // for auth
 
     const token = getToken();
     const machineId = machineIdSync();
 
     if (!token || !machineId) {
-      cancel(
-        pc.red(
-          "You are not authenticated. Run 'npx ds-01 login' first.",
-        ),
-      );
+      cancel(pc.red("You are not authenticated. Run 'npx ds-01 login' first."));
 
       process.exit(1);
     }
 
     const s = spinner();
 
-    s.start(
-      `Fetching ${pc.cyan(
-        `<${componentName} />`,
-      )} from registry...`,
-    );
+    s.start(`Fetching ${pc.cyan(`<${componentName} />`)} from registry...`);
 
     try {
-      // --------------------------------------------------
-      // 3. Create request-specific signed message
-      // --------------------------------------------------
+      //  Creating request-specific signed message
 
       const timestamp = Date.now().toString();
 
@@ -182,70 +133,43 @@ export const add = new Command()
         machineId,
       ].join("\n");
 
-      // --------------------------------------------------
-      // 4. Sign request with secure device private key
-      // --------------------------------------------------
+      // Sign request with secure device private key
 
       const signature = await signWithDeviceKey(
         new TextEncoder().encode(message),
       );
 
-      const signatureBase64 =
-        Buffer.from(signature).toString("base64");
+      const signatureBase64 = Buffer.from(signature).toString("base64");
 
-      // --------------------------------------------------
-      // 5. Request component from registry
-      // --------------------------------------------------
+      //  Request component from registry
 
       const response = await fetch(
         `${API_BASE_URL}/api/registry/${componentName}`,
         {
           method: "GET",
-
           headers: {
             Authorization: `Bearer ${token}`,
-
             "X-Machine-ID": machineId,
-
             "X-DS01-Timestamp": timestamp,
-
             "X-DS01-Signature": signatureBase64,
           },
         },
       );
 
-      // --------------------------------------------------
-      // 6. Handle registry errors
-      // --------------------------------------------------
+      // Handle registry errors
 
       if (!response.ok) {
-        const errorData =
-          await response.json().catch(() => null);
-
-        s.stop(
-          pc.red("Component fetch failed."),
-        );
-
-        cancel(
-          errorData?.error ||
-            `Server returned HTTP ${response.status}`,
-        );
-
+        const errorData = await response.json().catch(() => null);
+        s.stop(pc.red("Component fetch failed."));
+        cancel(errorData?.error || `Server returned HTTP ${response.status}`);
         process.exit(1);
       }
 
-      const componentData =
-        await response.json();
+      const componentData = await response.json();
 
-      // --------------------------------------------------
-      // 7. Create component directory
-      // --------------------------------------------------
+      // Create component directory
 
-      const targetDir = path.join(
-        cwd,
-        config.componentsPath,
-        componentName,
-      );
+      const targetDir = path.join(cwd, config.componentsPath, componentName);
 
       if (!fs.existsSync(targetDir)) {
         fs.mkdirSync(targetDir, {
@@ -253,49 +177,29 @@ export const add = new Command()
         });
       }
 
-      // --------------------------------------------------
-      // 8. Extract bundled file names
-      // --------------------------------------------------
-
-      const bundledFileNames =
-        componentData.files.map(
-          (file: any) =>
-            file.name.replace(
-              /\.[^/.]+$/,
-              "",
-            ),
-        );
-
-      // --------------------------------------------------
-      // 9. Write component files
-      // --------------------------------------------------
+      
+      //  Extract bundled file names
+      const bundledFileNames = componentData.files.map((file: any) =>
+        file.name.replace(/\.[^/.]+$/, ""),
+      );
 
+    
+      //  Write component files
       for (const file of componentData.files) {
-        const filePath = path.join(
-          targetDir,
-          file.name,
-        );
+        const filePath = path.join(targetDir, file.name);
 
         let content = file.content;
 
-        bundledFileNames.forEach(
-          (fileName: string) => {
-            const regex = new RegExp(
-              `from\\s+["']\\.[^"']*?\\/${fileName}["']`,
-              "g",
-            );
-
-            content = content.replace(
-              regex,
-              `from "./${fileName}"`,
-            );
-          },
-        );
+        bundledFileNames.forEach((fileName: string) => {
+          const regex = new RegExp(
+            `from\\s+["']\\.[^"']*?\\/${fileName}["']`,
+            "g",
+          );
 
-        fs.writeFileSync(
-          filePath,
-          content,
-        );
+          content = content.replace(regex, `from "./${fileName}"`);
+        });
+
+        fs.writeFileSync(filePath, content);
       }
 
       s.stop(
@@ -306,85 +210,46 @@ export const add = new Command()
         ),
       );
 
-      // --------------------------------------------------
-      // 10. Install ONLY missing dependencies
-      // --------------------------------------------------
+    
+      //  Install ONLY missing dependencies
+      const registryDependencies = Array.isArray(componentData.dependencies)
+        ? componentData.dependencies
+        : [];
 
-      const registryDependencies =
-        Array.isArray(componentData.dependencies)
-          ? componentData.dependencies
-          : [];
-
-      const missingDependencies =
-        getMissingDependencies(
-          registryDependencies,
-        );
+      const missingDependencies = getMissingDependencies(registryDependencies);
 
       if (missingDependencies.length > 0) {
-        const depsToInstall =
-          missingDependencies.join(" ");
+        const depsToInstall = missingDependencies.join(" ");
 
         s.start(
-          `Installing missing dependencies: ${pc.cyan(
-            depsToInstall,
-          )}...`,
+          `Installing missing dependencies: ${pc.cyan(depsToInstall)}...`,
         );
 
         try {
-          execSync(
-            `npm install ${depsToInstall}`,
-            {
-              stdio: "ignore",
-            },
-          );
+          execSync(`npm install ${depsToInstall}`, {
+            stdio: "ignore",
+          });
 
           s.stop(
             pc.green(
-              `Dependencies installed successfully: ${pc.gray(
-                depsToInstall,
-              )}`,
+              `Dependencies installed successfully: ${pc.gray(depsToInstall)}`,
             ),
           );
         } catch {
-          s.stop(
-            pc.red(
-              "Failed to auto-install dependencies.",
-            ),
-          );
+          s.stop(pc.red("Failed to auto-install dependencies."));
 
           note(
-            `Please run: ${pc.cyan(
-              `npm install ${depsToInstall}`,
-            )} manually.`,
+            `Please run: ${pc.cyan(`npm install ${depsToInstall}`)} manually.`,
             "Manual Action Required",
           );
         }
       }
 
-      // --------------------------------------------------
-      // 11. No dependencies needed
-      // --------------------------------------------------
-
-      // We intentionally don't show a spinner here.
-      //
-      // Example:
-      //
-      // DS01 requires ["motion"]
-      // package.json already contains "motion"
-      //
-      // → Nothing happens.
-      // → No npm install.
-      // → No unnecessary package changes.
-
-      // --------------------------------------------------
-      // 12. Success
-      // --------------------------------------------------
+   
 
       const mainFile =
         bundledFileNames.find(
-          (name: string) =>
-            name.toLowerCase() ===
-            componentName.toLowerCase(),
+          (name: string) => name.toLowerCase() === componentName.toLowerCase(),
         ) || bundledFileNames[0];
 
       outro(
@@ -397,19 +262,10 @@ export const add = new Command()
           ),
       );
     } catch (error: any) {
-      s.stop(
-        pc.red(
-          "An error occurred during injection.",
-        ),
-      );
+      s.stop(pc.red("An error occurred during injection."));
 
-      cancel(
-        pc.gray(
-          error?.message ||
-            "Unknown CLI Error",
-        ),
-      );
+      cancel(pc.gray(error?.message || "Unknown CLI Error"));
 
       process.exit(1);
     }
-  });
+  });