ensure-dir-tiny 1.0.0

package/.github/workflows/npmpublish.yml

@@ -0,0 +1,48 @@
+# This workflow will run tests using node and then publish a package to npm using Trusted Publishing (OIDC)
+# For more information see: https://docs.npmjs.com/using-private-packages-in-a-ci-cd-workflow
+
+name: ensure-dir-tiny NPM Package
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    # Skip Dependabot PRs for CI/CD
+    if: ${{ github.actor != 'dependabot[bot]' }}
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+
+      - run: npm install
+      - run: npm test
+
+  publish-npm:
+    needs: build
+    runs-on: ubuntu-latest
+
+    # Skip Dependabot PRs
+    if: ${{ github.actor != 'dependabot[bot]' }}
+
+    # Required for OIDC Trusted Publishing
+    permissions:
+      contents: read
+      id-token: write # 👈 REQUIRED for Trusted Publishing
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+          registry-url: https://registry.npmjs.org/
+
+      - run: npm install
+      - run: npm publish

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,90 @@
+# ensure-dir
+
+<p align="center"><a href="https://nodei.co/npm/ensure-dir/"><img src="https://nodei.co/npm/ensure-dir.png"></a></a></p>
+<p align="center">
+  <img src="https://img.shields.io/badge/License-MIT-yellow.svg">
+</p>
+
+* 📁 Lightweight package that ensures that the directory at the given path exists. Creates it recursively if it doesn't. Prevents `"File Not Found"` errors when saving files.
+* ♻️ Works seamlessly with `CommonJS`, `ESM` and `TypeScript`
+
+# 📦 Install via [NPM](https://www.npmjs.com/package/contains-emoji)
+
+```bash
+$ npm i ensure-dir
+```
+
+# 💻 Usage
+
+- See examples below
+
+## CommonJS
+```javascript
+const path = require('path');
+const fs = require('fs');
+const ensureDir = require('ensure-dir');
+
+const testDir = path.join(__dirname, 'demo/a/b/c');
+
+console.log('Creating directory:', testDir);
+ensureDir(testDir);
+
+if (fs.existsSync(testDir)) {
+    console.log('✅ Directory exists — module works');
+} else {
+    console.log('❌ Directory not created');
+}
+
+// --| Run again to test idempotency
+ensureDir(testDir);
+console.log('✅ Called twice without crashing');
+
+```
+
+## ESM
+```javascript
+import path from 'path';
+import fs from 'fs';
+import ensureDir from 'ensure-dir';
+import { fileURLToPath } from 'url';
+
+// __dirname replacement in ESM
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const testDir = path.join(__dirname, 'demo/a/b/c');
+
+console.log('Creating directory:', testDir);
+ensureDir(testDir);
+
+if (fs.existsSync(testDir)) {
+    console.log('✅ Directory exists — module works');
+} else {
+    console.log('❌ Directory not created');
+}
+
+// --| Run again to test idempotency
+ensureDir(testDir);
+console.log('✅ Called twice without crashing');
+```
+
+## TypeScript
+```javascript
+import path from 'path';
+import fs from 'fs';
+import ensureDir from 'ensure-dir';
+
+const testDir: string = path.join(__dirname, 'demo/a/b/c');
+console.log('Creating directory:', testDir);
+
+ensureDir(testDir);
+
+if (fs.existsSync(testDir)) {
+    console.log('✅ Directory exists — module works');
+} else {
+    console.log('❌ Directory not created');
+}
+
+ensureDir(testDir);
+console.log('✅ Called twice without crashing');
+```

package/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Ensures that the directory at the given path exists. Creates it recursively if it doesn't.
+ * Prevents "File Not Found" errors when saving files.
+ *
+ * @param {string} path - The path of the directory to ensure.
+ * @returns {void}
+ *
+ * @example
+ * ensureDirectory("./data/logs");
+ */
+declare function ensureDirectory(path: string): void;
+
+export  = ensureDirectory;

package/index.js

@@ -0,0 +1,26 @@
+/**
+ *  ensure-dir-tiny - 📁 Ensures that the directory at the given path exists. Creates it recursively if it doesn't. Prevents "File Not Found" errors when saving files.
+ *  @version: v1.0.0
+ *  @link: https://github.com/tutyamxx/ensure-dir-tiny
+ *  @license: MIT
+ **/
+
+const fs = require('fs');
+
+/**
+ * Ensures that the directory at the given path exists. Creates it recursively if it doesn't.
+ * Prevents "File Not Found" errors when saving files.
+ *
+ * @param {string} path - The path of the directory to ensure.
+ * @returns {void}
+ *
+ * @example
+ * ensureDir("./data/logs");
+ */
+const ensureDir = path => fs.existsSync(path) || fs.mkdirSync(path, { recursive: true });
+
+// --| CommonJS export
+module.exports = ensureDir;
+
+// --| ESM default export for `import` statements
+module.exports.default = ensureDir;

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "ensure-dir-tiny",
+  "version": "1.0.0",
+  "description": "📁 Checks if a folder exists; if not, it creates it. This prevents \"File Not Found\" errors when saving data.",
+  "main": "index.js",
+  "module": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    "require": "./index.js",
+    "import": "./index.js",
+    "types": "./index.d.ts"
+  },
+  "scripts": {
+    "test": "jest --verbose"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tutyamxx/ensure-dir-tiny.git"
+  },
+  "keywords": [
+    "ensure-dir-tiny",
+    "ensure-dir",
+    "ensure-directory",
+    "directory-exists",
+    "dir-exists",
+    "fs",
+    "mkdir",
+    "ensure"
+  ],
+  "author": "tuty",
+  "license": "ISC",
+  "type": "commonjs",
+  "bugs": {
+    "url": "https://github.com/tutyamxx/ensure-dir-tiny/issues"
+  },
+  "homepage": "https://github.com/tutyamxx/ensure-dir-tiny#readme",
+  "devDependencies": {
+    "jest": "^30.2.0"
+  }
+}

package/test/index.test.js

@@ -0,0 +1,88 @@
+const fs = require('fs');
+const path = require('path');
+const ensureDir = require('../index.js');
+
+describe('ensureDir', () => {
+    const baseDir = path.join(__dirname, 'tmp_test');
+
+    const cleanup = () => {
+        if (fs.existsSync(baseDir)) {
+            fs.rmSync(baseDir, { recursive: true, force: true });
+        }
+    };
+
+    beforeEach(cleanup);
+    afterAll(cleanup);
+
+    test('Creates a new directory if it does not exist', () => {
+        const dir = path.join(baseDir, 'newDir');
+
+        ensureDir(dir);
+        expect(fs.existsSync(dir)).toBe(true);
+    });
+
+    test('Does not throw if directory already exists', () => {
+        const dir = path.join(baseDir, 'existingDir');
+
+        fs.mkdirSync(dir, { recursive: true });
+        expect(() => ensureDir(dir)).not.toThrow();
+    });
+
+    test('Creates nested directories recursively', () => {
+        const nestedDir = path.join(baseDir, 'a/b/c/d');
+
+        ensureDir(nestedDir);
+        expect(fs.existsSync(nestedDir)).toBe(true);
+    });
+
+    test('Is safe to call multiple times (idempotent)', () => {
+        const dir = path.join(baseDir, 'repeat');
+
+        ensureDir(dir);
+        ensureDir(dir);
+        ensureDir(dir);
+
+        expect(fs.existsSync(dir)).toBe(true);
+    });
+
+    test('Works with trailing slash', () => {
+        const dir = path.join(baseDir, 'slash/') ;
+
+        ensureDir(dir);
+        expect(fs.existsSync(dir)).toBe(true);
+    });
+
+    test('Works with absolute paths', () => {
+        const abs = path.resolve(baseDir, 'absoluteDir');
+
+        ensureDir(abs);
+        expect(fs.existsSync(abs)).toBe(true);
+    });
+
+    test('Works with relative paths', () => {
+        const rel = './tmp_test/relativeDir';
+
+        ensureDir(rel);
+        expect(fs.existsSync(rel)).toBe(true);
+    });
+
+    test('Handles directory names with spaces', () => {
+        const dir = path.join(baseDir, 'dir with spaces');
+
+        ensureDir(dir);
+        expect(fs.existsSync(dir)).toBe(true);
+    });
+
+    test('Does nothing if path points to an existing file', () => {
+        const filePath = path.join(baseDir, 'file.txt');
+        ensureDir(baseDir);
+        fs.writeFileSync(filePath, 'x');
+
+        expect(() => ensureDir(filePath)).not.toThrow();
+        expect(fs.statSync(filePath).isFile()).toBe(true);
+    });
+
+    test('Throws on empty path', () => {
+        expect(() => ensureDir('')).toThrow();
+    });
+});