@kici-dev/shared 0.0.0 → 0.1.0

package/dist/zx.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Initialize zx for cross-platform execution.
+ * Sets the quote function required by zx 8+ on all platforms.
+ * On Windows, also configures pwsh as shell.
+ * Call this at the start of any script/binary entry point using zx.
+ */
+export declare function initZx(): void;
+//# sourceMappingURL=zx.d.ts.map

package/dist/zx.js

@@ -0,0 +1,78 @@
+import "./chunk-gOLHoazu.js";
+import { execSync } from "node:child_process";
+import { $, quote, quotePowerShell, usePwsh } from "zx";
+//#region src/zx.ts
+const PWSH_INSTALL_DOCS = "https://learn.microsoft.com/en-us/powershell/scripting/install/install-powershell-on-windows";
+/**
+* Initialize zx for cross-platform execution.
+* Sets the quote function required by zx 8+ on all platforms.
+* On Windows, also configures pwsh as shell.
+* Call this at the start of any script/binary entry point using zx.
+*/
+function initZx() {
+	if (process.platform === "win32") {
+		try {
+			usePwsh();
+		} catch {
+			ensurePwshWindows();
+			usePwsh();
+		}
+		$.quote = quotePowerShell;
+	} else $.quote = quote;
+}
+/**
+* Ensure PowerShell Core (pwsh) is installed on Windows.
+* Attempts automatic installation via winget using the built-in powershell.exe.
+* If winget is unavailable, prints installation instructions and exits.
+*/
+function ensurePwshWindows() {
+	console.error("PowerShell Core (pwsh) is required but not found in PATH.\nKiCI uses pwsh for cross-platform command execution.\n");
+	let hasWinget = false;
+	try {
+		execSync("powershell.exe -NoProfile -Command \"Get-Command winget -ErrorAction Stop\"", {
+			stdio: "ignore",
+			timeout: 1e4
+		});
+		hasWinget = true;
+	} catch {}
+	if (!hasWinget) {
+		console.error(`Automatic installation is not possible (winget not found).
+Please install PowerShell Core manually:
+  ${PWSH_INSTALL_DOCS}\n`);
+		process.exit(1);
+	}
+	console.error("Attempting to install PowerShell Core via winget...\n");
+	try {
+		execSync("powershell.exe -NoProfile -Command \"winget install --id Microsoft.PowerShell --accept-source-agreements --accept-package-agreements -e --silent\"", {
+			stdio: "inherit",
+			timeout: 3e5
+		});
+	} catch {
+		console.error(`
+Automatic installation failed.
+Please install PowerShell Core manually:
+  ${PWSH_INSTALL_DOCS}\n`);
+		process.exit(1);
+	}
+	try {
+		const pwshPath = execSync("powershell.exe -NoProfile -Command \"(Get-Command pwsh -ErrorAction Stop).Source\"", {
+			encoding: "utf-8",
+			timeout: 1e4
+		}).trim();
+		if (pwshPath) {
+			const pwshDir = pwshPath.replace(/\\pwsh\.exe$/i, "");
+			process.env.PATH = `${pwshDir};${process.env.PATH}`;
+		}
+	} catch {
+		console.error(`
+PowerShell Core was installed but cannot be found in PATH.
+Please restart your terminal or add pwsh to PATH manually.
+See: ${PWSH_INSTALL_DOCS}\n`);
+		process.exit(1);
+	}
+	console.error("PowerShell Core installed successfully.\n");
+}
+//#endregion
+export { initZx };
+
+//# sourceMappingURL=zx.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kici-dev/shared",
-  "version": "0.0.0",
+  "version": "0.1.0",
   "description": "Shared utilities for the KiCI CI/CD stack — logging, zx setup, crypto, telemetry, health and metrics routes. No business logic.",
   "keywords": [
     "kici",
@@ -9,7 +9,8 @@
     "ci-cd",
     "typescript",
     "workflows",
-    "devops"
+    "devops",
+    "utilities"
   ],
   "homepage": "https://kici.dev",
   "author": {
@@ -17,9 +18,72 @@
     "email": "hello@kici.dev"
   },
   "license": "Apache-2.0",
-  "main": "index.js",
+  "engines": {
+    "node": ">=24"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "sbom.spdx.json"
+  ],
   "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./env": {
+      "import": "./dist/env/index.js",
+      "types": "./dist/env/index.d.ts"
+    },
+    "./ts-loader-hook": {
+      "import": "./dist/ts-loader-hook.js",
+      "types": "./dist/ts-loader-hook.d.ts"
+    },
+    "./idempotency": {
+      "import": "./dist/idempotency.js",
+      "types": "./dist/idempotency.d.ts"
+    },
+    "./idempotency-files": {
+      "import": "./dist/idempotency-files.js",
+      "types": "./dist/idempotency-files.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-ts.mjs && tsc --emitDeclarationOnly",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npx tsx ../../hack/generate-sbom.ts --package packages/shared --name @kici-dev/shared"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.1038.0",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.217.0",
+    "@opentelemetry/exporter-prometheus": "^0.217.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.217.0",
+    "@opentelemetry/instrumentation-runtime-node": "^0.28.0",
+    "@opentelemetry/resources": "^2.7.0",
+    "@opentelemetry/sdk-node": "^0.217.0",
+    "@opentelemetry/semantic-conventions": "^1.40.0",
+    "diff": "^7.0.0",
+    "hono": "^4.12.18",
+    "kysely": "^0.29.0",
+    "oxc-transform": "0.128.0",
+    "pg": "^8.20.0",
+    "picocolors": "^1.1.1",
+    "winston": "^3.19.0",
+    "winston-daily-rotate-file": "^5.0.0",
+    "zod": "^4.3.6",
+    "zx": "^8.8.5"
+  },
+  "devDependencies": {
+    "@opentelemetry/sdk-trace-base": "^2.7.0",
+    "@types/diff": "^7.0.0"
   }
 }