@okam/core-lib 1.17.3 → 2.0.0

package/CHANGELOG.md

@@ -1,3 +1,28 @@
+## 2.0.0 (Unreleased)
+
+### ⚠️ Breaking Changes
+
+- **core-lib:** Removed `createCtx` and `createCtxNullable` exports. These React context utilities are now only available in `@okam/react-utils`. Update your imports:
+  ```typescript
+  // Before (no longer works)
+  import { createCtx, createCtxNullable } from '@okam/core-lib'
+
+  // After
+  import { createCtx, createCtxNullable } from '@okam/react-utils'
+  ```
+- **core-lib:** Removed the `react-server` export condition since core-lib is now server-safe by default (no React dependencies)
+- **core-lib:** Removed `@okam/react-utils` peer dependency - core-lib no longer has any React-related dependencies
+
+### 🚀 Features
+
+- **core-lib:** Now fully server-safe by default - can be used in Node.js, Edge runtimes, and React Server Components without any special configuration
+
+---
+
+## 1.17.4 (2026-01-23)
+
+This was a version bump only for core-lib to align it with other projects, there were no code changes.
+
 ## 1.17.2 (2026-01-21)
 
 ### 🩹 Fixes

package/README.md

@@ -2,6 +2,37 @@
 
 This library was generated with [Nx](https://nx.dev).
 
+## Breaking Change: v2.0.0
+
+### React Context Utilities Removed
+
+The React context utilities `createCtx` and `createCtxNullable` have been **removed** from `@okam/core-lib`. These utilities are now only available in `@okam/react-utils`.
+
+**Migration:**
+
+```typescript
+// Before (no longer works in v2.0.0)
+import { createCtx, createCtxNullable } from '@okam/core-lib'
+
+// After
+import { createCtx, createCtxNullable } from '@okam/react-utils'
+```
+
+### Server-Safe by Default
+
+`@okam/core-lib` is now fully server-safe and can be used in any environment without React dependencies. The `react-server` export condition has been removed since it is no longer needed - the default export is server-safe.
+
+## Available Exports
+
+- `ArrayUtils` - Array manipulation utilities
+- `Asserts` - Assertion helpers
+- `normalizePath` - Path normalization utility
+- `getNestedObjectValueOfKey` - Deep object property access
+- `checkObjectProperty` - Object property checking
+- `capitalizeFirstLetter` - String capitalization
+- `UnPromisify` - Type utility for unwrapping Promise types
+- `typeguards` - TypeScript type guards
+
 ## Running unit tests
 
 Run `nx test core-lib` to execute the unit tests via [Vitest](https://vitest.dev/).

package/index.d.ts

@@ -1,8 +1,5 @@
 export { ArrayUtils } from './utils/array-utils';
 export { Asserts } from './utils/asserts';
-export { default as createCtx } from './utils/createContext';
-export { createCtxNullable } from './utils/createContext';
-export declare function sayHello(name: string): string;
 export { normalizePath } from './utils/normalize-path';
 export { default as getNestedObjectValueOfKey } from './utils/object-find-deep-nested';
 export { default as checkObjectProperty } from './utils/object-property';

package/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("react");function p(t,e){if([t,e].forEach((r,n)=>{if(!Number.isSafeInteger(r))throw new TypeError(`${n===0?"min":"max"} is not a valid integer`)}),e<t)throw new Error("Min cannot be greater than max");return t=Math.ceil(t),e=Math.floor(e),Math.floor(Math.random()*(e-t+1))+t}class d{static getRandom(e){return e[p(0,e.length-1)]}static removeItem(e,r){const n=e.indexOf(r);return n>-1&&e.splice(n,1),e}}function b(t){if(typeof t!="string"||!/\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{3}Z/.test(t))return!1;try{return new Date(t).toISOString()===t}catch{return!1}}function c(t,e=!0){return typeof t=="string"&&(e?t.trim():t).length>0}function g(t){return typeof t=="object"&&t!==null&&t.constructor===Object&&Object.getPrototypeOf(t)===Object.prototype}function u(t){return typeof t=="number"&&Number.isSafeInteger(t)}function y(t){return typeof t=="number"&&!Number.isNaN(t)?!0:c(t)?!Number.isNaN(Number.parseInt(t,10)||Number.isNaN(Number.parseFloat(t))):!1}function h(t){const e=typeof t=="string"&&/^-?\d+$/.test(t)?Number.parseInt(t,10):t;return u(e)}function m(t){return u(t)&&t<600&&t>=100}class o{static isPresent(e,r){if(e==null)throw o.createException(r,"Value is null or undefined.")}static safeInteger(e,r){if(typeof e!="number"||!Number.isSafeInteger(e))throw o.createException(r,"Value is not a safe integer")}static nonEmptyString(e,r,n){if(!c(e,n??!0))throw o.createException(r)}static never(e,r){throw new Error(r??"Unexpected value")}static createException(e,r){throw typeof e=="function"?e():new Error(e??r??"Assertion did not pass.")}}function N(){const t=s.createContext(void 0);function e(){const r=s.use(t);if(r===void 0)throw new Error("useCtx must be inside a Provider");return r}return[e,t.Provider]}function P(){const t=s.createContext(void 0);function e(){const r=s.use(t);return r===void 0?{}:r}return[e,t.Provider]}function O(t){return t.split("/").reduceRight((n,i)=>n.length===0&&i===""?n:[i,...n],[]).join("/")}function x(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}function l(t,e,r){const n=Object.keys(t);let i;i??=r;for(const a of n){const f=t[a];if(x(f)&&(i??=l(f,e,i)),a===e)return t[e]}return i}function w(t,e){const r=t[e];return r!=null&&typeof r=="object"&&Object.prototype.hasOwnProperty.call(t,e)?r:null}function I(t){return t.charAt(0).toUpperCase()+t.slice(1)}function j(t){return`I'm the @okam/shared-ui component telling ${t} !`}exports.ArrayUtils=d;exports.Asserts=o;exports.capitalizeFirstLetter=I;exports.checkObjectProperty=w;exports.createCtx=N;exports.createCtxNullable=P;exports.getNestedObjectValueOfKey=l;exports.isHttpStatusCode=m;exports.isIsoDateString=b;exports.isNonEmptyString=c;exports.isParsableNumeric=y;exports.isParsableSafeInteger=h;exports.isPlainObject=g;exports.isSafeInteger=u;exports.normalizePath=O;exports.sayHello=j;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function l(t,e){if([t,e].forEach((r,n)=>{if(!Number.isSafeInteger(r))throw new TypeError(`${n===0?"min":"max"} is not a valid integer`)}),e<t)throw new Error("Min cannot be greater than max");return t=Math.ceil(t),e=Math.floor(e),Math.floor(Math.random()*(e-t+1))+t}class p{static getRandom(e){return e[l(0,e.length-1)]}static removeItem(e,r){const n=e.indexOf(r);return n>-1&&e.splice(n,1),e}}function b(t){if(typeof t!="string"||!/\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{3}Z/.test(t))return!1;try{return new Date(t).toISOString()===t}catch{return!1}}function s(t,e=!0){return typeof t=="string"&&(e?t.trim():t).length>0}function d(t){return typeof t=="object"&&t!==null&&t.constructor===Object&&Object.getPrototypeOf(t)===Object.prototype}function a(t){return typeof t=="number"&&Number.isSafeInteger(t)}function g(t){return typeof t=="number"&&!Number.isNaN(t)?!0:s(t)?!Number.isNaN(Number.parseInt(t,10)||Number.isNaN(Number.parseFloat(t))):!1}function y(t){const e=typeof t=="string"&&/^-?\d+$/.test(t)?Number.parseInt(t,10):t;return a(e)}function h(t){return a(t)&&t<600&&t>=100}class o{static isPresent(e,r){if(e==null)throw o.createException(r,"Value is null or undefined.")}static safeInteger(e,r){if(typeof e!="number"||!Number.isSafeInteger(e))throw o.createException(r,"Value is not a safe integer")}static nonEmptyString(e,r,n){if(!s(e,n??!0))throw o.createException(r)}static never(e,r){throw new Error(r??"Unexpected value")}static createException(e,r){throw typeof e=="function"?e():new Error(e??r??"Assertion did not pass.")}}function m(t){return t.split("/").reduceRight((n,i)=>n.length===0&&i===""?n:[i,...n],[]).join("/")}function N(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}function f(t,e,r){const n=Object.keys(t);let i;i??=r;for(const u of n){const c=t[u];if(N(c)&&(i??=f(c,e,i)),u===e)return t[e]}return i}function O(t,e){const r=t[e];return r!=null&&typeof r=="object"&&Object.prototype.hasOwnProperty.call(t,e)?r:null}function P(t){return t.charAt(0).toUpperCase()+t.slice(1)}exports.ArrayUtils=p;exports.Asserts=o;exports.capitalizeFirstLetter=P;exports.checkObjectProperty=O;exports.getNestedObjectValueOfKey=f;exports.isHttpStatusCode=h;exports.isIsoDateString=b;exports.isNonEmptyString=s;exports.isParsableNumeric=g;exports.isParsableSafeInteger=y;exports.isPlainObject=d;exports.isSafeInteger=a;exports.normalizePath=m;

package/index.mjs

@@ -1,5 +1,4 @@
-import { createContext as s, use as a } from "react";
-function p(t, e) {
+function f(t, e) {
   if ([t, e].forEach((r, n) => {
     if (!Number.isSafeInteger(r))
       throw new TypeError(`${n === 0 ? "min" : "max"} is not a valid integer`);
@@ -7,16 +6,16 @@ function p(t, e) {
     throw new Error("Min cannot be greater than max");
   return t = Math.ceil(t), e = Math.floor(e), Math.floor(Math.random() * (e - t + 1)) + t;
 }
-class m {
+class b {
   static getRandom(e) {
-    return e[p(0, e.length - 1)];
+    return e[f(0, e.length - 1)];
   }
   static removeItem(e, r) {
     const n = e.indexOf(r);
     return n > -1 && e.splice(n, 1), e;
   }
 }
-function g(t) {
+function d(t) {
   if (typeof t != "string" || !/\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{3}Z/.test(t))
     return !1;
   try {
@@ -25,37 +24,37 @@ function g(t) {
     return !1;
   }
 }
-function f(t, e = !0) {
+function c(t, e = !0) {
   return typeof t == "string" && (e ? t.trim() : t).length > 0;
 }
-function y(t) {
+function h(t) {
   return typeof t == "object" && t !== null && t.constructor === Object && Object.getPrototypeOf(t) === Object.prototype;
 }
-function l(t) {
+function a(t) {
   return typeof t == "number" && Number.isSafeInteger(t);
 }
-function N(t) {
-  return typeof t == "number" && !Number.isNaN(t) ? !0 : f(t) ? !Number.isNaN(Number.parseInt(t, 10) || Number.isNaN(Number.parseFloat(t))) : !1;
+function g(t) {
+  return typeof t == "number" && !Number.isNaN(t) ? !0 : c(t) ? !Number.isNaN(Number.parseInt(t, 10) || Number.isNaN(Number.parseFloat(t))) : !1;
 }
-function w(t) {
+function y(t) {
   const e = typeof t == "string" && /^-?\d+$/.test(t) ? Number.parseInt(t, 10) : t;
-  return l(e);
+  return a(e);
 }
-function x(t) {
-  return l(t) && t < 600 && t >= 100;
+function m(t) {
+  return a(t) && t < 600 && t >= 100;
 }
-class i {
+class o {
   static isPresent(e, r) {
     if (e == null)
-      throw i.createException(r, "Value is null or undefined.");
+      throw o.createException(r, "Value is null or undefined.");
   }
   static safeInteger(e, r) {
     if (typeof e != "number" || !Number.isSafeInteger(e))
-      throw i.createException(r, "Value is not a safe integer");
+      throw o.createException(r, "Value is not a safe integer");
   }
   static nonEmptyString(e, r, n) {
-    if (!f(e, n ?? !0))
-      throw i.createException(r);
+    if (!c(e, n ?? !0))
+      throw o.createException(r);
   }
   static never(e, r) {
     throw new Error(r ?? "Unexpected value");
@@ -64,66 +63,42 @@ class i {
     throw typeof e == "function" ? e() : new Error(e ?? r ?? "Assertion did not pass.");
   }
 }
-function I() {
-  const t = s(void 0);
-  function e() {
-    const r = a(t);
-    if (r === void 0)
-      throw new Error("useCtx must be inside a Provider");
-    return r;
-  }
-  return [e, t.Provider];
-}
-function O() {
-  const t = s(void 0);
-  function e() {
-    const r = a(t);
-    return r === void 0 ? {} : r;
-  }
-  return [e, t.Provider];
-}
-function P(t) {
-  return t.split("/").reduceRight((n, o) => n.length === 0 && o === "" ? n : [o, ...n], []).join("/");
+function N(t) {
+  return t.split("/").reduceRight((n, i) => n.length === 0 && i === "" ? n : [i, ...n], []).join("/");
 }
-function d(t) {
+function l(t) {
   return typeof t == "object" && t !== null && !Array.isArray(t);
 }
-function b(t, e, r) {
+function p(t, e, r) {
   const n = Object.keys(t);
-  let o;
-  o ??= r;
+  let i;
+  i ??= r;
   for (const u of n) {
-    const c = t[u];
-    if (d(c) && (o ??= b(c, e, o)), u === e)
+    const s = t[u];
+    if (l(s) && (i ??= p(s, e, i)), u === e)
       return t[e];
   }
-  return o;
+  return i;
 }
-function j(t, e) {
+function w(t, e) {
   const r = t[e];
   return r != null && typeof r == "object" && Object.prototype.hasOwnProperty.call(t, e) ? r : null;
 }
-function E(t) {
+function O(t) {
   return t.charAt(0).toUpperCase() + t.slice(1);
 }
-function C(t) {
-  return `I'm the @okam/shared-ui component telling ${t} !`;
-}
 export {
-  m as ArrayUtils,
-  i as Asserts,
-  E as capitalizeFirstLetter,
-  j as checkObjectProperty,
-  I as createCtx,
-  O as createCtxNullable,
-  b as getNestedObjectValueOfKey,
-  x as isHttpStatusCode,
-  g as isIsoDateString,
-  f as isNonEmptyString,
-  N as isParsableNumeric,
-  w as isParsableSafeInteger,
-  y as isPlainObject,
-  l as isSafeInteger,
-  P as normalizePath,
-  C as sayHello
+  b as ArrayUtils,
+  o as Asserts,
+  O as capitalizeFirstLetter,
+  w as checkObjectProperty,
+  p as getNestedObjectValueOfKey,
+  m as isHttpStatusCode,
+  d as isIsoDateString,
+  c as isNonEmptyString,
+  g as isParsableNumeric,
+  y as isParsableSafeInteger,
+  h as isPlainObject,
+  a as isSafeInteger,
+  N as normalizePath
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@okam/core-lib",
-  "version": "1.17.3",
+  "version": "2.0.0",
   "license": "MIT",
   "repository": {
     "url": "https://github.com/OKAMca/stack.git"
@@ -29,14 +29,7 @@
   "nxrelease": {
     "repositoryUrl": "https://github.com/OKAMca/stack.git"
   },
-  "peerDependencies": {
-    "react": "^18.0.0 || ^19.0.0"
-  },
   "dependencies": {
-    "@tsed/exceptions": "^8.3.1",
-    "dequal": "^2.0.3"
-  },
-  "devDependencies": {
-    "react": "^19.0.0"
+    "@tsed/exceptions": "^8.3.1"
   }
-}
+}

package/hooks/index.d.ts

@@ -1,2 +0,0 @@
-export { useDeepCompareMemoize } from './use-deep-compare-memoize';
-export { usePromise } from './use-promise';

package/hooks/use-deep-compare-memoize.d.ts

@@ -1,3 +0,0 @@
-type SupportedValue = Record<string, unknown> | string | boolean | number | null;
-export declare function useDeepCompareMemoize(value: SupportedValue): SupportedValue;
-export {};

package/hooks/use-promise.d.ts

@@ -1,13 +0,0 @@
-export type AsyncFnParams<TParams> = TParams;
-export type AsyncFnWithParams<TResult, TParams extends Record<string, unknown>> = (_variables: TParams) => Promise<TResult>;
-export type AsyncFnWithoutParams<TResult> = () => Promise<TResult>;
-export type AsyncFn<TResult, TParams extends Record<string, unknown> = Partial<Record<string, unknown>>> = AsyncFnWithParams<TResult, TParams> | AsyncFnWithoutParams<TResult>;
-export interface UsePromiseOptions<TResult> {
-    initialData?: TResult;
-}
-export declare function usePromise<TResult, TVariables extends Record<string, unknown> = Partial<Record<string, unknown>>>(promise: AsyncFn<TResult, TVariables>, params: AsyncFnParams<TVariables>, options?: UsePromiseOptions<TResult>): {
-    error: Error | null;
-    isLoading: boolean;
-    data: TResult | null;
-    reload: () => void;
-};

package/utils/createContext.d.ts

@@ -1,7 +0,0 @@
-/**
- * A helper to create a Context and Provider with no upfront default value, and
- * without having to check for undefined all the time.
- */
-declare function createCtx<A extends object | null>(): readonly [() => A, import('react').Provider<A | undefined>];
-export declare function createCtxNullable<A extends object | null>(): readonly [() => A, import('react').Provider<A | undefined>];
-export default createCtx;