ciorent 0.0.16 → 0.0.17

package/README.md

@@ -23,47 +23,42 @@ const task = semaphore.task(
 cio.concurrent(6, task);
 ```
 
-## Latch
-Latch is a synchronization primitive that allows one process to wait until another completes an operation before continuing execution.
+## 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.
 
 ```ts
-import * as latch from 'ciorent/latch';
+import * as channel from 'ciorent/channel';
 import * as cio from 'ciorent';
 
-const fetchLatch = latch.init();
-
-const task = async () => {
-  // Blocks until the latch is open
-  await latch.pause(fetchLatch);
-
-  const res = await fetch('http://example.com');
-  console.log('Fetch status:', res.status);
-}
-
-const prepare = () => {
-  console.log('Run before fetch:', performance.now().toFixed(2));
-}
+const c = channel.init<number>();
 
-const main = async () => {
-  const p = task();
-  await cio.sleep(500);
-  prepare();
+const run = async () => {
+  for (let i = 0; i < 10; i++) {
+    await cio.sleep(10);
+    channel.send(c, i);
+    console.log('Sent', i);
+  }
 
-  // Allows all previously blocked tasks to run
-  latch.open(fetchLatch);
+  // Resolve all waiting promises with `undefined`
+  // This is a way to tell the reciever to not listen to more data
+  channel.flush(c);
+};
 
-  // Reclose the latch
-  // Tasks that aren't blocked yet will be blocked
-  latch.reset(fetchLatch);
+const log = async () => {
+  while (true) {
+    // Wait until a value is sent
+    const x = await channel.recieve(c);
+    if (x == null) break;
 
-  return p;
+    console.log('Recieved', x);
+  };
 }
 
-// Run fetch after 500ms
-await main();
+run();
+log();
 
-// Run fetch after another 500ms
-await main();
+// This runs first
+console.log('Starting...');
 ```
 
 ## Pubsub
@@ -102,42 +97,47 @@ cio.concurrent(5, async (id: number) => {
 publisher();
 ```
 
-## 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.
+## Latch
+Latch is a synchronization primitive that allows one process to wait until another completes an operation before continuing execution.
 
 ```ts
-import * as channel from 'ciorent/channel';
+import * as latch from 'ciorent/latch';
 import * as cio from 'ciorent';
 
-const c = channel.init<number>();
+const fetchLatch = latch.init();
 
-const run = async () => {
-  for (let i = 0; i < 10; i++) {
-    await cio.sleep(10);
-    channel.send(c, i);
-    console.log('Sent', i);
-  }
+const task = async () => {
+  // Blocks until the latch is open
+  await latch.pause(fetchLatch);
 
-  // Resolve all waiting promises with `undefined`
-  // This is a way to tell the reciever to not listen to more data
-  channel.flush(c);
-};
+  const res = await fetch('http://example.com');
+  console.log('Fetch status:', res.status);
+}
 
-const log = async () => {
-  while (true) {
-    // Wait until a value is sent
-    const x = await channel.recieve(c);
-    if (x == null) break;
+const prepare = () => {
+  console.log('Run before fetch:', performance.now().toFixed(2));
+}
 
-    console.log('Recieved', x);
-  };
+const main = async () => {
+  const p = task();
+  await cio.sleep(500);
+  prepare();
+
+  // Allows all previously blocked tasks to run
+  latch.open(fetchLatch);
+
+  // Reclose the latch
+  // Tasks that aren't blocked yet will be blocked
+  latch.reset(fetchLatch);
+
+  return p;
 }
 
-run();
-log();
+// Run fetch after 500ms
+await main();
 
-// This runs first
-console.log('Starting...');
+// Run fetch after another 500ms
+await main();
 ```
 
 ## Utilities

package/channel.d.ts

@@ -1,7 +1,7 @@
 /**
  * @module Channels
  */
-import type { QueueNode } from './fixed-queue';
+import type { QueueNode } from './fixed-queue.js';
 /**
  * Describe a channel
  */

package/dropping-queue.d.ts

@@ -1,9 +1,9 @@
 /**
  * @module Dropping queues
  */
-import type { FixedQueue } from './fixed-queue';
-export { init } from './fixed-queue';
-export { pop } from './sliding-queue';
+import type { FixedQueue } from './fixed-queue.js';
+export { init } from './fixed-queue.js';
+export { pop } from './sliding-queue.js';
 /**
  * Push an item to a dropping queue
  * @param q - The queue to push to

package/dropping-queue.js

@@ -1 +1 @@
-export{init}from"./fixed-queue";export{pop}from"./sliding-queue";export let push=(q,item)=>{if(q[0][(q[2]+1)%q[1]]!=null)return false;q[0][q[2]=(q[2]+1)%q[1]]=item;return true};
+export{init}from"./fixed-queue.js";export{pop}from"./sliding-queue.js";export let push=(q,item)=>{if(q[0][(q[2]+1)%q[1]]!=null)return false;q[0][q[2]=(q[2]+1)%q[1]]=item;return true};

package/latch.js

@@ -1 +1 @@
-import{pause as endPromise}from".";export let init=()=>{let r;return[new Promise((res)=>{r=res}),r]};export let pause=(latch)=>latch[0];export let open=(latch)=>{latch[1]();latch[0]=endPromise};export let reset=(latch)=>{if(latch[0]===endPromise){let r;latch[0]=new Promise((res)=>{r=res});latch[1]=r}};
+import{pause as endPromise}from"./index.js";export let init=()=>{let r;return[new Promise((res)=>{r=res}),r]};export let pause=(latch)=>latch[0];export let open=(latch)=>{latch[1]();latch[0]=endPromise};export let reset=(latch)=>{if(latch[0]===endPromise){let r;latch[0]=new Promise((res)=>{r=res});latch[1]=r}};

package/package.json

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

package/semaphore.d.ts

@@ -1,7 +1,7 @@
 /**
  * @module Semaphores
  */
-import type { QueueNode } from './fixed-queue';
+import type { QueueNode } from './fixed-queue.js';
 /**
  * Describe a semaphore
  */

package/semaphore.js

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

package/sliding-queue.d.ts

@@ -1,8 +1,8 @@
 /**
  * @module Sliding queues
  */
-import type { FixedQueue } from './fixed-queue';
-export { init } from './fixed-queue';
+import type { FixedQueue } from './fixed-queue.js';
+export { init } from './fixed-queue.js';
 /**
  * Push an item to a sliding queue
  * @param q - The queue to push to

package/sliding-queue.js

@@ -1 +1 @@
-export{init}from"./fixed-queue";export let push=(q,item)=>{q[0][q[2]=(q[2]+1)%q[1]]=item};export let pop=(q)=>{let val=q[0][(q[3]+1)%q[1]];if(val!=null){q[0][q[3]=(q[3]+1)%q[1]]=null;return val}};
+export{init}from"./fixed-queue.js";export let push=(q,item)=>{q[0][q[2]=(q[2]+1)%q[1]]=item};export let pop=(q)=>{let val=q[0][(q[3]+1)%q[1]];if(val!=null){q[0][q[3]=(q[3]+1)%q[1]]=null;return val}};

package/topic.d.ts

@@ -1,7 +1,7 @@
 /**
  * @module Pubsub
  */
-import type { QueueNode } from './fixed-queue';
+import type { QueueNode } from './fixed-queue.js';
 /**
  * Describe a topic
  */