ciorent 0.0.23 → 0.0.25

package/README.md

@@ -24,40 +24,6 @@ const sem = semaphore.init(2);
 cio.concurrent(6, (sem, id) => task(sem, id), sem);
 ```
 
-## Fibers
-Virtual threads with more controlled execution.
-
-```ts
-import * as cio from 'ciorent';
-import * as fiber from 'ciorent/fiber';
-
-const thread1 = fiber.fn(function* () {
-  console.log('Fiber 1 started');
-
-  // Thread1 will be interrupted by thread2
-  // As thread2 will end first
-  yield cio.sleep(1000);
-
-  console.log('Fiber 1 done');
-});
-
-const thread2 = fiber.fn(function* (thread) {
-  console.log('Fiber 2 started');
-
-  yield;
-  console.log('Fiber 2 resumed');
-
-  // Start thread 1 and make thread1
-  // lifetime depends on thread2
-  fiber.mount(fiber.spawn(thread1), thread);
-
-  console.log('Fiber 2 done');
-});
-
-// Start running the thread
-fiber.spawn(thread2);
-```
-
 ## Latch
 Latch is a synchronization primitive that allows one process to wait until another completes an operation before continuing execution.
 
@@ -101,6 +67,40 @@ await main();
 await main();
 ```
 
+## Fibers
+Virtual threads with more controlled execution.
+
+```ts
+import * as cio from 'ciorent';
+import * as fiber from 'ciorent/fiber';
+
+const thread1 = fiber.fn(function* () {
+  console.log('Fiber 1 started');
+
+  // Thread1 will be interrupted by thread2
+  // As thread2 will end first
+  yield cio.sleep(1000);
+
+  console.log('Fiber 1 done');
+});
+
+const thread2 = fiber.fn(function* (thread) {
+  console.log('Fiber 2 started');
+
+  yield;
+  console.log('Fiber 2 resumed');
+
+  // Start thread 1 and make thread1
+  // lifetime depends on thread2
+  fiber.mount(fiber.spawn(thread1), thread);
+
+  console.log('Fiber 2 done');
+});
+
+// Start running the thread
+fiber.spawn(thread2);
+```
+
 ## Pubsub
 A fast, simple publish-subscribe API.
 
@@ -243,7 +243,7 @@ cio.concurrent(5, task);
 ```
 
 ### Debounce
-Dropping tasks for a period of time
+Dropping tasks for a period of time.
 ```ts
 import * as cio from 'ciorent';
 
@@ -252,7 +252,23 @@ const fn = cio.debounce((id: number) => {
 }, 500);
 
 fn(1); // fn(1) gets skipped
-cio.sleepSync(100);
+await cio.sleep(100);
 fn(2); // fn(2) gets executed
 ```
 
+### Rate limit
+Limit function calls for a specific period of time.
+```ts
+import * as cio from 'ciorent';
+
+const fn = cio.rateLimit((id: number) => {
+  console.log('ID:', id);
+}, 500, 1);
+
+fn(1); // fn(1) gets executed
+await cio.sleep(100);
+fn(2); // fn(2) gets skipped
+await cio.sleep(500);
+fn(3); // fn(3) gets executed
+```
+

package/index.d.ts

@@ -34,8 +34,15 @@ export declare const sequential: <const T extends any[]>(n: number, task: (...ar
  */
 export declare const concurrent: <const T extends any[], const R>(n: number, task: (...args: [...T, id: number]) => Promise<R>, ...args: T) => Promise<R[]>;
 /**
- * Drop sync function calls for a specific period
+ * Drop function calls until it doesn't get called for a specific period.
  * @param f - The target function to debounce
  * @param ms - The time period in milliseconds
  */
 export declare const debounce: <const Args extends any[]>(f: (...args: Args) => any, ms: number) => ((...args: Args) => void);
+/**
+ * Drop function calls for a specific period
+ * @param f - The target function to throttle
+ * @param ms - The time period in milliseconds
+ * @param limit - The call limit in the time period
+ */
+export declare const rateLimit: <const Args extends any[]>(f: (...args: Args) => any, ms: number, limit: number) => ((...args: Args) => void);

package/index.js

@@ -1 +1 @@
-export let pause=Promise.resolve();export let sleep=globalThis.Bun?.sleep??globalThis.process?.getBuiltinModule?.("timers/promises").setTimeout??((ms)=>new Promise((res)=>{setTimeout(res,ms)}));let sharedBuf=new Int32Array(new SharedArrayBuffer(4));export let sleepSync=globalThis.Bun?.sleepSync??((ms)=>{Atomics.wait(sharedBuf,0,0,ms)});export let sequential=async(n,task,...args)=>{for(let i=0;i<n;i++)await task(...args,i)};export let concurrent=(n,task,...args)=>{let arr=new Array(n);for(let i=0;i<n;i++)arr[i]=task(...args,i);return Promise.all(arr)};export let debounce=(f,ms)=>{let args;let unlocked=true;let unlock=()=>{unlocked=true};let call=()=>Promise.try(f,...args).finally(unlock);return(...a)=>{args=a;if(unlocked){unlocked=false;setTimeout(call,ms)}}};
+export let pause=Promise.resolve();export let sleep=globalThis.Bun?.sleep??globalThis.process?.getBuiltinModule?.("timers/promises").setTimeout??((ms)=>new Promise((res)=>{setTimeout(res,ms)}));let sharedBuf=new Int32Array(new SharedArrayBuffer(4));export let sleepSync=globalThis.Bun?.sleepSync??((ms)=>{Atomics.wait(sharedBuf,0,0,ms)});export let sequential=async(n,task,...args)=>{for(let i=0;i<n;i++)await task(...args,i)};export let concurrent=(n,task,...args)=>{let arr=new Array(n);for(let i=0;i<n;i++)arr[i]=task(...args,i);return Promise.all(arr)};export let debounce=(f,ms)=>{let id;return(...a)=>{clearTimeout(id);id=setTimeout(f,ms,...a)}};export let rateLimit=(f,ms,limit)=>{let cur=limit;let call=()=>{cur++};return(...a)=>{if(cur>0){cur--;f(...a);setTimeout(call,ms)}}};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ciorent",
-  "version": "0.0.23",
+  "version": "0.0.25",
   "description": "A lightweight, low-overhead concurrency library",
   "homepage": "https://ciorent.netlify.app",
   "repository": {
@@ -18,14 +18,14 @@
   "main": "./index.js",
   "types": "./index.d.ts",
   "exports": {
-    "./fixed-queue": "./fixed-queue.js",
+    "./latch": "./latch.js",
     "./sliding-queue": "./sliding-queue.js",
-    "./fiber": "./fiber.js",
     "./channel": "./channel.js",
+    "./fixed-queue": "./fixed-queue.js",
+    ".": "./index.js",
     "./dropping-queue": "./dropping-queue.js",
     "./topic": "./topic.js",
     "./semaphore": "./semaphore.js",
-    ".": "./index.js",
-    "./latch": "./latch.js"
+    "./fiber": "./fiber.js"
   }
 }