include node_modules so release .zip is deployable

This commit is contained in:
2023-11-24 17:44:25 -05:00
parent 6c86cfe5d2
commit 8b11c41267
8963 changed files with 874175 additions and 1 deletions
+63
View File
@@ -0,0 +1,63 @@
/**
* @packageDocumentation
* @module std.base
*/
/**
* Common interface for lockable mutex.
*
* @author Jeongho Nam - https://github.com/samchon
*/
export interface ILockable {
/**
* Locks the mutex.
*
* Monopolies a mutex until be {@link unlock unlocked}. If there're someone who have already
* {@link lock monopolied} the mutex, the function call would be blocked until all of them to
* return their acquistions by calling the {@link unlock} method.
*
* In same reason, if you don't call the {@link unlock} function after your business, the
* others who want to {@link lock monopoly} the mutex would be fall into the forever sleep.
* Therefore, never forget to calling the {@link unlock} function or utilize the
* {@link UniqueLock.lock} function instead to ensure the safety.
*/
lock(): Promise<void>;
/**
* Tries to lock the mutex.
*
* Attempts to monopoly a mutex without blocking. If succeeded to monopoly the mutex
* immediately, it returns `true` directly. Otherwise there's someone who has already
* {@link lock monopolied} the mutex, the function gives up the trial immediately and returns
* `false` directly.
*
* Note that, if you succeeded to monopoly the mutex (returns `true`) but do not call the
* {@link unlock} function after your business, the others who want to {@link lock monopoly}
* the mutex would be fall into the forever sleep. Therefore, never forget to calling the
* {@link unlock} function or utilize the {@link UniqueLock.try_lock} function instead to
* ensure the safety.
*
* @return Whether succeeded to monopoly the mutex or not.
*/
try_lock(): Promise<boolean>;
/**
* Unlocks the mutex.
*
* When you call this {@link unlock} method and there're someone who are currently blocked by
* attempting to {@link lock} this mutex, one of them (FIFO; first-in-first-out) would acquire
* the lock and continues its execution.
*
* Otherwise, there's not anyone who is acquiring the {@link lock} of this mutex, the
* {@link DomainError} exception would be thrown.
*
* > As you know, when you succeeded to acquire the `lock`, you don't have to forget to
* > calling this {@link unlock} method after your business. If you forget it, it would be a
* > terrible situation for the others who're attempting to lock this mutex.
* >
* > However, if you utilize the {@link UniqueLock}, you don't need to consider about this
* > {@link unlock} method. Just define your business into a callback function as a parameter
* > of methods of the {@link UniqueLock}, then this {@link unlock} method would be
* > automatically called by the {@link UniqueLock} after the business.
*
* @throw {@link DomainError} when no one is acquiring the {@link lock write lock}.
*/
unlock(): Promise<void>;
}