@rbbtsn0w/idocs 0.1.0-beta.2 → 1.2.0

package/README.md

@@ -6,13 +6,16 @@ This package distributes the `idocs` Swift CLI through npm.
 
 ```bash
 npm install -g @rbbtsn0w/idocs
+idocs --help
 ```
 
-By default, `postinstall` downloads `idocs-darwin-arm64.tar.gz` from:
+For normal users, this is the complete install flow. `postinstall` downloads the matching `idocs-darwin-arm64.tar.gz` asset from GitHub Releases automatically.
+
+If install fails, rerun the install and inspect the npm output. A failed download should be treated as a release packaging problem, not as an expected manual setup step.
 
-`https://github.com/RbBtSn0w/Apple-iDocs/releases/download/v{version}`
+## Advanced: Alternate Release Mirror
 
-Override the release URL if needed:
+`IDOCS_RELEASE_BASE_URL` is only for internal mirrors or custom release hosting. It is not required for the normal npm install path.
 
 ```bash
 export IDOCS_RELEASE_BASE_URL="https://github.com/<owner>/<repo>/releases/download/v{version}"
@@ -32,6 +35,6 @@ npm --prefix npm link
 idocs --help
 ```
 
-## Strict install mode
+## Non-strict install mode
 
-Set `IDOCS_NPM_STRICT_INSTALL=1` to fail install when binary download fails.
+Set `IDOCS_NPM_STRICT_INSTALL=0` only if you intentionally want to keep the wrapper installed without a binary for local debugging flows.

package/bin/idocs.js

@@ -11,10 +11,9 @@ const frameworksPath = resolve(here, "../dist/Frameworks");
 
 if (!existsSync(binaryPath)) {
   console.error("iDocs binary not found at npm/dist/idocs.");
-  console.error("Try one of the following:");
-  console.error("  1) npm --prefix npm run fetch-binary");
-  console.error("  2) export IDOCS_RELEASE_BASE_URL='https://github.com/<owner>/<repo>/releases/download/v{version}'");
-  console.error("  3) npm --prefix npm run link-local");
+  console.error("Reinstall @rbbtsn0w/idocs so postinstall can download the matching release asset.");
+  console.error("If reinstall still fails, review the npm install output for the underlying packaging error.");
+  console.error("For local repository development only, run npm --prefix npm run link-local.");
   process.exit(1);
 }
 

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@rbbtsn0w/idocs",
-  "version": "0.1.0-beta.2",
+  "version": "1.2.0",
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
   "description": "npm distribution wrapper for the iDocs Swift CLI",
   "repository": {
@@ -16,7 +17,7 @@
   "license": "MIT",
   "type": "module",
   "bin": {
-    "idocs": "./bin/idocs.js"
+    "idocs": "bin/idocs.js"
   },
   "files": [
     "bin",
@@ -37,5 +38,14 @@
   },
   "engines": {
     "node": ">=20"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^11.0.6",
+    "@semantic-release/npm": "^12.0.2",
+    "@semantic-release/release-notes-generator": "^14.1.0",
+    "semantic-release": "^25.0.3"
   }
 }

package/scripts/link-local.mjs

@@ -11,7 +11,7 @@ const targetPath = resolve(distDir, "idocs");
 const frameworksTargetDir = resolve(distDir, "Frameworks");
 
 function info(msg) {
-  console.log(`[idocs-cli] ${msg}`);
+  console.log(`[@rbbtsn0w/idocs] ${msg}`);
 }
 
 function findFromDerivedData() {
@@ -42,9 +42,9 @@ function resolveLocalBinary() {
 
 const sourcePath = resolveLocalBinary();
 if (!sourcePath) {
-  console.error("[idocs-cli] Could not locate a local iDocs binary.");
-  console.error("[idocs-cli] Build first: ./scripts/tuist-silent.sh build iDocs");
-  console.error("[idocs-cli] Or set IDOCS_LOCAL_BINARY=/absolute/path/to/idocs");
+  console.error("[@rbbtsn0w/idocs] Could not locate a local iDocs binary.");
+  console.error("[@rbbtsn0w/idocs] Build first: ./scripts/tuist-silent.sh build iDocs");
+  console.error("[@rbbtsn0w/idocs] Or set IDOCS_LOCAL_BINARY=/absolute/path/to/idocs");
   process.exit(1);
 }
 

package/scripts/postinstall.mjs

@@ -9,8 +9,9 @@ const distDir = resolve(npmRoot, "dist");
 const binaryPath = resolve(distDir, "idocs");
 const frameworksPath = resolve(distDir, "Frameworks");
 const tmpArchive = resolve(distDir, "idocs-darwin-arm64.tar.gz");
+const extractedBundleDir = resolve(distDir, "idocs-darwin-arm64");
 const force = process.argv.includes("--force");
-const strictInstall = process.env.IDOCS_NPM_STRICT_INSTALL === "1";
+const strictInstall = process.env.IDOCS_NPM_STRICT_INSTALL !== "0";
 
 function log(msg) {
   console.log(`[@rbbtsn0w/idocs] ${msg}`);
@@ -24,6 +25,7 @@ function fail(msg, err) {
   if (strictInstall) {
     process.exit(1);
   }
+  console.error("[@rbbtsn0w/idocs] Continuing because IDOCS_NPM_STRICT_INSTALL=0.");
 }
 
 function getVersion() {
@@ -112,7 +114,12 @@ async function main() {
     unlinkSync(tmpArchive);
     log("Binary installed successfully.");
   } catch (error) {
-    fail("Binary download failed. Install will continue in non-strict mode.", error);
+    rmSync(tmpArchive, { force: true });
+    rmSync(extractedBundleDir, { recursive: true, force: true });
+    fail(
+      "Binary download failed. npm/dist/idocs was not refreshed from the release asset.",
+      error
+    );
   }
 }