ciorent 0.1.1 → 0.1.2

package/README.md

@@ -1,4 +1,33 @@
 A lightweight, low-overhead concurrency library.
+## Semaphore
+Semaphore is a concurrency primitive used to control access to a common resource by multiple processes.
+
+```ts
+import * as semaphore from 'ciorent/semaphore';
+import * as cio from 'ciorent';
+
+// Only allow 2 task to run concurrently
+const sem = semaphore.init(2);
+
+const task = async (id: number) => {
+  // Acquire the semaphore or wait for the semaphore to be available
+  await semaphore.pause(sem);
+
+  console.log('Task', id, 'started');
+
+  // Let the main thread schedules other tasks
+  for (let i = 1; i <= 5; i++) await cio.pause;
+
+  console.log('Task', id, 'end');
+
+  // Release the semaphore
+  semaphore.signal(sem);
+}
+
+// Try to run 5 tasks concurrently
+cio.concurrent(5, task);
+```
+
 ## Fibers
 Virtual threads with more controlled execution.
 
@@ -134,35 +163,6 @@ run();
 console.log('Starting...');
 ```
 
-## Semaphore
-Semaphore is a concurrency primitive used to control access to a common resource by multiple processes.
-
-```ts
-import * as semaphore from 'ciorent/semaphore';
-import * as cio from 'ciorent';
-
-// Only allow 2 task to run concurrently
-const sem = semaphore.init(2);
-
-const task = async (id: number) => {
-  // Acquire the semaphore or wait for the semaphore to be available
-  await semaphore.pause(sem);
-
-  console.log('Task', id, 'started');
-
-  // Let the main thread schedules other tasks
-  for (let i = 1; i <= 5; i++) await cio.pause;
-
-  console.log('Task', id, 'end');
-
-  // Release the semaphore
-  semaphore.signal(sem);
-}
-
-// Try to run 5 tasks concurrently
-cio.concurrent(5, task);
-```
-
 ## Utilities
 ### Pausing
 Delay the execution of a function for other asynchronous tasks to run.
@@ -253,16 +253,16 @@ Limits the number of calls within a time window.
 ```ts
 import * as cio from 'ciorent';
 
-// Allow 1 call in 500ms
+// Allow 2 calls in 500ms, other calls are dropped
 const fn = cio.rateLimit((id: number) => {
   console.log('Call ' + id + ':', Math.floor(performance.now()) + 'ms');
-}, 500, 1);
+}, 500, 2);
 
-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
+// Some calls will be dropped
+for (let i = 0; i < 8; i++) {
+  fn(i);
+  await cio.sleep(400);
+}
 ```
 
 ### Throttle
@@ -275,6 +275,6 @@ const fn = cio.throttle((id: number) => {
   console.log(id + ': ' + Math.floor(performance.now()) + 'ms');
 }, 500, 2);
 
-cio.concurrent(8, (id) => fn(id));
+cio.concurrent(8, fn);
 ```
 

package/fiber.js

@@ -1 +1 @@
-export let paused=(t)=>t[1]===0;export let running=(t)=>t[1]===1;export let done=(t)=>t[1]===2;let invoke=async(g,thread)=>{try{let t=g.next();while(!t.done){let v=await t.value;if(thread[1]===0){let r;let p=new Promise((res)=>{r=res});thread[2]=r;await p}if(thread[1]===2){thread[3].forEach(stop);return v}t=g.next(v)}thread[1]=2;return t.value}finally{thread[3].forEach(stop)}};export let fn=(f)=>f;export let spawn=(f,...args)=>{let thread=[null,1,null,[]];thread[0]=invoke(f(thread,...args),thread);return thread};export let pause=(t)=>{if(t[1]===1)t[1]=0};export let resume=(t)=>{if(t[1]===0){t[1]=1;t[2]?.()}};export let stop=(t)=>{if(t[1]===0){t[1]=2;t[2]?.()}else t[1]=2};export function*join(t){return yield t[1]}export let finish=(t)=>t[1];export let mount=(child,parent)=>{parent[3].push(child)};export let control=(t,signal)=>{signal.addEventListener("abort",()=>{stop(t)})};export function*unwrap(t){return yield t}
+export let paused=(t)=>t[1]===0;export let running=(t)=>t[1]===1;export let done=(t)=>t[1]===2;let invoke=async(g,thread)=>{try{let t=g.next();while(!t.done){let v=await t.value;if(thread[1]===0){let r;let p=new Promise((res)=>{r=res});thread[2]=r;await p}if(thread[1]===2)return v;t=g.next(v)}thread[1]=2;return t.value}finally{thread[3].forEach(stop)}};export let fn=(f)=>f;export let spawn=(f,...args)=>{let thread=[null,1,null,[]];thread[0]=invoke(f(thread,...args),thread);return thread};export let pause=(t)=>{if(t[1]===1)t[1]=0};export let resume=(t)=>{if(t[1]===0){t[1]=1;t[2]?.()}};export let stop=(t)=>{if(t[1]===0){t[1]=2;t[2]?.()}else t[1]=2};export function*join(t){return yield t[1]}export let finish=(t)=>t[1];export let mount=(child,parent)=>{parent[3].push(child)};export let control=(t,signal)=>{signal.addEventListener("abort",()=>{stop(t)})};export function*unwrap(t){return yield t}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ciorent",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "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": {
-    "./sliding-queue": "./sliding-queue.js",
-    "./semaphore": "./semaphore.js",
-    "./topic": "./topic.js",
-    ".": "./index.js",
-    "./latch": "./latch.js",
-    "./channel": "./channel.js",
     "./fixed-queue": "./fixed-queue.js",
+    "./sliding-queue": "./sliding-queue.js",
     "./dropping-queue": "./dropping-queue.js",
-    "./fiber": "./fiber.js"
+    "./fiber": "./fiber.js",
+    "./channel": "./channel.js",
+    ".": "./index.js",
+    "./topic": "./topic.js",
+    "./semaphore": "./semaphore.js",
+    "./latch": "./latch.js"
   }
 }

package/semaphore.d.ts

@@ -32,6 +32,6 @@ export declare const pause: (s: Semaphore) => Promise<void>;
  */
 export declare const signal: (s: Semaphore) => void;
 /**
- * Wrap a task to bind to a custom semaphore later
+ * Bind a task to a semaphore
  */
-export declare const wrap: <Args extends any[], Return extends Promise<any>>(f: (...args: Args) => Return) => ((s: Semaphore, ...a: Args) => Return);
+export declare const bind: <T extends (...args: any[]) => Promise<any>>(f: T, s: Semaphore) => T;

package/semaphore.js

@@ -1 +1 @@
-import{pause as resolvedPromise}from"./index.js";export let init=(n)=>{let root=[null];return[n,root,root]};export let pause=(s)=>{s[0]--;if(s[0]<0){let r;let p=new Promise((res)=>{r=res});s[1]=s[1][0]=[null,r];return p}return resolvedPromise};export let signal=(s)=>{if(s[0]<0)(s[2]=s[2][0])[1]();s[0]++};export let wrap=(f)=>async(s,...a)=>{s[0]--;if(s[0]<0){let r;let p=new Promise((res)=>{r=res});s[1]=s[1][0]=[null,r];await p}try{return await f(...a)}finally{signal(s)}};
+import{pause as resolvedPromise}from"./index.js";export let init=(n)=>{let root=[null];return[n,root,root]};export let pause=(s)=>{s[0]--;if(s[0]<0){let r;let p=new Promise((res)=>{r=res});s[1]=s[1][0]=[null,r];return p}return resolvedPromise};export let signal=(s)=>{if(s[0]<0)(s[2]=s[2][0])[1]();s[0]++};export let bind=(f,s)=>async(...a)=>{s[0]--;if(s[0]<0){let r;let p=new Promise((res)=>{r=res});s[1]=s[1][0]=[null,r];await p}try{return await f(...a)}finally{if(s[0]<0)(s[2]=s[2][0])[1]();s[0]++}};