@leyyo/proxy 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,31 @@
+# Leyyo: Proxy
+Proxy library for Leyyo framework
+
+## Import
+- `npm i @leyyo/proxy`
+
+## Usage (Runtime)
+
+## Test Cases
+| Test Case | Error          | Message                                                   | Method                               |
+|-----------|----------------|-----------------------------------------------------------|--------------------------------------|
+
+## 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-07-08`

package/dist/index.const.d.ts

@@ -0,0 +1 @@
+export declare const KEY_PROXY_LINK: unique symbol;

package/dist/index.const.js

@@ -0,0 +1 @@
+export const KEY_PROXY_LINK = Symbol.for('leyyo::proxy:link');

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './index.const.js';
+export * from './index.types.js';
+export * from './proxy.handler.js';
+export * from './index.loader.js';
+export * from './index.foretell.js';

package/dist/index.foretell.d.ts

@@ -0,0 +1 @@
+export declare const foretell_leyyoProxy: (() => void)[];

package/dist/index.foretell.js

@@ -0,0 +1,5 @@
+import { foretell_leyyoCommon } from "@leyyo/common";
+// noinspection JSUnusedGlobalSymbols
+export const foretell_leyyoProxy = [
+    ...foretell_leyyoCommon,
+];

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from './index.const.js';
+export * from './index.types.js';
+export * from './proxy.handler.js';
+export * from './index.loader.js';
+export * from './index.foretell.js';

package/dist/index.loader.d.ts

@@ -0,0 +1 @@
+export declare const loader_leyyoProxy: import("@leyyo/common").LoaderLike;

package/dist/index.loader.js

@@ -0,0 +1,7 @@
+import { defineLoader } from "@leyyo/common";
+import { FQN } from "./internal.js";
+import { loader_leyyoCommon } from "@leyyo/common";
+// noinspection JSUnusedGlobalSymbols
+export const loader_leyyoProxy = defineLoader(FQN, ...loader_leyyoCommon, 
+// instances
+() => import('./proxy.handler.js').then(m => m.proxyHandler));

package/dist/index.types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Proxy handler
+ * */
+export interface ProxyHandlerLike {
+    /**
+     * Returns proxied, if it's not proxied then returns self
+     *
+     * Generics:
+     * - `S`: type of source
+     *
+     * @param {any} source
+     * @param {symbol} type
+     * @param {boolean?} ignoreIfAbsent
+     * @return {any}
+     * */
+    get<S>(source: S, type: symbol, ignoreIfAbsent?: boolean): S;
+    /**
+     * Source is proxied or not?
+     *
+     * Generics:
+     * - `S`: type of source
+     *
+     * @param {any} source
+     * @param {symbol} type
+     * @return {boolean}
+     * */
+    has<S>(source: S, type: symbol): boolean;
+    /**
+     * Returns all types of proxies
+     *
+     * Generics:
+     * - `S`: type of source
+     *
+     * @param {any} source
+     * @param {boolean?} ignoreIfAbsent
+     * @return {Map<symbol, any>}
+     * */
+    getAll<S>(source: S, ignoreIfAbsent?: boolean): Map<symbol, any>;
+    /**
+     * Sets proxy, it means that source -> target
+     *
+     * Generics:
+     * - `S`: type of source
+     *
+     * @param {any} source
+     * @param {any} target
+     * @param {symbol} type
+     * @return {boolean}
+     * */
+    set<S>(source: S, target: S, type: symbol): boolean;
+    /**
+     * Returns `inherited by` or `successor` or `descendant`
+     * - if it is not inherited by (no successor, no descendant) then returns self
+     *
+     * Generics:
+     * - `S`: type of source
+     *
+     * @param {any} source
+     * @return {any}
+     * */
+    getInheritedBy<S>(source: S): S;
+    /**
+     * has source `inherited by` or `successor`
+     *
+     * Generics:
+     * - `S`: type of source
+     *
+     * @param {any} source
+     * @return {boolean}
+     * */
+    hasInheritedBy<S>(source: S): boolean;
+    /**
+     * Sets `inherited by` or `successor`
+     *
+     * Generics:
+     * - `S`: type of source
+     *
+     * @param {any} source
+     * @param {any} target
+     * @return {boolean}
+     * */
+    setInheritedBy<S>(source: S, target: S): boolean;
+    /**
+     * Returns `inherits` or `predecessor` or `ancestor`
+     * - if it does not inherit (no predecessor, no ancestor) then returns self
+     *
+     * Generics:
+     * - `S`: type of source
+     *
+     * @param {any} source
+     * @return {any}
+     * */
+    getInherits<S>(source: S): S;
+    /**
+     * has source `inherits` or `predecessor`
+     * *
+     * Generics:
+     * - `S`: type of source
+     *
+     * @param {any} source
+     * @return {boolean}
+     * */
+    hasInherits<S>(source: S): boolean;
+    /**
+     * Sets `inherits` or `predecessor`
+     *
+     * Generics:
+     * - `S`: type of source
+     *
+     * @param {any} source
+     * @param {any} target
+     * @return {boolean}
+     * */
+    setInherits<S>(source: S, target: S): boolean;
+}

package/dist/index.types.js

@@ -0,0 +1 @@
+export {};

package/dist/internal.d.ts

@@ -0,0 +1 @@
+export declare const NME: string, FQN: string, VER: string, CNF: import("@leyyo/common").LeyyoConfig;

package/dist/internal.js

@@ -0,0 +1,2 @@
+import { sysAll } from "@leyyo/common";
+export const { pck: { name: NME, fqn: FQN, version: VER }, config: CNF } = sysAll(import.meta.url);

package/dist/proxy.handler.d.ts

@@ -0,0 +1,5 @@
+import { ProxyHandlerLike } from "./index.types.js";
+/**
+ * Proxy handler instance
+ * */
+export declare const proxyHandler: ProxyHandlerLike;

package/dist/proxy.handler.js

@@ -0,0 +1,70 @@
+import { FQN } from "./internal.js";
+import { getProp, setFqn, setProp } from "@leyyo/common";
+import { KEY_PROXY_LINK } from "./index.const.js";
+const INHERITS = Symbol.for('leyyo::proxy:inherits');
+const INHERITED_BY = Symbol.for('leyyo::proxy:inherited-by');
+class ProxyHandler {
+    // region general
+    /** @inheritDoc */
+    get(source, type, ignoreIfAbsent) {
+        const map = this.getAll(source, ignoreIfAbsent);
+        return map ? map.get(type) : undefined;
+    }
+    /** @inheritDoc */
+    has(source, type) {
+        return this.getAll(source)?.has(type);
+    }
+    /** @inheritDoc */
+    getAll(source, ignoreIfAbsent) {
+        let map = getProp(source, KEY_PROXY_LINK);
+        if (map && map instanceof Map) {
+            return map;
+        }
+        if (ignoreIfAbsent) {
+            return undefined;
+        }
+        map = new Map();
+        setProp(source, KEY_PROXY_LINK, map);
+        return map;
+    }
+    /** @inheritDoc */
+    set(source, target, type) {
+        const map = this.getAll(source);
+        const exists = map.has(type);
+        map.set(type, target);
+        return exists;
+    }
+    // endregion general
+    // region inherited-by
+    /** @inheritDoc */
+    getInheritedBy(source) {
+        return this.get(source, INHERITED_BY, true) ?? source;
+    }
+    /** @inheritDoc */
+    hasInheritedBy(source) {
+        return this.has(source, INHERITED_BY);
+    }
+    /** @inheritDoc */
+    setInheritedBy(source, target) {
+        return this.set(source, target, INHERITED_BY);
+    }
+    // endregion inherited-by
+    // region inherits
+    /** @inheritDoc */
+    getInherits(source) {
+        return this.get(source, INHERITS, true) ?? source;
+    }
+    /** @inheritDoc */
+    hasInherits(source) {
+        return this.has(source, INHERITS);
+    }
+    /** @inheritDoc */
+    setInherits(source, target) {
+        return this.set(source, target, INHERITS);
+    }
+}
+/**
+ * Proxy handler instance
+ * */
+export const proxyHandler = new ProxyHandler();
+setFqn(ProxyHandler, FQN);

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@leyyo/proxy",
+  "version": "1.0.1",
+  "description": "Leyyo proxy library",
+  "keywords": [
+    "proxy"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/leyyonet/proxy.git"
+  },
+  "bugs": {
+    "url": "https://github.com/leyyonet/proxy.git/issues",
+    "email": "mustafayelmer@gmail.com"
+  },
+  "homepage": "https://github.com/leyyonet/proxy.git/#readme",
+  "author": "Mustafa Yelmer <mustafayelmer@gmail.com>",
+  "main": "dist/index.js",
+  "type": "module",
+  "scripts": {
+    "clear": "rimraf dist",
+    "lint": "eslint src/**/*.ts",
+    "asset": "node -r ts-node/register commands/assets.js",
+    "build": "npm run clear && tsc && npm run asset",
+    "test": "npx jest --config=jest.json --clearCache && npx 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-env": "^7.29.0",
+    "@babel/preset-typescript": "^7.27.0",
+    "@eslint/js": "^9.33.0",
+    "@jest/globals": "^29.7.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.2.1",
+    "@typescript-eslint/eslint-plugin": "^8.39.1",
+    "@typescript-eslint/parser": "^8.39.1",
+    "eslint": "^9.33.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-config-standard": "^17.1.0",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-jsdoc": "^54.0.0",
+    "eslint-plugin-node": "^11.1.0",
+    "husky": "^9.1.7",
+    "jest": "^29.7.0",
+    "prettier": "^3.6.2",
+    "rimraf": "^6.0.1",
+    "test": "^3.3.0",
+    "ts-jest": "^29.4.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.39.1"
+  },
+  "overrides": {
+    "eslint-config-standard": {
+      "eslint": "^9.33.0"
+    }
+  },
+  "dependencies": {
+    "@leyyo/common": "^1.3.16"
+  }
+}