@leyyo/asl 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Mustafa Yelmer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,25 @@
+# Leyyo ASL
+ASL library for Leyyo framework
+
+## Import
+- `npm i @leyyo/asl`
+
+## Standards
+- Language: `TS`
+- Eslint: `Yes`
+- Static Code Analysis: `Yes` *IntelliJ Code Inspections*
+- DDD - Document Driven: `Yes`
+- DDD - Domain Driven: `Yes`
+- EDD - Exception Driven: `Yes`
+- TDD - Test Driven: `Yes`
+- LDD - Log Driven: `Yes`
+- 12FA - 12 Factor-App: `50%` *Partially*
+
+## Dependencies
+### NO
+
+---
+### Prepared by
+- Mustafa Yelmer
+- mustafayelmer(at)gmail.com
+- `2022-01-17`

package/dist/asl-type.d.ts

@@ -0,0 +1,10 @@
+declare const literals: readonly ["http", "ws", "job", "broker", "cli", "app", "another"];
+/**
+ * ASL (Async Local Storage) Type
+ * */
+export type AslType = typeof literals[number];
+/**
+ * @type {Array<AslType>}
+ * */
+export declare const AslTypeItems: ReadonlyArray<AslType>;
+export {};

package/dist/asl-type.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AslTypeItems = void 0;
+const literals = ['http', 'ws', 'job', 'broker', 'cli', 'app', 'another'];
+/**
+ * @type {Array<AslType>}
+ * */
+exports.AslTypeItems = literals;
+//# sourceMappingURL=asl-type.js.map

package/dist/asl-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asl-type.js","sourceRoot":"","sources":["../src/asl-type.ts"],"names":[],"mappings":";;;AAAA,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAU,CAAC;AAMnF;;KAEK;AACQ,QAAA,YAAY,GAAG,QAAkC,CAAC"}

package/dist/asl.d.ts

@@ -0,0 +1,5 @@
+import type { AslLike } from "./index.types";
+/**
+ * ASL instance
+ * */
+export declare const asl: AslLike;

package/dist/asl.js

@@ -0,0 +1,352 @@
+"use strict";
+var _a, _b;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asl = void 0;
+const node_async_hooks_1 = require("node:async_hooks");
+const asl_type_1 = require("./asl-type");
+/**
+ * Safe integer limit
+ * */
+const MAX_SAFE = Number.MAX_SAFE_INTEGER - 100;
+/**
+ * Instance key
+ * */
+const ASL = Symbol.for('asl');
+/**
+ * Id key
+ * */
+const NUM = Symbol.for('num');
+/**
+ * Increment key
+ * */
+const INC = Symbol.for('inc');
+/**
+ * Build default key
+ * */
+const DEF = Symbol.for('set');
+/**
+ * Extend context key
+ * */
+const EXT = Symbol.for('ext');
+/**
+ * Run context key
+ * */
+const RUN = Symbol.for('run');
+/**
+ * Get context key
+ * */
+const GET = Symbol.for('get');
+/**
+ * Set context key
+ * */
+const SET = Symbol.for('set');
+/**
+ * ASL class
+ * */
+class Asl {
+    constructor() {
+        // region private-properties
+        /**
+         * ASL instance
+         * */
+        this[_a] = new node_async_hooks_1.AsyncLocalStorage();
+        /**
+         * Transaction id
+         *
+         * @type {number}
+         * */
+        this[_b] = 0;
+        // endregion is
+    }
+    /**
+     * Increments transaction id
+     *
+     * @return {number}
+     * */
+    get [(_a = ASL, _b = NUM, INC)]() {
+        if (this[NUM] > MAX_SAFE) {
+            this[NUM] = 0;
+        }
+        this[NUM]++;
+        return this[NUM];
+    }
+    /**
+     * Creates default context with given type
+     *
+     * @param {AslType} type
+     * @return {AslContextCore}
+     * */
+    [DEF](type) {
+        const core = {
+            id: this[INC],
+            time: new Date(),
+            type,
+        };
+        this[ASL].enterWith(core);
+        return core;
+    }
+    /**
+     * Creates default context with given type
+     *
+     * @param {AslType} type
+     * @param {AslContextEmpty} data
+     * */
+    [SET](type, data) {
+        this[ASL].enterWith(Object.assign({ id: this[INC], time: new Date(), type }, data));
+    }
+    /**
+     * Extends context with getters
+     *
+     * @param {AslContextCore} core
+     * @return {AslContext}
+     * */
+    [EXT](core) {
+        const { type } = core;
+        return Object.assign(Object.assign({}, core), { 
+            // region get data
+            get another() {
+                return type === 'another' ? core : undefined;
+            },
+            get application() {
+                return type === 'app' ? core : undefined;
+            },
+            get broker() {
+                return type === 'broker' ? core : undefined;
+            },
+            get cli() {
+                return type === 'cli' ? core : undefined;
+            },
+            get http() {
+                return type === 'http' ? core : undefined;
+            },
+            get job() {
+                return type === 'job' ? core : undefined;
+            },
+            get webSocket() {
+                return type === 'ws' ? core : undefined;
+            },
+            // endregion get data
+            // region any
+            any(...possibleTypes) {
+                return possibleTypes.includes(core.type);
+            },
+            // endregion any
+            // region is
+            get isNone() {
+                return !type || !asl_type_1.AslTypeItems.includes(type);
+            },
+            get isAnother() {
+                return type === 'another';
+            },
+            get isApplication() {
+                return type === 'app';
+            },
+            get isBroker() {
+                return type === 'broker';
+            },
+            get isCli() {
+                return type === 'cli';
+            },
+            get isHttp() {
+                return type === 'http';
+            },
+            get isJob() {
+                return type === 'job';
+            },
+            get isWebSocket() {
+                return type === 'ws';
+            } });
+    }
+    /**
+     * Creates new context
+     *
+     * @param {AslType} type
+     * @param {function} next
+     * @param {AslContextEmpty} data
+     * */
+    [RUN](type, next, data) {
+        const ctx = Object.assign({ id: this[INC], time: new Date(), type }, (data !== null && data !== void 0 ? data : {}));
+        this[ASL].run(ctx, () => {
+            try {
+                next();
+            }
+            catch (e) {
+                console.warn(`${ctx.time.toISOString()} - Asl error [${type}] <${e.name}> ${e.message}`);
+            }
+        });
+    }
+    /**
+     * Returns new context
+     *
+     * @param {AslType} type
+     * @return {AslContextCore}
+     * */
+    [GET](type) {
+        const value = this[ASL].getStore();
+        if (value) {
+            return value;
+        }
+        return this[DEF](type);
+    }
+    // endregion private-properties
+    // region from
+    /** @inheritDoc */
+    $fromAnother(another, next) {
+        this[RUN]('another', next, another);
+    }
+    /** @inheritDoc */
+    $setForAnother(another) {
+        this[SET]('another', another);
+    }
+    /** @inheritDoc */
+    $fromApplication(app, next) {
+        this[RUN]('app', next, app);
+    }
+    /** @inheritDoc */
+    $setForApplication(app) {
+        this[SET]('app', app);
+    }
+    /** @inheritDoc */
+    $fromBroker(broker, next) {
+        this[RUN]('broker', next, broker);
+    }
+    /** @inheritDoc */
+    $setForBroker(broker) {
+        this[SET]('broker', broker);
+    }
+    /** @inheritDoc */
+    $fromCli(cli, next) {
+        this[RUN]('cli', next, cli);
+    }
+    /** @inheritDoc */
+    $setForCli(cli) {
+        this[SET]('cli', cli);
+    }
+    /** @inheritDoc */
+    $fromHttp(http, next) {
+        this[RUN]('http', next, http);
+    }
+    /** @inheritDoc */
+    $setForHttp(http) {
+        this[SET]('http', http);
+    }
+    /** @inheritDoc */
+    $fromJob(job, next) {
+        this[RUN]('job', next, job);
+    }
+    /** @inheritDoc */
+    $setForJob(job) {
+        this[SET]('job', job);
+    }
+    /** @inheritDoc */
+    $fromWs(ws, next) {
+        this[RUN]('ws', next, ws);
+    }
+    /** @inheritDoc */
+    $setForWs(ws) {
+        this[SET]('ws', ws);
+    }
+    /** @inheritDoc */
+    $httpMiddleware(req, _res, next) {
+        this[RUN]('http', next, { req });
+    }
+    // endregion from
+    // region cast
+    /** @inheritDoc */
+    as() {
+        return this;
+    }
+    // endregion cast
+    // region context
+    /** @inheritDoc */
+    get ctx() {
+        return this[EXT](this[GET](undefined));
+    }
+    /** @inheritDoc */
+    ctxDef(def) {
+        return this[EXT](this[GET](def));
+    }
+    // endregion context
+    // region short-get
+    /** @inheritDoc */
+    get another() {
+        const core = this[GET](undefined);
+        return core.type === 'another' ? core : undefined;
+    }
+    /** @inheritDoc */
+    get application() {
+        const core = this[GET](undefined);
+        return core.type === 'app' ? core : undefined;
+    }
+    /** @inheritDoc */
+    get broker() {
+        const core = this[GET](undefined);
+        return core.type === 'broker' ? core : undefined;
+    }
+    /** @inheritDoc */
+    get cli() {
+        const core = this[GET](undefined);
+        return core.type === 'cli' ? core : undefined;
+    }
+    /** @inheritDoc */
+    get http() {
+        const core = this[GET](undefined);
+        return core.type === 'http' ? core : undefined;
+    }
+    /** @inheritDoc */
+    get job() {
+        const core = this[GET](undefined);
+        return core.type === 'job' ? core : undefined;
+    }
+    /** @inheritDoc */
+    get webSocket() {
+        const core = this[GET](undefined);
+        return core.type === 'ws' ? core : undefined;
+    }
+    // endregion short-get
+    // region any
+    /** @inheritDoc */
+    any(...possibleTypes) {
+        return possibleTypes.includes(this[GET](undefined).type);
+    }
+    // endregion any
+    // region is
+    /** @inheritDoc */
+    get isNone() {
+        const type = this[GET](undefined).type;
+        return !type || !asl_type_1.AslTypeItems.includes(type);
+    }
+    /** @inheritDoc */
+    get isAnother() {
+        return this[GET](undefined).type === 'another';
+    }
+    /** @inheritDoc */
+    get isApplication() {
+        return this[GET](undefined).type === 'app';
+    }
+    /** @inheritDoc */
+    get isBroker() {
+        return this[GET](undefined).type === 'broker';
+    }
+    /** @inheritDoc */
+    get isCli() {
+        return this[GET](undefined).type === 'cli';
+    }
+    /** @inheritDoc */
+    get isHttp() {
+        return this[GET](undefined).type === 'http';
+    }
+    /** @inheritDoc */
+    get isJob() {
+        return this[GET](undefined).type === 'job';
+    }
+    /** @inheritDoc */
+    get isWebSocket() {
+        return this[GET](undefined).type === 'ws';
+    }
+}
+/**
+ * ASL instance
+ * */
+exports.asl = new Asl();
+//# sourceMappingURL=asl.js.map

package/dist/asl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asl.js","sourceRoot":"","sources":["../src/asl.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './asl-type';
+export * from './index.types';
+export * from './asl';

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./asl-type"), exports);
+__exportStar(require("./index.types"), exports);
+__exportStar(require("./asl"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,gDAA8B;AAC9B,wCAAsB"}

package/dist/index.types.d.ts

@@ -0,0 +1,423 @@
+import type { NextFunction, Request } from "express";
+import type { AslType } from "./asl-type";
+/**
+ * Core value interface, it's stored in `AsyncLocalStorage`
+ * */
+export interface AslContextCore {
+    /**
+     * Incremental transaction id
+     * - It's refreshed when it reaches to limit
+     *
+     * @type {number} - integer
+     * */
+    readonly id: number;
+    /**
+     * Time of transaction
+     *
+     * @type {Date}
+     * */
+    readonly time: Date;
+    /**
+     * Type of transaction
+     *
+     * @type {AslType}
+     * */
+    readonly type: AslType;
+    /**
+     * Other extra parameters by your requirements
+     *
+     * @type {any}
+     * */
+    [key: string]: unknown;
+}
+/**
+ * Runtime interface, it holds getters
+ *
+ * Generics:
+ * - X: `another` (your custom) context, def: `{}`
+ * - H: `http` context, def: `{req}`
+ * - W: `web socket` context, def: `{req}`
+ * - J: `job` context, def: `{name}`
+ * - B: `broker` context, def: `{topic}`
+ * - C: `cli` context, def: `{}`
+ * - A: `application` context, def: `{}`
+ * */
+interface AslContextExtended<X extends AslContextAnother = AslContextAnother, H extends AslContextHttp = AslContextHttp, W extends AslContextWs = AslContextWs, J extends AslContextJob = AslContextJob, B extends AslContextBroker = AslContextBroker, C extends AslContextCli = AslContextCli, A extends AslContextApp = AslContextApp> {
+    /**
+     * Is type of context in given types
+     *
+     * @param {...Array<AslType>} possibleTypes - variadic possible types
+     * @return {boolean}
+     * */
+    any(...possibleTypes: Array<AslType>): boolean;
+    /**
+     * Is none?
+     * - Means, there is no any valid context
+     *
+     * @return {boolean}
+     * */
+    get isNone(): boolean;
+    /**
+     * Is http context?
+     *
+     * @return {boolean}
+     * */
+    get isHttp(): boolean;
+    /**
+     * Get http context
+     * - if type === 'http' then return context
+     * - else return `undefined`
+     *
+     * @return {(AslContextCore & Record)}
+     * */
+    get http(): AslContextCore & H;
+    /**
+     * Is web socket context?
+     *
+     * @return {boolean}
+     * */
+    get isWebSocket(): boolean;
+    /**
+     * Get web socket context
+     * - if type === 'ws' then return context
+     * - else return `undefined`
+     *
+     * @return {(AslContextCore & Record)}
+     * */
+    get webSocket(): AslContextCore & W;
+    /**
+     * Is job (scheduler, task, cron) context?
+     *
+     * @return {boolean}
+     * */
+    get isJob(): boolean;
+    /**
+     * Get job context
+     * - if type === 'job' then return context
+     * - else return `undefined`
+     *
+     * @return {(AslContextCore & Record)}
+     * */
+    get job(): AslContextCore & J;
+    /**
+     * Is broker (queue, pubsub, event, ...) context?
+     *
+     * @return {boolean}
+     * */
+    get isBroker(): boolean;
+    /**
+     * Get Http context
+     * - if type === 'broker' then return context
+     * - else return `undefined`
+     *
+     * @return {(AslContextCore & Record)}
+     * */
+    get broker(): AslContextCore & B;
+    /**
+     * Is CLI (console app) context?
+     *
+     * @return {boolean}
+     * */
+    get isCli(): boolean;
+    /**
+     * Get Http context
+     * - if type === 'cli' then return context
+     * - else return `undefined`
+     *
+     * @return {(AslContextCore & Record)}
+     * */
+    get cli(): AslContextCore & C;
+    /**
+     * Is application context?
+     *
+     * @return {boolean}
+     * */
+    get isApplication(): boolean;
+    /**
+     * Get Http context
+     * - if type === 'app' then return context
+     * - else return `undefined`
+     *
+     * @return {(AslContextCore & Record)}
+     * */
+    get application(): AslContextCore & A;
+    /**
+     * Is another context?
+     *
+     * - Another means: your custom type
+     *
+     * @return {boolean}
+     * */
+    get isAnother(): boolean;
+    /**
+     * Get Http context
+     * - if type === 'another' then return context
+     * - else return `undefined`
+     *
+     * @return {(AslContextCore & Record)}
+     * */
+    get another(): AslContextCore & X;
+}
+/**
+ * Context interface
+ * you can override it by using `asl.as()`
+ *
+ * ```typescript
+ * interface X extends AslContextAnother {tenantId: string, correlation: string, region: string}
+ * interface H extends AslContextHttp {tenantId: string}
+ * interface W extends AslContextWs {tenantId: string}
+ * interface J extends AslContextJob {cron: string, tenantId: string}
+ * interface B extends AslContextBroker {channel: string, tenantId: string}
+ * interface C extends AslContextCli {user: string}
+ * interface C extends AslContextApp {ip: string}
+ * const myAsl = asl.as<X, H, W, J, B, C, A>();
+ * ```
+ *
+ * - Then you can use myAsl, it's identical with asl,
+ * - but casting is so different according to your usage
+ *
+ * ```
+ * // if http
+ * myAsl.http.tenantId
+ *
+ * // if broker
+ * myAsl.broker.channel
+ * ```
+ *
+ * Generics:
+ * - H: `http` context, def: `{req}`
+ * - W: `web socket` context, def: `{req}`
+ * - J: `job` context, def: `{name}`
+ * - B: `broker` context, def: `{topic}`
+ * - C: `cli` context, def: `{}`
+ * - A: `application` context, def: `{}`
+ * */
+export interface AslContext<X extends AslContextAnother = AslContextAnother, H extends AslContextHttp = AslContextHttp, W extends AslContextWs = AslContextWs, J extends AslContextJob = AslContextJob, B extends AslContextBroker = AslContextBroker, C extends AslContextCli = AslContextCli, A extends AslContextApp = AslContextApp> extends AslContextCore, AslContextExtended<X, H, W, J, B, C, A> {
+}
+/**
+ * Context empty interface
+ * */
+export interface AslContextEmpty {
+}
+/**
+ * Context base interface
+ *
+ * Note: request object will be created for all types
+ * */
+export interface AslContextBase {
+    /**
+     * Request object
+     *
+     * @type {Request}
+     * */
+    readonly req?: Request;
+}
+/**
+ * Context http interface
+ * */
+export interface AslContextHttp extends AslContextBase {
+}
+/**
+ * Context web socket interface
+ * */
+export interface AslContextWs extends AslContextBase {
+}
+/**
+ * Context job interface
+ * */
+export interface AslContextJob extends AslContextBase {
+    /**
+     * Job name or class name
+     *
+     * @type {string}
+     * */
+    readonly name: string;
+}
+/**
+ * Context broker interface
+ * */
+export interface AslContextBroker extends AslContextBase {
+    /**
+     * Topic or channel name, or concatenated style
+     *
+     * @type {string}
+     * */
+    topic: string;
+}
+/**
+ * Context cli interface
+ * */
+export interface AslContextCli extends AslContextBase {
+}
+/**
+ * Context application interface
+ * */
+export interface AslContextApp extends AslContextBase {
+}
+/**
+ * Context another interface
+ * */
+export interface AslContextAnother extends AslContextBase {
+}
+/**
+ * Context next function
+ * */
+export type AslNextFunction = () => void;
+/**
+ * Asl interface
+ *
+ * Generics:
+ * - H: `http` context, def: `{req}`
+ * - W: `web socket` context, def: `{req}`
+ * - J: `job` context, def: `{name}`
+ * - B: `broker` context, def: `{topic}`
+ * - C: `cli` context, def: `{}`
+ * - A: `application` context, def: `{}`
+ * */
+export interface AslLike<X extends AslContextAnother = AslContextAnother, H extends AslContextHttp = AslContextHttp, W extends AslContextWs = AslContextWs, J extends AslContextJob = AslContextJob, B extends AslContextBroker = AslContextBroker, C extends AslContextCli = AslContextCli, A extends AslContextApp = AslContextApp> extends AslContextExtended<X, H, W, J, B, C, A> {
+    /**
+     * Casts a typed asl with your interfaces
+     * */
+    as<X2 extends AslContextAnother = X, H2 extends AslContextHttp = H, W2 extends AslContextWs = W, J2 extends AslContextJob = J, B2 extends AslContextBroker = B, C2 extends AslContextCli = C, A2 extends AslContextApp = A>(): AslLike<X2, H2, W2, J2, B2, C2, A2>;
+    /**
+     * Return current context
+     *
+     * - It will return any time even if there is no context
+     * */
+    get ctx(): AslContext<X, H, W, J, B, C, A>;
+    /**
+     * Return current context with default type when it does not exist
+     *
+     * - It will return any time even if there is no context
+     * */
+    ctxDef(def: AslType): AslContext<X, H, W, J, B, C, A>;
+    /**
+     * Http middleware
+     * - When: You need to apply it in your app, ie: `app.use(...)`
+     *
+     * - It supports only `express`
+     * */
+    $httpMiddleware(req: Request, _res: unknown, next: NextFunction): void;
+    /**
+     * You can start `http` asl, with core data and next function
+     *
+     * - Note: Normally {@link $httpMiddleware} should be enough,
+     *   and you don't need to use it
+     *
+     * @param {Record} http - http data, like {req, res}
+     * @param {function} next - a basic call back to go on
+     * */
+    $fromHttp(http: H, next: AslNextFunction): void;
+    /**
+     * Set custom `http` context
+     *
+     * @param {Record} http
+     *
+     * It calls {@link AsyncLocalStorage#enterWith}
+     * */
+    $setForHttp(http: H): void;
+    /**
+     * You can start `web socket` asl, with core data and next function
+     *
+     * - Note: Normally {@link $httpMiddleware} should be enough,
+     *   and you don't need to use it
+     *
+     * @param {Record} ws - ws data, like {req}
+     * @param {function} next - a basic call back to go on
+     * */
+    $fromWs(ws: W, next: AslNextFunction): void;
+    /**
+     * Set custom `ws` context
+     *
+     * @param {Record} ws
+     *
+     * It calls {@link AsyncLocalStorage#enterWith}
+     * */
+    $setForWs(ws: W): void;
+    /**
+     * You can start `job` asl, with core data and next function
+     *
+     * - When: cron starts
+     *
+     * @param {Record} job - job data, like {name}
+     * @param {function} next - a basic call back to go on
+     * */
+    $fromJob(job: J, next: AslNextFunction): void;
+    /**
+     * Set custom `job` context
+     *
+     * @param {Record} job
+     *
+     * It calls {@link AsyncLocalStorage#enterWith}
+     * */
+    $setForJob(job: J): void;
+    /**
+     * You can start `broker` asl, with core data and next function
+     *
+     * - When: broker receives a new event
+     *
+     * @param {Record} broker - broker data, like {topic, channel}
+     * @param {function} next - a basic call back to go on
+     * */
+    $fromBroker(broker: B, next: AslNextFunction): void;
+    /**
+     * Set custom `broker` context
+     *
+     * @param {Record} broker
+     *
+     * It calls {@link AsyncLocalStorage#enterWith}
+     * */
+    $setForBroker(broker: B): void;
+    /**
+     * You can start `cli` asl, with core data and next function
+     *
+     * - When: use types new command
+     *
+     * @param {Record} cli - ws data, like {user, command}
+     * @param {function} next - a basic call back to go on
+     * */
+    $fromCli(cli: C, next: AslNextFunction): void;
+    /**
+     * Set custom `cli` context
+     *
+     * @param {Record} cli
+     *
+     * It calls {@link AsyncLocalStorage#enterWith}
+     * */
+    $setForCli(cli: C): void;
+    /**
+     * You can start `application` asl, with core data and next function
+     *
+     * - When: application starts
+     *
+     * @param {Record} app - ws data, like {name}
+     * @param {function} next - a basic call back to go on
+     * */
+    $fromApplication(app: A, next: AslNextFunction): void;
+    /**
+     * Set custom `app` context
+     *
+     * @param {Record} app
+     *
+     * It calls {@link AsyncLocalStorage#enterWith}
+     * */
+    $setForApplication(app: A): void;
+    /**
+     * You can start `another` asl, with core data and next function
+     *
+     * - When: it based on your choice
+     *
+     * @param {Record} another - ws data, like {tenantId}
+     * @param {function} next - a basic call back to go on
+     * */
+    $fromAnother(another: X, next: AslNextFunction): void;
+    /**
+     * Set custom `another` context
+     *
+     * @param {Record} another
+     *
+     * It calls {@link AsyncLocalStorage#enterWith}
+     * */
+    $setForAnother(another: X): void;
+}
+export {};

package/dist/index.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.types.js.map

package/dist/index.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.types.js","sourceRoot":"","sources":["../src/index.types.ts"],"names":[],"mappings":""}

package/dist/internal.d.ts

@@ -0,0 +1 @@
+export declare const FQN = "leyyo.asl";

package/dist/internal.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FQN = void 0;
+// noinspection JSUnusedGlobalSymbols
+exports.FQN = 'leyyo.asl';
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":";;;AAAA,qCAAqC;AACxB,QAAA,GAAG,GAAG,WAAW,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@leyyo/asl",
+  "version": "1.0.1",
+  "description": "ASL library",
+  "keywords": [
+    "ASL",
+    "async local storage",
+    "async hooks"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/leyyonet/asl.git"
+  },
+  "bugs": {
+    "url": "https://github.com/leyyonet/asl.git/issues",
+    "email": "mustafayelmer@gmail.com"
+  },
+  "homepage": "https://github.com/leyyonet/asl.git/#readme",
+  "author": "Mustafa Yelmer <mustafayelmer@gmail.com>",
+  "main": "dist/index.js",
+  "type": "commonjs",
+  "scripts": {
+    "clear": "rimraf dist",
+    "lint": "eslint src/**/*.ts",
+    "asset": "node -r ts-node/register commands/assets.ts",
+    "build": "npm run clear && tsc && npm run asset",
+    "test": "jest --config=jest.json --verbose",
+    "test:watch": "jest --watch --config=jest.json",
+    "test:coverage": "jest --config=jest.json --coverage --coverageDirectory=coverage",
+    "~publish": "npm run build && npm publish -access=public"
+  },
+  "files": [
+    "dist/*"
+  ],
+  "license": "ISC",
+  "devDependencies": {
+    "@babel/preset-typescript": "^7.27.0",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.14.0",
+    "@typescript-eslint/eslint-plugin": "^8.29.0",
+    "@typescript-eslint/parser": "^8.29.0",
+    "eslint": "^9.23.0",
+    "eslint-config-prettier": "^10.1.1",
+    "eslint-plugin-jsdoc": "^50.6.9",
+    "eslint-plugin-node": "^11.1.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.5.3",
+    "rimraf": "^6.0.1",
+    "ts-jest": "^29.3.1",
+    "ts-node": "^10.8.1",
+    "typescript": "^5.7.3"
+  },
+  "dependencies": {
+    "@types/express": "^5.0.6"
+  }
+}