@w5s/dev 2.1.7 → 2.2.0

package/dist/directory.d.ts

@@ -0,0 +1,39 @@
+export interface DirectoryOptions {
+    /**
+     * Directory path
+     */
+    readonly path: string;
+    /**
+     * Directory target state
+     */
+    readonly state: 'present' | 'absent';
+}
+/**
+ * Ensure directory is present/absent
+ *
+ * @example
+ * ```ts
+ * await directory({
+ *   path: 'foo/bar',
+ *   state: 'present',
+ * })
+ * ```
+ *
+ * @param options
+ */
+export declare function directory(options: DirectoryOptions): Promise<void>;
+/**
+ * Ensure directory is present/absent
+ *
+ * @example
+ * ```ts
+ * await directorySync({
+ *   path: 'foo/bar',
+ *   state: 'present',
+ * })
+ * ```
+ *
+ * @param options
+ */
+export declare function directorySync(options: DirectoryOptions): void;
+//# sourceMappingURL=directory.d.ts.map

package/dist/directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../src/directory.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;CACtC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUxE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAU7D"}

package/dist/directory.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.directorySync = exports.directory = void 0;
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+async function exists(path) {
+    try {
+        await (0, promises_1.access)(path, promises_1.constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Ensure directory is present/absent
+ *
+ * @example
+ * ```ts
+ * await directory({
+ *   path: 'foo/bar',
+ *   state: 'present',
+ * })
+ * ```
+ *
+ * @param options
+ */
+async function directory(options) {
+    const { path, state } = options;
+    const isPresent = await exists(path);
+    if (state === 'present') {
+        if (!isPresent) {
+            await (0, promises_1.mkdir)(path, { recursive: true });
+        }
+    }
+    else if (isPresent) {
+        await (0, promises_1.rmdir)(path, { recursive: true });
+    }
+}
+exports.directory = directory;
+/**
+ * Ensure directory is present/absent
+ *
+ * @example
+ * ```ts
+ * await directorySync({
+ *   path: 'foo/bar',
+ *   state: 'present',
+ * })
+ * ```
+ *
+ * @param options
+ */
+function directorySync(options) {
+    const { path, state } = options;
+    const isPresent = (0, node_fs_1.existsSync)(path);
+    if (state === 'present') {
+        if (!isPresent) {
+            (0, node_fs_1.mkdirSync)(path, { recursive: true });
+        }
+    }
+    else if (isPresent) {
+        (0, node_fs_1.rmdirSync)(path, { recursive: true });
+    }
+}
+exports.directorySync = directorySync;
+//# sourceMappingURL=directory.js.map

package/dist/directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.js","sourceRoot":"","sources":["../src/directory.ts"],"names":[],"mappings":";;;AAAA,qCAA2D;AAC3D,+CAAmE;AAEnE,KAAK,UAAU,MAAM,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,MAAM,IAAA,iBAAM,EAAC,IAAI,EAAE,oBAAS,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAaD;;;;;;;;;;;;GAYG;AACI,KAAK,UAAU,SAAS,CAAC,OAAyB;IACvD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAChC,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAA,gBAAK,EAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;SAAM,IAAI,SAAS,EAAE,CAAC;QACrB,MAAM,IAAA,gBAAK,EAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAVD,8BAUC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,aAAa,CAAC,OAAyB;IACrD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAChC,MAAM,SAAS,GAAG,IAAA,oBAAU,EAAC,IAAI,CAAC,CAAC;IACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,IAAA,mBAAS,EAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;SAAM,IAAI,SAAS,EAAE,CAAC;QACrB,IAAA,mBAAS,EAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAVD,sCAUC"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from './directory.js';
 export * from './eslint.js';
 export * from './block.js';
 export * from './file.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./directory.js"), exports);
 __exportStar(require("./eslint.js"), exports);
 __exportStar(require("./block.js"), exports);
 __exportStar(require("./file.js"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,6CAA2B;AAC3B,4CAA0B;AAC1B,4CAA0B;AAC1B,+CAA6B;AAC7B,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,8CAA4B;AAC5B,6CAA2B;AAC3B,4CAA0B;AAC1B,4CAA0B;AAC1B,+CAA6B;AAC7B,qDAAmC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@w5s/dev",
-  "version": "2.1.7",
+  "version": "2.2.0",
   "description": "Shared development constants and functions",
   "keywords": [
     "config",
@@ -44,5 +44,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "ce05c95bf037f723aa29ae71d2f6aa4098ed2711"
+  "gitHead": "83fd8a5230a660921d5c785190b58f38a1d3cdb0"
 }

package/src/directory.ts

@@ -0,0 +1,72 @@
+import { existsSync, mkdirSync, rmdirSync } from 'node:fs';
+import { access, constants, mkdir, rmdir } from 'node:fs/promises';
+
+async function exists(path: string) {
+  try {
+    await access(path, constants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export interface DirectoryOptions {
+  /**
+   * Directory path
+   */
+  readonly path: string;
+  /**
+   * Directory target state
+   */
+  readonly state: 'present' | 'absent';
+}
+
+/**
+ * Ensure directory is present/absent
+ *
+ * @example
+ * ```ts
+ * await directory({
+ *   path: 'foo/bar',
+ *   state: 'present',
+ * })
+ * ```
+ *
+ * @param options
+ */
+export async function directory(options: DirectoryOptions): Promise<void> {
+  const { path, state } = options;
+  const isPresent = await exists(path);
+  if (state === 'present') {
+    if (!isPresent) {
+      await mkdir(path, { recursive: true });
+    }
+  } else if (isPresent) {
+    await rmdir(path, { recursive: true });
+  }
+}
+
+/**
+ * Ensure directory is present/absent
+ *
+ * @example
+ * ```ts
+ * await directorySync({
+ *   path: 'foo/bar',
+ *   state: 'present',
+ * })
+ * ```
+ *
+ * @param options
+ */
+export function directorySync(options: DirectoryOptions): void {
+  const { path, state } = options;
+  const isPresent = existsSync(path);
+  if (state === 'present') {
+    if (!isPresent) {
+      mkdirSync(path, { recursive: true });
+    }
+  } else if (isPresent) {
+    rmdirSync(path, { recursive: true });
+  }
+}

package/src/index.ts

@@ -1,3 +1,4 @@
+export * from './directory.js';
 export * from './eslint.js';
 export * from './block.js';
 export * from './file.js';