@nmtjs/core 0.6.0

package/dist/lib/utils/functions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../lib/utils/functions.ts"],"sourcesContent":["import type { Pattern } from '../types.ts'\n\n/**\n * Very simple pattern matching function.\n */\nexport function match(value: string, pattern: Pattern) {\n  if (typeof pattern === 'function') {\n    return pattern(value)\n  } else if (typeof pattern === 'string') {\n    if (pattern === '*' || pattern === '**') {\n      return true\n    } else if (pattern.at(0) === '*' && pattern.at(-1) === '*') {\n      return value.includes(pattern.slice(1, -1))\n    } else if (pattern.at(-1) === '*') {\n      return value.startsWith(pattern.slice(0, -1))\n    } else if (pattern.at(0) === '*') {\n      return value.endsWith(pattern.slice(1))\n    } else {\n      return value === pattern\n    }\n  } else {\n    return pattern.test(value)\n  }\n}\n\nexport function isJsFile(name: string) {\n  if (name.endsWith('.d.ts')) return false\n  const leading = name.split('.').slice(1)\n  const ext = leading.join('.')\n  return ['js', 'mjs', 'cjs', 'ts', 'mts', 'cts'].includes(ext)\n}\n"],"names":["match","value","pattern","at","includes","slice","startsWith","endsWith","test","isJsFile","name","leading","split","ext","join"],"mappings":"AAKA,OAAO,SAASA,MAAMC,KAAa,EAAEC,OAAgB;IACnD,IAAI,OAAOA,YAAY,YAAY;QACjC,OAAOA,QAAQD;IACjB,OAAO,IAAI,OAAOC,YAAY,UAAU;QACtC,IAAIA,YAAY,OAAOA,YAAY,MAAM;YACvC,OAAO;QACT,OAAO,IAAIA,QAAQC,EAAE,CAAC,OAAO,OAAOD,QAAQC,EAAE,CAAC,CAAC,OAAO,KAAK;YAC1D,OAAOF,MAAMG,QAAQ,CAACF,QAAQG,KAAK,CAAC,GAAG,CAAC;QAC1C,OAAO,IAAIH,QAAQC,EAAE,CAAC,CAAC,OAAO,KAAK;YACjC,OAAOF,MAAMK,UAAU,CAACJ,QAAQG,KAAK,CAAC,GAAG,CAAC;QAC5C,OAAO,IAAIH,QAAQC,EAAE,CAAC,OAAO,KAAK;YAChC,OAAOF,MAAMM,QAAQ,CAACL,QAAQG,KAAK,CAAC;QACtC,OAAO;YACL,OAAOJ,UAAUC;QACnB;IACF,OAAO;QACL,OAAOA,QAAQM,IAAI,CAACP;IACtB;AACF;AAEA,OAAO,SAASQ,SAASC,IAAY;IACnC,IAAIA,KAAKH,QAAQ,CAAC,UAAU,OAAO;IACnC,MAAMI,UAAUD,KAAKE,KAAK,CAAC,KAAKP,KAAK,CAAC;IACtC,MAAMQ,MAAMF,QAAQG,IAAI,CAAC;IACzB,OAAO;QAAC;QAAM;QAAO;QAAO;QAAM;QAAO;KAAM,CAACV,QAAQ,CAACS;AAC3D"}

package/dist/lib/utils/index.js

@@ -0,0 +1,3 @@
+export * from "./functions.js";
+export * from "./pool.js";
+export * from "./semaphore.js";

package/dist/lib/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../lib/utils/index.ts"],"sourcesContent":["export * from './functions.ts'\nexport * from './pool.ts'\nexport * from './semaphore.ts'\n"],"names":[],"mappings":"AAAA,cAAc,iBAAgB;AAC9B,cAAc,YAAW;AACzB,cAAc,iBAAgB"}

package/dist/lib/utils/pool.js

@@ -0,0 +1,100 @@
+export class PoolError extends Error {
+}
+export class Pool {
+    options;
+    #items;
+    #free;
+    #queue;
+    #current;
+    #size;
+    #available;
+    constructor(options = {}){
+        this.options = options;
+        this.#items = [];
+        this.#free = [];
+        this.#queue = [];
+        this.#current = 0;
+        this.#size = 0;
+        this.#available = 0;
+    }
+    add(item) {
+        if (this.#items.includes(item)) throw new PoolError('Item already exists');
+        this.#size++;
+        this.#available++;
+        this.#items.push(item);
+        this.#free.push(true);
+    }
+    remove(item) {
+        if (this.#size === 0) throw new PoolError('Pool is empty');
+        const index = this.#items.indexOf(item);
+        if (index < 0) throw new PoolError('Item is not in the pool');
+        const isCaptured = this.isFree(item);
+        if (isCaptured) this.#available--;
+        this.#size--;
+        this.#current--;
+        this.#items.splice(index, 1);
+        this.#free.splice(index, 1);
+    }
+    capture(timeout = this.options.timeout) {
+        return this.next(true, timeout);
+    }
+    async next(exclusive = false, timeout = this.options.timeout) {
+        if (this.#size === 0) throw new PoolError('Pool is empty');
+        if (this.#available === 0) {
+            return new Promise((resolve, reject)=>{
+                const waiting = {
+                    resolve: (item)=>{
+                        if (exclusive) this.#capture(item);
+                        resolve(item);
+                    },
+                    timer: undefined
+                };
+                if (timeout) {
+                    waiting.timer = setTimeout(()=>{
+                        waiting.resolve = undefined;
+                        this.#queue.shift();
+                        reject(new PoolError('Next item timeout'));
+                    }, timeout);
+                }
+                this.#queue.push(waiting);
+            });
+        }
+        let item = undefined;
+        let free = false;
+        do {
+            item = this.#items[this.#current];
+            free = this.#free[this.#current];
+            this.#current++;
+            if (this.#current >= this.#size) this.#current = 0;
+        }while (typeof item === 'undefined' || !free)
+        if (exclusive) this.#capture(item);
+        return item;
+    }
+    release(item) {
+        const index = this.#items.indexOf(item);
+        if (index < 0) throw new PoolError('Unexpected item');
+        if (this.#free[index]) throw new PoolError('Unable to release not captured item');
+        this.#free[index] = true;
+        this.#available++;
+        if (this.#queue.length > 0) {
+            const { resolve, timer } = this.#queue.shift();
+            clearTimeout(timer);
+            if (resolve) setTimeout(resolve, 0, item);
+        }
+    }
+    isFree(item) {
+        const index = this.#items.indexOf(item);
+        if (index < 0) return false;
+        return this.#free[index];
+    }
+    get items() {
+        return [
+            ...this.#items
+        ];
+    }
+    #capture(item) {
+        const index = this.#items.indexOf(item);
+        this.#free[index] = false;
+        this.#available--;
+    }
+}

package/dist/lib/utils/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../lib/utils/pool.ts"],"sourcesContent":["import type { Callback } from '@nmtjs/common'\n\ninterface PoolOptions {\n  timeout?: number\n}\n\ninterface PoolQueueItem {\n  resolve?: Callback\n  timer?: ReturnType<typeof setTimeout>\n}\n\nexport class PoolError extends Error {}\n\n// Fixed pool from https://github.com/metarhia/metautil\nexport class Pool<T = unknown> {\n  #items: Array<T> = []\n  #free: Array<boolean> = []\n  #queue: PoolQueueItem[] = []\n  #current: number = 0\n  #size: number = 0\n  #available: number = 0\n\n  constructor(private readonly options: PoolOptions = {}) {}\n\n  add(item: T) {\n    if (this.#items.includes(item)) throw new PoolError('Item already exists')\n    this.#size++\n    this.#available++\n    this.#items.push(item)\n    this.#free.push(true)\n  }\n\n  remove(item: T) {\n    if (this.#size === 0) throw new PoolError('Pool is empty')\n    const index = this.#items.indexOf(item)\n    if (index < 0) throw new PoolError('Item is not in the pool')\n    const isCaptured = this.isFree(item)\n    if (isCaptured) this.#available--\n    this.#size--\n    this.#current--\n    this.#items.splice(index, 1)\n    this.#free.splice(index, 1)\n  }\n\n  capture(timeout = this.options.timeout) {\n    return this.next(true, timeout)\n  }\n\n  async next(exclusive = false, timeout = this.options.timeout): Promise<T> {\n    if (this.#size === 0) throw new PoolError('Pool is empty')\n    if (this.#available === 0) {\n      return new Promise((resolve, reject) => {\n        const waiting: PoolQueueItem = {\n          resolve: (item: T) => {\n            if (exclusive) this.#capture(item)\n            resolve(item)\n          },\n          timer: undefined,\n        }\n        if (timeout) {\n          waiting.timer = setTimeout(() => {\n            waiting.resolve = undefined\n            this.#queue.shift()\n            reject(new PoolError('Next item timeout'))\n          }, timeout)\n        }\n        this.#queue.push(waiting)\n      })\n    }\n    let item: T | undefined = undefined\n    let free = false\n    do {\n      item = this.#items[this.#current]\n      free = this.#free[this.#current]\n      this.#current++\n      if (this.#current >= this.#size) this.#current = 0\n    } while (typeof item === 'undefined' || !free)\n    if (exclusive) this.#capture(item)\n    return item\n  }\n\n  release(item: T) {\n    const index = this.#items.indexOf(item)\n    if (index < 0) throw new PoolError('Unexpected item')\n    if (this.#free[index])\n      throw new PoolError('Unable to release not captured item')\n    this.#free[index] = true\n    this.#available++\n    if (this.#queue.length > 0) {\n      const { resolve, timer } = this.#queue.shift()!\n      clearTimeout(timer)\n      if (resolve) setTimeout(resolve, 0, item)\n    }\n  }\n\n  isFree(item: T) {\n    const index = this.#items.indexOf(item)\n    if (index < 0) return false\n    return this.#free[index]\n  }\n\n  get items() {\n    return [...this.#items]\n  }\n\n  #capture(item: T) {\n    const index = this.#items.indexOf(item)\n    this.#free[index] = false\n    this.#available--\n  }\n}\n"],"names":["PoolError","Error","Pool","constructor","options","add","item","includes","push","remove","index","indexOf","isCaptured","isFree","splice","capture","timeout","next","exclusive","Promise","resolve","reject","waiting","timer","undefined","setTimeout","shift","free","release","length","clearTimeout","items"],"mappings":"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"}

package/dist/lib/utils/semaphore.js

@@ -0,0 +1,52 @@
+export class SemaphoreError extends Error {
+}
+export class Semaphore {
+    size;
+    timeout;
+    counter;
+    queue;
+    constructor(concurrency, size = 0, timeout = 0){
+        this.size = size;
+        this.timeout = timeout;
+        this.queue = [];
+        this.counter = concurrency;
+    }
+    enter() {
+        if (this.counter > 0) {
+            this.counter--;
+            return Promise.resolve();
+        } else if (this.queue.length >= this.size) {
+            return Promise.reject(new SemaphoreError('Queue is full'));
+        } else {
+            return new Promise((resolve, reject)=>{
+                const waiting = {
+                    resolve
+                };
+                waiting.timer = setTimeout(()=>{
+                    waiting.resolve = undefined;
+                    this.queue.shift();
+                    reject(new SemaphoreError('Timeout'));
+                }, this.timeout);
+                this.queue.push(waiting);
+            });
+        }
+    }
+    leave() {
+        if (this.queue.length === 0) {
+            this.counter++;
+        } else {
+            const item = this.queue.shift();
+            if (item) {
+                const { resolve, timer } = item;
+                if (timer) clearTimeout(timer);
+                if (resolve) setTimeout(resolve, 0);
+            }
+        }
+    }
+    get isEmpty() {
+        return this.queue.length === 0;
+    }
+    get queueLength() {
+        return this.queue.length;
+    }
+}

package/dist/lib/utils/semaphore.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../lib/utils/semaphore.ts"],"sourcesContent":["import type { Callback } from '@nmtjs/common'\n\ninterface SemaphoreQueueItem {\n  resolve?: Callback\n  timer?: ReturnType<typeof setTimeout>\n}\n\nexport class SemaphoreError extends Error {}\n\n// Semaphore from https://github.com/metarhia/metautil\nexport class Semaphore {\n  private counter: number\n\n  private readonly queue: SemaphoreQueueItem[] = []\n\n  constructor(\n    concurrency: number,\n    private readonly size: number = 0,\n    private readonly timeout: number = 0,\n  ) {\n    this.counter = concurrency\n  }\n\n  enter(): Promise<void> {\n    if (this.counter > 0) {\n      this.counter--\n      return Promise.resolve()\n    } else if (this.queue.length >= this.size) {\n      return Promise.reject(new SemaphoreError('Queue is full'))\n    } else {\n      return new Promise((resolve, reject) => {\n        const waiting: SemaphoreQueueItem = { resolve }\n        waiting.timer = setTimeout(() => {\n          waiting.resolve = undefined\n          this.queue.shift()\n          reject(new SemaphoreError('Timeout'))\n        }, this.timeout)\n        this.queue.push(waiting)\n      })\n    }\n  }\n\n  leave() {\n    if (this.queue.length === 0) {\n      this.counter++\n    } else {\n      const item = this.queue.shift()\n      if (item) {\n        const { resolve, timer } = item\n        if (timer) clearTimeout(timer)\n        if (resolve) setTimeout(resolve, 0)\n      }\n    }\n  }\n\n  get isEmpty() {\n    return this.queue.length === 0\n  }\n\n  get queueLength() {\n    return this.queue.length\n  }\n}\n"],"names":["SemaphoreError","Error","Semaphore","counter","queue","constructor","concurrency","size","timeout","enter","Promise","resolve","length","reject","waiting","timer","setTimeout","undefined","shift","push","leave","item","clearTimeout","isEmpty","queueLength"],"mappings":"AAOA,OAAO,MAAMA,uBAAuBC;AAAO;AAG3C,OAAO,MAAMC;;;IACHC,QAAe;IAENC,MAAgC;IAEjDC,YACEC,WAAmB,EACnB,AAAiBC,OAAe,CAAC,EACjC,AAAiBC,UAAkB,CAAC,CACpC;aAFiBD,OAAAA;aACAC,UAAAA;aALFJ,QAA8B,EAAE;QAO/C,IAAI,CAACD,OAAO,GAAGG;IACjB;IAEAG,QAAuB;QACrB,IAAI,IAAI,CAACN,OAAO,GAAG,GAAG;YACpB,IAAI,CAACA,OAAO;YACZ,OAAOO,QAAQC,OAAO;QACxB,OAAO,IAAI,IAAI,CAACP,KAAK,CAACQ,MAAM,IAAI,IAAI,CAACL,IAAI,EAAE;YACzC,OAAOG,QAAQG,MAAM,CAAC,IAAIb,eAAe;QAC3C,OAAO;YACL,OAAO,IAAIU,QAAQ,CAACC,SAASE;gBAC3B,MAAMC,UAA8B;oBAAEH;gBAAQ;gBAC9CG,QAAQC,KAAK,GAAGC,WAAW;oBACzBF,QAAQH,OAAO,GAAGM;oBAClB,IAAI,CAACb,KAAK,CAACc,KAAK;oBAChBL,OAAO,IAAIb,eAAe;gBAC5B,GAAG,IAAI,CAACQ,OAAO;gBACf,IAAI,CAACJ,KAAK,CAACe,IAAI,CAACL;YAClB;QACF;IACF;IAEAM,QAAQ;QACN,IAAI,IAAI,CAAChB,KAAK,CAACQ,MAAM,KAAK,GAAG;YAC3B,IAAI,CAACT,OAAO;QACd,OAAO;YACL,MAAMkB,OAAO,IAAI,CAACjB,KAAK,CAACc,KAAK;YAC7B,IAAIG,MAAM;gBACR,MAAM,EAAEV,OAAO,EAAEI,KAAK,EAAE,GAAGM;gBAC3B,IAAIN,OAAOO,aAAaP;gBACxB,IAAIJ,SAASK,WAAWL,SAAS;YACnC;QACF;IACF;IAEA,IAAIY,UAAU;QACZ,OAAO,IAAI,CAACnB,KAAK,CAACQ,MAAM,KAAK;IAC/B;IAEA,IAAIY,cAAc;QAChB,OAAO,IAAI,CAACpB,KAAK,CAACQ,MAAM;IAC1B;AACF"}

package/index.ts

@@ -0,0 +1,11 @@
+export * from './lib/constants.ts'
+export * from './lib/types.ts'
+export * from './lib/enums.ts'
+export * from './lib/hooks.ts'
+export * from './lib/logger.ts'
+export * from './lib/registry.ts'
+export * from './lib/container.ts'
+export * from './lib/injectables.ts'
+export * from './lib/types.ts'
+export * from './lib/plugin.ts'
+export * from './lib/utils/index.ts'

package/lib/constants.ts

@@ -0,0 +1,36 @@
+import type { Plugin } from './plugin.ts'
+
+export const kOptionalDependency: unique symbol = Symbol.for(
+  'neemata:OptionalDependencyKey',
+)
+export type kOptionalDependency = typeof kOptionalDependency
+
+export const kInjectable: unique symbol = Symbol.for('neemata:InjectableKey')
+export type kInjectable = typeof kInjectable
+
+export const kLazyInjectable: unique symbol = Symbol.for(
+  'neemata:LazyInjectableKey',
+)
+export type kLazyInjectable = typeof kLazyInjectable
+
+export const kValueInjectable: unique symbol = Symbol.for(
+  'neemata:ValueInjectableKey',
+)
+export type kValueInjectable = typeof kValueInjectable
+
+export const kFactoryInjectable: unique symbol = Symbol.for(
+  'neemata:FactoryInjectableKey',
+)
+export type kFactoryInjectable = typeof kFactoryInjectable
+
+export const kProvider: unique symbol = Symbol.for('neemata:ProviderKey')
+export type kProvider = typeof kProvider
+
+export const kHookCollection: unique symbol = Symbol.for(
+  'neemata:HookCollectionKey',
+)
+export type kHookCollection = typeof kHookCollection
+
+export const kPlugin: unique symbol = Symbol.for('neemata:PluginKey')
+export type kPlugin = typeof kPlugin
+export const isPlugin = (value: any): value is Plugin => kPlugin in value