waiit 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 VARInc
+
+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,137 @@
+# waiit
+
+[![npm version](https://img.shields.io/npm/v/waiit.svg)](https://www.npmjs.com/package/waiit)
+[![license](https://img.shields.io/npm/l/waiit.svg)](https://github.com/Raju/waiit/blob/main/LICENSE)
+
+A lightweight, zero-dependency utility to wait for any amount of time in milliseconds. Returns a promise that resolves after the specified delay, or immediately if no value is passed.
+
+## Features
+
+- 🪶 **Lightweight** - Single line of code, zero dependencies
+- ⚡ **Simple API** - Easy to use with async/await
+- 📦 **TypeScript Support** - Includes type definitions
+- 🔧 **Flexible** - Pass any millisecond value or omit for immediate resolution
+- 🌐 **Universal** - Works in Node.js and browsers
+
+## Platform Support
+
+| Platform | Supported |
+|----------|-----------|
+| Node.js  | ✅        |
+| Browser  | ✅        |
+
+## Installation
+
+```bash
+npm install waiit
+```
+
+## API
+
+```js
+wait(ms?: number): Promise<void>
+```
+
+| Parameter | Type     | Default | Description                          |
+|-----------|----------|---------|--------------------------------------|
+| `ms`      | `number` | `0`     | Time to wait in milliseconds         |
+
+**Returns:** A `Promise` that resolves after the specified time.
+
+## Examples
+
+```js
+wait()      // Returns a promise that resolves immediately
+wait(1000)  // Returns a promise that resolves after 1 second
+wait(5000)  // Returns a promise that resolves after 5 seconds
+```
+
+## Usage
+
+### CommonJS
+
+```js
+const wait = require('waiit');
+
+const doSomething = async () => {
+  console.log('Start');
+
+  await wait(5000);
+  console.log('Waited 5 seconds');
+
+  await wait();
+  console.log('Finish');
+};
+
+doSomething();
+```
+
+### ES Modules
+
+```js
+import wait from 'waiit';
+
+async function example() {
+  console.log('Starting...');
+  await wait(2000);
+  console.log('Done after 2 seconds!');
+}
+
+example();
+```
+
+### Browser (via CDN)
+
+```html
+<script type="module">
+  // Using unpkg
+  import wait from 'https://unpkg.com/waiit/app.js';
+
+  await wait(1000);
+  console.log('Waited 1 second!');
+</script>
+```
+
+### Practical Examples
+
+#### Retry with delay
+
+```js
+const wait = require('waiit');
+
+async function fetchWithRetry(url, retries = 3, delay = 1000) {
+  for (let i = 0; i < retries; i++) {
+    try {
+      return await fetch(url);
+    } catch (error) {
+      if (i < retries - 1) {
+        await wait(delay);
+      }
+    }
+  }
+  throw new Error('Max retries reached');
+}
+```
+
+#### Sequential execution with delays
+
+```js
+const wait = require('waiit');
+
+async function animateSteps(steps) {
+  for (const step of steps) {
+    console.log(step.message);
+    await wait(step.delay);
+  }
+}
+
+animateSteps([
+  { message: 'Step 1', delay: 1000 },
+  { message: 'Step 2', delay: 2000 },
+  { message: 'Step 3', delay: 1000 },
+]);
+```
+
+## License
+
+[MIT](LICENSE) © Raju Dhami

package/app.js

@@ -0,0 +1 @@
+module.exports=t=>new Promise(r=>setTimeout(r,t));

package/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Wait for a specified amount of time.
+ * @param ms - Time to wait in milliseconds. Defaults to 0 (resolves immediately).
+ * @returns A promise that resolves after the specified time.
+ * @example
+ * await wait(2000); // Wait for 2 seconds
+ * await wait(); // Resolve immediately
+ */
+declare function wait(ms?: number): Promise<void>;
+export = wait;

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "waiit",
+  "version": "0.0.1",
+  "description": "Wait for any amount of time in milliseconds or resolve immediately if no value passed",
+  "main": "app.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./app.js",
+      "import": "./app.js"
+    }
+  },
+  "scripts": {
+    "test": "node test.js && node test.mjs",
+    "test:cjs": "node test.js",
+    "test:esm": "node test.mjs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Raju/waiit.git"
+  },
+  "keywords": [
+    "wait",
+    "delay",
+    "sleep",
+    "timeout",
+    "promise",
+    "async",
+    "await",
+    "setTimeout",
+    "timer",
+    "pause",
+    "browser",
+    "node"
+  ],
+  "author": "Raju Dhami",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Raju/waiit/issues"
+  },
+  "homepage": "https://github.com/Raju/waiit#readme",
+  "engines": {
+    "node": ">=10.0.0"
+  },
+  "files": [
+    "app.js",
+    "index.d.ts"
+  ]
+}