@okam/core-lib 0.0.1

package/index.d.ts

@@ -0,0 +1,9 @@
+export { Asserts } from './utils/asserts';
+export { ArrayUtils } from './utils/array-utils';
+export * from './utils/typeguards';
+export type { UnPromisify } from './utils/type-utils';
+export declare const sayHello: (name: string) => string;
+export { default as createCtx } from './utils/createContext';
+export { createCtxNullable } from './utils/createContext';
+export { default as getNestedObjectValueOfKey } from './utils/object-find-deep-nested';
+export { default as checkObjectProperty } from './utils/object-property';

package/index.js

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

package/index.mjs

@@ -0,0 +1,102 @@
+import s from "react";
+const h = (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;
+  }
+}, a = (t, e = !0) => typeof t == "string" && (e ? t.trim() : t).length > 0, g = (t) => typeof t == "object" && t !== null && t.constructor === Object && Object.getPrototypeOf(t) === Object.prototype, f = (t) => typeof t == "number" && Number.isSafeInteger(t), y = (t) => typeof t == "number" && !Number.isNaN(t) ? !0 : a(t) ? !Number.isNaN(Number.parseInt(t, 10) || Number.isNaN(Number.parseFloat(t))) : !1, N = (t) => {
+  const e = typeof t == "string" && /^-?\d+$/.test(t) ? Number.parseInt(t, 10) : t;
+  return f(e);
+}, m = (t) => f(t) && t < 600 && t >= 100;
+class i {
+  static isPresent(e, r) {
+    if (e == null)
+      throw i.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");
+  }
+  static nonEmptyString(e, r, n) {
+    if (!a(e, n ?? !0))
+      throw i.createException(r);
+  }
+  static never(e, r) {
+    throw new Error(r ?? "Unexpected value");
+  }
+  static createException(e, r) {
+    throw typeof e == "string" || e === void 0 ? new Error(e ?? r ?? "Assertion did not pass.") : e();
+  }
+}
+function l(t, e) {
+  if ([t, e].forEach((r, n) => {
+    if (!Number.isSafeInteger(r))
+      throw new Error(`${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 x {
+  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 w() {
+  const t = s.createContext(void 0);
+  function e() {
+    const r = s.useContext(t);
+    if (r === void 0)
+      throw new Error("useCtx must be inside a Provider");
+    return r;
+  }
+  return [e, t.Provider];
+}
+function I() {
+  const t = s.createContext(void 0);
+  function e() {
+    const r = s.useContext(t);
+    return r === void 0 ? null : r;
+  }
+  return [e, t.Provider];
+}
+function d(t) {
+  return typeof t == "object" && t !== null && !Array.isArray(t);
+}
+function p(t, e, r) {
+  const n = Object.keys(t);
+  let o;
+  o ||= r;
+  for (const c of n) {
+    const u = t[c];
+    if (d(u) && (o ||= p(u, e, o)), c === e)
+      return t[e];
+  }
+  return o;
+}
+const O = (t, e) => {
+  const r = t[e];
+  return r != null && typeof r == "object" && Object.prototype.hasOwnProperty.call(t, e) ? r : null;
+}, j = (t) => `I'm the @okam/shared-ui component telling ${t} !`;
+export {
+  x as ArrayUtils,
+  i as Asserts,
+  O as checkObjectProperty,
+  w as createCtx,
+  I as createCtxNullable,
+  p as getNestedObjectValueOfKey,
+  m as isHttpStatusCode,
+  h as isIsoDateString,
+  a as isNonEmptyString,
+  y as isParsableNumeric,
+  N as isParsableSafeInteger,
+  g as isPlainObject,
+  f as isSafeInteger,
+  j as sayHello
+};

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@okam/core-lib",
+  "version": "0.0.1",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./index.mjs",
+      "require": "./index.js"
+    }
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "url": "https://github.com/OKAMca/stack.git"
+  },
+  "nxrelease": {
+    "repositoryUrl": "https://github.com/OKAMca/stack.git"
+  }
+}

package/utils/array-utils.d.ts

@@ -0,0 +1,4 @@
+export declare class ArrayUtils {
+    static getRandom<T>(items: T[]): T;
+    static removeItem<T>(arr: T[], item: T): T[];
+}

package/utils/asserts.d.ts

@@ -0,0 +1,9 @@
+export declare class Asserts {
+    static isPresent<T>(v: T, msgOrErrorFactory?: string | (() => Error)): asserts v is NonNullable<T>;
+    static safeInteger(v: unknown, msgOrErrorFactory?: string | (() => Error)): asserts v is number;
+    static nonEmptyString(v: unknown, msgOrErrorFactory?: string | (() => Error), 
+    /** auto-trim, default true */
+    trim?: boolean): asserts v is string;
+    static never(_v: never, msg?: string): never;
+    private static createException;
+}

package/utils/createContext.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+/**
+ * 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 Record<string, unknown> | null>(): readonly [() => A, React.Provider<A | undefined>];
+export declare function createCtxNullable<A extends Record<string, unknown> | null>(): readonly [() => A | null, React.Provider<A | undefined>];
+export default createCtx;

package/utils/object-find-deep-nested.d.ts

@@ -0,0 +1,2 @@
+declare function getNestedObjectValueOfKey<T>(obj: T & Record<string, unknown>, key: string, found?: Record<string, unknown> | undefined | unknown): Record<string, unknown> | undefined | unknown;
+export default getNestedObjectValueOfKey;

package/utils/object-property.d.ts

@@ -0,0 +1,2 @@
+declare const checkObjectProperty: (obj: Record<string, unknown>, property: string) => Record<string, unknown> | null;
+export default checkObjectProperty;

package/utils/random-utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Returns a random integer between min (inclusive) and max (inclusive).
+ * The value is no lower than min (or the next integer greater than min
+ * if min isn't an integer) and no greater than max (or the next integer
+ * lower than max if max isn't an integer).
+ * @link https://stackoverflow.com/questions/1527803/generating-random-whole-numbers-in-javascript-in-a-specific-range/1527820#1527820
+ */
+export declare function getRandomInt(min: number, max: number): number;

package/utils/type-utils.d.ts

@@ -0,0 +1 @@
+export type UnPromisify<T> = T extends Promise<infer U> ? U : T;

package/utils/typeguards.d.ts

@@ -0,0 +1,8 @@
+export type IsoDateString = string;
+export declare const isIsoDateString: (dateStr: unknown) => dateStr is string;
+export declare const isNonEmptyString: (v: unknown, trim?: boolean) => v is string;
+export declare const isPlainObject: <T = unknown, K extends string | number = string>(v: unknown) => v is Record<K, T>;
+export declare const isSafeInteger: (v: unknown) => v is number;
+export declare const isParsableNumeric: (v: unknown) => v is string | number;
+export declare const isParsableSafeInteger: (v: unknown) => v is string | number;
+export declare const isHttpStatusCode: (v: unknown) => v is number;