@joist/observable 2.0.0-next.1637881209.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2019-2020 Danny Blue
+
+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,120 @@
+# Di
+
+Dependency Injection in ~800 bytes. Can be used with and without decorators.
+
+#### Installation:
+
+```BASH
+npm i @joist/di
+```
+
+#### Example:
+
+```TS
+import { Injector } from '@joist/di';
+
+class FooService {
+  sayHello() {
+    return 'Hello From FooService';
+  }
+}
+
+class BarService {
+  static deps = [FooService];
+
+  constructor(private foo: FooService) {}
+
+  sayHello() {
+    return 'Hello From BarService and ' + this.foo.sayHello();
+  }
+}
+
+const app = new Injector();
+
+app.get(BarService).sayHello(); // Hello from BarService and Hello from FooService
+```
+
+```TS
+import { Injector } from '@joist/di';
+import { inject } from '@joist/di/decorators';
+
+class FooService {
+  sayHello() {
+    return 'Hello From FooService';
+  }
+}
+
+class BarService {
+  constructor(@inject(FooService) private foo: FooService) {}
+
+  sayHello() {
+    return 'Hello From BarService and ' + this.foo.sayHello();
+  }
+}
+
+const app = new Injector();
+
+app.get(BarService).sayHello(); // Hello from BarService and Hello from FooService
+```
+
+#### Override A Service:
+
+```TS
+import { Injector } from '@joist/di';
+import { inject } from '@joist/di/decorators';
+
+class FooService {
+  sayHello() {
+    return 'Hello From FooService';
+  }
+}
+
+class BarService {
+  constructor(@inject(FooService) private foo: FooService) {}
+
+  sayHello() {
+    return 'Hello From BarService and ' + this.foo.sayHello();
+  }
+}
+
+// Override FooService with an alternate implementation
+const app = new Injector({
+  providers: [
+    {
+      provide: FooService,
+      use: class extends FooService {
+        sayHello() {
+          return 'IT HAS BEEN OVERRIDEN'
+        }
+      }
+    }
+  ]
+});
+
+app.get(BarService).sayHello(); // Hello from BarService and IT HAS BEEN OVERRIDEN
+```
+
+#### Root Service
+
+If you have nested injectors and you still want singleton instances mark your service as shown or decorate with `@service()`
+
+```TS
+class FooService {
+  static providedInRoot = true;
+
+  sayHello() {
+    return 'Hello From FooService';
+  }
+}
+```
+
+```TS
+import { service } from '@joist/di/decorators';
+
+@service()
+class FooService {
+  sayHello() {
+    return 'Hello From FooService';
+  }
+}
+```

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@joist/observable",
+  "version": "2.0.0-next.1637881209.0+eb19bc3",
+  "main": "./target/build/lib.js",
+  "module": "./target/build/lib.js",
+  "exports": {
+    ".": {
+      "import": "./target/build/lib.js"
+    }
+  },
+  "files": [
+    "target/build"
+  ],
+  "sideEffects": false,
+  "description": "Dependency Injection in ~800 bytes",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deebloo/joist.git"
+  },
+  "keywords": [
+    "TypeScript",
+    "DI",
+    "Dependency Injection"
+  ],
+  "author": "deebloo",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/deebloo/joist/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "tsc -p tsconfig.test.json && wtr --config ../../wtr.config.mjs --port 8002",
+    "build": "tsc -p tsconfig.build.json"
+  },
+  "gitHead": "eb19bc349db140ab2afc163af33403135d4dda0d"
+}

package/target/build/lib/observable.d.ts

@@ -0,0 +1,25 @@
+export declare class PropChange<T = any> {
+    key: string | symbol;
+    newValue: T;
+    oldValue?: T | undefined;
+    constructor(key: string | symbol, newValue: T, oldValue?: T | undefined);
+}
+export declare type PropChanges = Record<string | symbol, PropChange>;
+export interface OnChange {
+    onChange(changes: PropChanges): void;
+}
+export declare function readPropertyDefs(c: any): Record<string | symbol, {}>;
+export interface ObservableBase {
+    propChanges: PropChanges;
+    propChange: Promise<void> | null;
+    definePropChange(propChange: PropChange): Promise<void>;
+}
+export declare function observe(): (target: any, key: string) => void;
+export declare function observable(): <T extends new (...args: any[]) => OnChange>(CustomElement: T) => {
+    new (...args: any[]): {
+        propChanges: PropChanges;
+        propChange: Promise<void> | null;
+        onChange(e: PropChanges): void;
+        definePropChange(propChange: PropChange): Promise<void>;
+    };
+} & T;

package/target/build/lib/observable.js

@@ -0,0 +1,73 @@
+export class PropChange {
+    key;
+    newValue;
+    oldValue;
+    constructor(key, newValue, oldValue) {
+        this.key = key;
+        this.newValue = newValue;
+        this.oldValue = oldValue;
+    }
+}
+export function readPropertyDefs(c) {
+    return c.properties || c.prototype.properties || {};
+}
+const PROPERTY_KEY = 'properties';
+export function observe() {
+    return function (target, key) {
+        target[PROPERTY_KEY] = target[PROPERTY_KEY] || {};
+        target[PROPERTY_KEY][key] = {};
+    };
+}
+export function observable() {
+    return (CustomElement) => {
+        const defs = readPropertyDefs(CustomElement);
+        const props = {};
+        for (let def in defs) {
+            const privateKey = createPrivateKey(def);
+            props[def] = {
+                set(val) {
+                    const prevVal = Reflect.get(this, privateKey);
+                    this.definePropChange(new PropChange(def, val, prevVal));
+                    Reflect.set(this, privateKey, val);
+                },
+                get() {
+                    return Reflect.get(this, privateKey);
+                },
+            };
+        }
+        return class ObservableElement extends CustomElement {
+            propChanges = {};
+            propChange = null;
+            constructor(...args) {
+                super(...args);
+                for (let def in defs) {
+                    Reflect.set(this, createPrivateKey(def), Reflect.get(this, def));
+                    Object.defineProperties(this, props);
+                }
+            }
+            onChange(e) {
+                if (!!super.onChange) {
+                    super.onChange(e);
+                }
+            }
+            definePropChange(propChange) {
+                this.propChanges[propChange.key] = propChange;
+                if (!this.propChange) {
+                    // If there is no previous change defined set it up
+                    this.propChange = Promise.resolve().then(() => {
+                        // run onPropChanges here. This makes sure we capture all changes
+                        this.onChange(this.propChanges);
+                        // reset for next time
+                        this.propChanges = {};
+                        this.propChange = null;
+                    });
+                }
+                return this.propChange;
+            }
+        };
+    };
+}
+function createPrivateKey(key) {
+    return `__${key}`;
+}
+//# sourceMappingURL=observable.js.map

package/target/build/lib/observable.js.map

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

package/target/build/lib.d.ts

@@ -0,0 +1 @@
+export { observable, PropChange, OnChange, observe, PropChanges } from './lib/observable';

package/target/build/lib.js

@@ -0,0 +1,2 @@
+export { observable, PropChange, observe } from './lib/observable';
+//# sourceMappingURL=lib.js.map

package/target/build/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../../lib.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAY,OAAO,EAAe,MAAM,kBAAkB,CAAC"}