chore: release version 1.0.0

Author: m-mdy-m

.npmignore

@@ -6,3 +6,12 @@
 
 tsconfig.json
 .prettierrc
+scripts
+examples
+docs
+tests
+.git
+.gitignore
+tsconfig
+.env
+src

.npmrc

@@ -0,0 +1,2 @@
+registry=https://registry.npmjs.org/
+//registry.npmjs.org/:_authToken=${NPM_TOKEN}

docs/CHANGELOG.md

@@ -0,0 +1,62 @@
+# Changelog
+
+All notable changes to the `@medishn/toolkit` package will be documented in this file.
+
+---
+
+## [1.0.0] - 2025-02-24
+
+### **Added**
+
+- **Core Utilities**
+
+  - Introduced `ObjectInspector` for type-safe, chainable object inspection and manipulation.
+  - Added `Merger` class for deep object merging with type safety.
+  - Implemented `inspect` and `merge` utility functions for streamlined object operations.
+
+- **Type Utilities**
+
+  - Added essential type helpers:
+    - `Maybe<T>` for nullable values.
+    - `Dictionary<T>` for key-value object structures.
+    - `Constructor<T>` for class constructor types.
+    - `Primitive` and `PrimitiveObject` for primitive value handling.
+    - `Nullable<T>`, `NonNull<T>`, `NonUndefined<T>`, and `NonNullable<T>` for type safety.
+  - Included utility types: `Noop`, `Callback`, and `Numeric`.
+
+- **Logger**
+
+  - Introduced `Logger` class with support for multiple log levels (`info`, `warn`, `error`, `debug`, `verbose`).
+  - Added colorized output for development environments.
+  - Implemented context-based logging and customizable log formats.
+
+- **Error Handling**
+
+  - Added comprehensive HTTP exception classes for standardized error handling.
+  - Included RFC 7807 Problem Details format compliance.
+  - Pre-defined exceptions for all standard HTTP status codes.
+
+- **Type Guards**
+
+  - Added 40+ type guards for runtime type checking:
+    - Primitive checks (`isString`, `isNumber`, `isBoolean`, etc.).
+    - Structural checks (`isObject`, `isArray`, `isFunction`, etc.).
+    - Specialized checks (`isDate`, `isPromise`, `isSymbol`, etc.).
+
+- **HTTP Utilities**
+
+  - Added `HttpStatus` enum with named constants for all HTTP status codes (1xx-5xx).
+
+- **Documentation**
+  - Comprehensive API documentation for all utilities.
+  - Usage examples and best practices for each feature.
+
+---
+
+### **Documentation**
+
+- Added detailed usage guides for all features.
+- Included examples for common use cases.
+- Provided migration guides for developers transitioning from similar libraries.
+
+This release marks the stable 1.0.0 version of `@medishn/toolkit`, providing a robust set of utilities for modern TypeScript development. For detailed migration instructions and usage examples, refer to the [official documentation](https://github.com/medishen/toolkit/docs).

docs/FAQ.md

@@ -1,7 +1,7 @@
 {
   "name": "@medishn/toolkit",
   "version": "1.0.0",
-  "description": "",
+  "description": "a toolkit",
   "files": [
     "dist/",
     "README.md"
@@ -14,9 +14,9 @@
   },
   "scripts": {
     "test": "mocha --require ts-node/register tests/integration/*.spec.ts",
-    "build": "tsc -b ./packages/tsconfig.build.json",
-    "chmod": "chmod +x ./scripts/release.sh",
-    "release": "npm run chmod && ./scripts/release.sh"
+    "build": "tsc",
+    "chmod": "chmod +x ./scripts/release",
+    "release": "npm run chmod && ./scripts/release"
   },
   "repository": {
     "type": "git",

package.json

@@ -1 +1,21 @@
-!#/bin/bash
+#!/bin/bash
+set -e
+npm run build
+VERSION=$(node -p "require('./package.json').version")
+
+CHANGELOG_CONTENT=$(awk "/## \[${VERSION}\]/{flag=1;next}/## \[/{flag=0}flag" docs/CHANGELOG.md | sed '/^$/d')
+
+if [ -z "$CHANGELOG_CONTENT" ]; then
+  echo "Changelog for version ${VERSION} not found. Please ensure the changelog is updated."
+  exit 1
+fi
+if [ -n "$(git status --porcelain)" ]; then
+  git add .
+  git commit -m "chore: release version ${VERSION}"
+  git tag -a "v${VERSION}" -m "Release ${VERSION}" -m "${CHANGELOG_CONTENT}"
+  git push origin main --tags
+else
+  echo "No changes to commit."
+fi
+npm publish --access public
+echo "Version ${VERSION} successfully published."

scripts/release

@@ -49,11 +49,11 @@ export class Merger<T extends object> {
   }
 
   private mergeObjects<T extends object, U extends object>(target: T, source: U): T {
-    const merged = { ...target };
+    const merged:any = { ...target };
 
     for (const key of Object.keys(source)) {
-      const targetValue = target[key];
-      const sourceValue = source[key];
+      const targetValue = (target as any)[key];
+      const sourceValue = (source as any)[key];
 
       merged[key] = this.deepMerge(targetValue, sourceValue);
     }

src/object/merger.ts

@@ -169,7 +169,7 @@ export class ObjectInspector<T extends object> {
   ): ObjectInspector<{ [K in keyof T]: U }> {
     if (!this.is('object')) throw new Error('Cannot map non-object');
 
-    const result = {} as { [K in keyof T]: U };
+    const result:any = {} as { [K in keyof T]: U };
     if (Array.isArray(this.target)) {
       for (let i = 0; i < (this.target as any).length; i++) {
         const key = i.toString();

src/object/object-inspector.ts

@@ -5,23 +5,15 @@
     "strict": true,
     "esModuleInterop": true,
     "removeComments": true,
-    "composite": true,
     "declaration": true,
     "strictNullChecks": true,
     "forceConsistentCasingInFileNames": true,
-    "experimentalDecorators": true,
-    "emitDecoratorMetadata": true,
-    "useUnknownInCatchVariables": false,
     "allowJs": false,
     "skipLibCheck": true,
     "moduleResolution": "node",
     "rootDir": "src",
     "outDir": "dist",
-    "types": ["node"],
-    "noImplicitAny": false,
-    "noUnusedLocals": false,
-    "strictPropertyInitialization": false,
-    "noLib": false
+    "types": ["node"]
   },
   "include": ["src/**/*"],
   "preserveSymlinks": true,