ciorent 0.0.13 → 0.0.14

package/README.md

@@ -1,28 +1,4 @@
 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 of these tasks to run concurrently
-const task = semaphore.task(
-  semaphore.init(2),
-  async (task: number) => {
-    for (let i = 1; i <= 5; i++) {
-      console.log('Task', task, 'iteration', i);
-      await cio.pause;
-    }
-
-    console.log('Task', task, 'end');
-  }
-);
-
-// Try to run 6 tasks with 4 tasks running concurrently
-cio.concurrent(6, task, 4);
-```
-
 # Latch
 Latch is a synchronization primitive that allows one process to wait until another completes an operation before continuing execution.
 
@@ -66,6 +42,66 @@ await main();
 await main();
 ```
 
+# Pubsub
+A fast, simple publish-subscribe API.
+
+```ts
+import * as topic from 'ciorent/topic';
+import * as cio from 'ciorent';
+
+const messages = topic.init<number>();
+
+// A task that publish messages
+const publisher = async () => {
+  for (let i = 0; i < 5; i++) {
+    await cio.sleep(50);
+    topic.pub(messages, i);
+  }
+
+  // Resolve all waiting promises
+  // And clear the value queue
+  topic.flush(messages);
+}
+
+// Spawn 5 tasks that recieve messages
+cio.concurrent(5, async (id: number) => {
+  const sub = topic.sub(messages);
+
+  while (true) {
+    // Block until
+    const x = await topic.next(sub);
+    if (x == null) break;
+    console.log(`Task ${id}: ${x}`);
+  }
+});
+
+publisher();
+```
+
+# 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 of these tasks to run concurrently
+const task = semaphore.task(
+  semaphore.init(2),
+  async (task: number) => {
+    for (let i = 1; i <= 5; i++) {
+      console.log('Task', task, 'iteration', i);
+      await cio.pause;
+    }
+
+    console.log('Task', task, 'end');
+  }
+);
+
+// Try to run 6 tasks with 4 tasks running concurrently
+cio.concurrent(6, task, 4);
+```
+
 # Channel
 Channel is a synchronization primitive via message passing. A message may be sent over a channel, and another process is able to receive messages sent over a channel it has a reference to.
 
@@ -107,37 +143,6 @@ log();
 console.log('Starting...');
 ```
 
-# Pubsub
-A simple publish-subscribe API
-
-```ts
-import * as topic from 'ciorent/topic';
-import * as cio from 'ciorent';
-
-const messages = topic.init<number>();
-
-// A task that publish messages
-const publisher = async () => {
-  for (let i = 0; i < 5; i++) {
-    await cio.sleep(50);
-    topic.pub(messages, i);
-  }
-}
-
-// Spawn 5 tasks that recieve messages
-cio.concurrent(5, async (id: number) => {
-  const sub = topic.sub(messages);
-
-  while (true) {
-    const x = await topic.next(sub);
-    if (x == null) break;
-    console.log(`Task ${id}: ${x}`);
-  }
-});
-
-publisher();
-```
-
 # Utilities
 ## Pausing
 Delay the execution of a function for other asynchronous tasks to run.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ciorent",
-  "version": "0.0.13",
+  "version": "0.0.14",
   "description": "A lightweight, low-overhead concurrency library",
   "homepage": "https://ciorent.netlify.app",
   "repository": {

package/topic.d.ts

@@ -41,10 +41,10 @@ export declare const sub: <T extends {}>(t: Topic<T>) => Subscriber<T>;
  */
 export declare const pub: <T extends {}>(t: Topic<T>, value: T) => void;
 /**
- * Resolve all waiting promises
+ * Resolve all waiting promises and clear all pending values
  * @param t
  */
-export declare const close: <T extends {}>(t: Topic<T>) => void;
+export declare const flush: <T extends {}>(t: Topic<T>) => void;
 /**
  * Get the next value in the message queue.
  *

package/topic.js

@@ -1 +1 @@
-export let init=()=>[[null,null],[],[]];export let sub=(t)=>[t,t[0]];export let pub=(t,value)=>{let head=t[0]=t[0][1]=[value,null];for(let i=0,res=t[1],subs=t[2];i<res.length;i++){res[i](value);subs[i][1]=head}t[1]=[];t[2]=[]};export let close=(t)=>{for(let i=0,res=t[1],subs=t[2],head=t[0];i<res.length;i++){res[i]();subs[i][1]=head}t[1]=[];t[2]=[]};export let poll=(t)=>t[1][1]!==null?(t[1]=t[1][1])[0]:undefined;export let next=(t)=>{if(t[1][1]!==null)return Promise.resolve((t[1]=t[1][1])[0]);let topic=t[0];topic[2].push(t);return new Promise((res)=>{topic[1].push(res)})};
+export let init=()=>[[null,null],[],[]];export let sub=(t)=>[t,t[0]];export let pub=(t,value)=>{let head=t[0]=t[0][1]=[value,null];for(let i=0,res=t[1],subs=t[2];i<res.length;i++){res[i](value);subs[i][1]=head}t[1]=[];t[2]=[]};export let flush=(t)=>{let head=t[0]=[null,null];for(let i=0,res=t[1],subs=t[2];i<res.length;i++){res[i]();subs[i][1]=head}t[1]=[];t[2]=[]};export let poll=(t)=>t[1][1]!==null?(t[1]=t[1][1])[0]:undefined;export let next=(t)=>{if(t[1][1]!==null)return Promise.resolve((t[1]=t[1][1])[0]);let topic=t[0];topic[2].push(t);return new Promise((res)=>{topic[1].push(res)})};