@armscye/hooks 0.5.0 → 0.7.0

package/README.md

@@ -1,6 +1,6 @@
 # @armscye/hooks
 
-> A collection of shared standard TypeScript definitions.
+> A collection of shared standard TypeScript definitions (@hooks).
 
 ## Installation
 
@@ -15,3 +15,75 @@ or using yarn:
 ```sh
 yarn add @armscye/hooks --dev
 ```
+
+## Reference
+
+### ShutdownHook `Interface`
+
+Interface defining method to respond to system signals (when application gets shutdown by, e.g., `SIGTERM`).
+
+```ts
+interface ShutdownHook {
+  onShutdown(signal?: string): any;
+}
+```
+
+The `onShutdown` method is called when an application receives a system signal indicating it's time to gracefully shutdown. Common signals include `SIGTERM` (termination request) and `SIGINT` (interrupt).
+
+The optional `signal` parameter might be provided, revealing the specific signal received.
+
+**Usage notes**
+
+Here's a basic example demonstrating how to use `ShutdownHook` to close a database connection:
+
+```ts
+class MyShutdownHook implements ShutdownHook {
+  onShutdown(signal?: string) {
+    // Access and close database connection
+    const db = /* get database connection */;
+    db.close()
+      .then(() => console.log("Database connection closed"))
+      .catch(error => console.error("Error closing database:", error));
+  }
+}
+```
+
+### StartupHook `Interface`
+
+Interface defining method called during the application startup.
+
+```ts
+interface StartupHook {
+  onStartup(): any;
+}
+```
+
+The `onStartup` method is called before the application begins listening for incoming connections.
+
+**Usage notes**
+
+Here's a basic example demonstrating how to use a `StartupHook` to connect to a database:
+
+```ts
+class MyStartupHook implements StartupHook {
+  onStartup() {
+    // Connect to the database
+    database.connect();
+    console.log('Database connection established.');
+  }
+}
+```
+
+### HookProvider `Type`
+
+Describes type structure for hooks.
+
+```ts
+type HookProvider = string | symbol | object | Type<any> | Function;
+```
+
+## License
+
+This project is licensed under the **MIT license**.
+
+See [LICENSE](LICENSE) for more information.

package/dist/hook-provider.d.ts

@@ -1,2 +1,2 @@
 import { Type } from '@armscye/core';
-export type HookProvider<T = any> = string | symbol | object | Type<T> | Function;
+export type HookProvider = string | symbol | object | Type<any> | Function;

package/dist/shutdown-hook.d.ts

@@ -1,6 +1,6 @@
 /**
- * Interface defining methods to respond to system signals (when application gets
- * shutdown by, e.g., SIGTERM)
+ * Interface defining method to respond to system signals (when application gets
+ * shutdown by, e.g., `SIGTERM`).
  */
 export interface ShutdownHook {
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@armscye/hooks",
-  "version": "0.5.0",
-  "description": "A collection of shared standard TypeScript definitions",
+  "version": "0.7.0",
+  "description": "A collection of shared standard TypeScript definitions (@hooks)",
   "author": "Augustus Kamau",
   "license": "MIT",
   "types": "./dist/index.d.ts",
@@ -11,10 +11,11 @@
   "keywords": [
     "armscye",
     "typescript",
-    "types"
+    "types",
+    "hooks"
   ],
   "dependencies": {
-    "@armscye/core": "^0.2.0"
+    "@armscye/core": "^0.4.0"
   },
   "homepage": "https://github.com/armscye/armscye#readme",
   "repository": {
@@ -27,5 +28,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "1cc4d3acff67f6754d443396835d2523284bdc3b"
+  "gitHead": "0709eb7276b853296ef820d0e5bd8c170e6d2ee3"
 }