ctx-core 5.2.3 → 5.3.0

package/all/crypto/index.js

@@ -1,4 +1,5 @@
 /// <reference lib="dom" />
+import { process_release_name } from '../process_release_name/index.js'
 /**
  * @type {Crypto}
  * @see {@link https://stackoverflow.com/a/70981544/142571}
@@ -7,6 +8,5 @@ export const crypto = globalThis.crypto
 export async function crypto_() {
 	return (
 		crypto
-		|| import('node:crypto').then($=>
-			$.webcrypto))
+		|| process_release_name && import('node:crypto').then(mod=>mod.webcrypto))
 }

package/all/file_exists/index.d.ts

@@ -0,0 +1,9 @@
+export declare function file_exists_(path:string):Promise<boolean|undefined>
+export {
+	file_exists_ as path__exists_
+}
+export declare function file_exists__waitfor(
+	path:string,
+	timeout?:number,
+	period?:number
+):Promise<void>

package/all/file_exists/index.js

@@ -0,0 +1,27 @@
+import { process_release_name } from '../process_release_name/index.js'
+import { waitfor } from '../waitfor/index.js'
+/**
+ * @param {string}path
+ * @returns {Promise<boolean>}
+ * @private
+ */
+export async function file_exists_(path) {
+	return (
+		(process_release_name ?? false)
+		&& import('node:fs/promises').then(({ access, constants })=>
+			access(path, constants.F_OK)
+				.then(()=>true)
+				.catch(()=>false)))
+}
+export {
+	file_exists_ as path__exists_
+}
+/**
+ * @param {string}path
+ * @param {number}[timeout]
+ * @param {number}[period]
+ * @returns {Promise<void>}
+ */
+export function file_exists__waitfor(path, timeout = 5000, period = 0) {
+	return waitfor(()=>file_exists_(path), timeout, period)
+}

package/all/file_exists/index.test.ts

@@ -0,0 +1,38 @@
+import esmock from 'esmock'
+import { unlink, writeFile } from 'fs/promises'
+import { test } from 'uvu'
+import { equal } from 'uvu/assert'
+import { tempfile_path_ } from '../tempfile_path/index.js'
+import { file_exists_, file_exists__waitfor } from './index.js'
+test('file_exists_ + file_exists__waitfor|server', async ()=>{
+	const tempfile_path = await tempfile_path_()
+	equal(await file_exists_(tempfile_path), false)
+	await writeFile(tempfile_path, 'test content')
+	try {
+		await file_exists__waitfor(tempfile_path)
+		equal(await file_exists_(tempfile_path), true)
+	} finally {
+		await unlink(tempfile_path)
+	}
+})
+test('file_exists_ + file_exists__waitfor|browser', async ()=>{
+	const { file_exists_, file_exists__waitfor } = await esmock('./index.js', {}, {
+		'../process_release_name/index.js': {
+			process_release_name: undefined
+		}
+	})
+	const tempfile_path = await tempfile_path_()
+	equal(await file_exists_(tempfile_path), false)
+	await writeFile(tempfile_path, 'test content')
+	let err:Error|undefined = undefined
+	try {
+		await file_exists__waitfor(tempfile_path, 10)
+	} catch(_err) {
+		err = _err as Error
+	} finally {
+		await unlink(tempfile_path)
+	}
+	equal(await file_exists_(tempfile_path), false)
+	equal(err?.message, 'Timeout 10ms')
+})
+test.run()

package/all/index.d.ts

@@ -142,6 +142,7 @@ export * from './fetch_method/index.js'
 export * from './fetch_response__throw/index.js'
 export * from './fetch_response_pair/index.js'
 export * from './fibonacci_number/index.js'
+export * from './file_exists/index.js'
 export * from './filter/index.js'
 export * from './filter_o/index.js'
 export * from './filter_o/index.js'
@@ -222,8 +223,10 @@ export * from './isNumber_or/index.js'
 export * from './isObject/index.js'
 export * from './isPrimitive/index.js'
 export * from './isPromiseLike/index.js'
+export * from './is_browser/index.js'
 export * from './is_development/index.js'
 export * from './is_production/index.js'
+export * from './is_server/index.js'
 export * from './is_staging/index.js'
 export * from './item_r_idx/index.js'
 export * from './js_html/index.js'

package/all/index.js

@@ -142,6 +142,7 @@ export * from './fetch_method/index.js'
 export * from './fetch_response__throw/index.js'
 export * from './fetch_response_pair/index.js'
 export * from './fibonacci_number/index.js'
+export * from './file_exists/index.js'
 export * from './filter/index.js'
 export * from './filter_o/index.js'
 export * from './filter_o/index.js'
@@ -222,8 +223,10 @@ export * from './isNumber_or/index.js'
 export * from './isObject/index.js'
 export * from './isPrimitive/index.js'
 export * from './isPromiseLike/index.js'
+export * from './is_browser/index.js'
 export * from './is_development/index.js'
 export * from './is_production/index.js'
+export * from './is_server/index.js'
 export * from './is_staging/index.js'
 export * from './item_r_idx/index.js'
 export * from './js_html/index.js'

package/all/is_browser/index.d.ts

@@ -0,0 +1 @@
+export declare function is_server_():boolean

package/all/is_browser/index.js

@@ -0,0 +1,3 @@
+export function is_server_() {
+	return !!globalThis.process?.release?.name
+}

package/all/is_server/index.d.ts

@@ -0,0 +1 @@
+export declare function is_server_():boolean

package/all/is_server/index.js

@@ -0,0 +1,3 @@
+export function is_browser_() {
+	return !globalThis.process?.release?.name
+}

package/all/process_release_name/index.d.ts

@@ -0,0 +1 @@
+export declare function process_release_name_():string|undefined

package/all/process_release_name/index.js

@@ -0,0 +1 @@
+export const process_release_name = globalThis.process?.release?.name

package/all/waitfor/index.js

@@ -7,10 +7,16 @@ import { sleep } from '../sleep/index.js'
  * @returns {Promise<void>}
  */
 export async function waitfor(fn, timeout, period = 0) {
-	await promise_timeout(async ()=>{
-		for (; ;) {
-			if (await fn()) return
-			await sleep(period)
-		}
-	}, timeout)
+	let cancel
+	try {
+		await promise_timeout(async ()=>{
+			for (; !cancel;) {
+				if (await fn()) return
+				await sleep(period)
+			}
+		}, timeout)
+	} catch (err) {
+		cancel = 1
+		throw err
+	}
 }

package/env/index.d.ts

@@ -1,8 +1,11 @@
 export * from '../all/CACHE_VERSION/index.js'
 export * from '../all/import_meta_env/index.js'
+export * from '../all/is_browser/index.js'
 export * from '../all/is_development/index.js'
 export * from '../all/is_production/index.js'
+export * from '../all/is_server/index.js'
 export * from '../all/is_staging/index.js'
 export * from '../all/missing_env__throw/index.js'
 export * from '../all/NODE_ENV/index.js'
+export * from '../all/process_release_name/index.js'
 export * from '../all/VERSION/index.js'

package/env/index.js

@@ -1,8 +1,11 @@
 export * from '../all/CACHE_VERSION/index.js'
 export * from '../all/import_meta_env/index.js'
+export * from '../all/is_browser/index.js'
 export * from '../all/is_development/index.js'
 export * from '../all/is_production/index.js'
+export * from '../all/is_server/index.js'
 export * from '../all/is_staging/index.js'
 export * from '../all/missing_env__throw/index.js'
 export * from '../all/NODE_ENV/index.js'
+export * from '../all/process_release_name/index.js'
 export * from '../all/VERSION/index.js'

package/fs/index.d.ts

@@ -0,0 +1 @@
+export * from '../all/file_exists/index.js'

package/fs/index.js

@@ -0,0 +1 @@
+export * from '../all/file_exists/index.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ctx-core",
-  "version": "5.2.3",
+  "version": "5.3.0",
   "description": "ctx-core core library",
   "keywords": [
     "ctx-core",
@@ -47,6 +47,7 @@
     "error",
     "fetch",
     "fibonacci",
+    "fs",
     "function",
     "functional",
     "html",
@@ -95,6 +96,7 @@
     "./error": "./error/index.js",
     "./fetch": "./fetch/index.js",
     "./fibonacci": "./fibonacci/index.js",
+    "./fs": "./fs/index.js",
     "./function": "./function/index.js",
     "./functional": "./functional/index.js",
     "./html": "./html/index.js",
@@ -127,6 +129,7 @@
     "c8": "^8.0.1",
     "check-dts": "^0.7.2",
     "esbuild": "^0.19.10",
+    "esmock": "^2.6.0",
     "sinon": "^17.0.1",
     "size-limit": "^11.0.1",
     "tsx": "^4.7.0",
@@ -217,7 +220,7 @@
     "test": "pnpm run /^test:/",
     "test:size": "size-limit",
     "test:type": "check-dts",
-    "test:unit": "tsx node_modules/uvu/bin.js . '\\.test\\.(ts|js)$'",
+    "test:unit": "NODE_OPTIONS=--loader=esmock tsx node_modules/uvu/bin.js . '\\.test\\.(ts|js)$'",
     "disable:test:coverage": "c8 pnpm test-unit"
   }
 }