@hkdigital/lib-core 0.4.13 → 0.4.15

package/dist/auth/jwt/util.d.ts

@@ -1,6 +1,38 @@
 /**
- * Casts jsonwebtoken library errors to internal error types
- * @param {Error} error - The original jsonwebtoken error
- * @returns {Error} - The corresponding internal error
+ * Create a JSON Web Token (JWT)
+ * - Stringifies the claims as JSON object
+ * - Encodes the options
+ * - Calculates a Message Authentication Code (MAC)
+ *   (by default a Hash Based Authentication Code (HMAC) will be used: HS512)
+ * - Combines the parts into a JWT string
+ *
+ * @param {import('./typedef.js').JwtPayload} claims - JWT payload/claims
+ * @param {import('./typedef.js').Secret} secretOrPrivateKey
+ *   Secret or private key that is used by the MAC calculation algorithm
+ *
+ *   - To generate a secret for a Hash based Authentication Code (HMAC):
+ *     use a function like `generateSecretKeyForHmacBase58()`.
+ *
+ *   - For algorithms that use asymmetric keys, the secret is the private key
+ *     of the key pair.
+ *
+ * @param {import('./typedef.js').SignOptions} [options] - JWT signing options
+ *
+ * For more options:
+ * @see https://github.com/auth0/node-jsonwebtoken
+ *
+ * @returns {string} JsonWebToken
  */
-export function castJwtError(error: Error): Error;
+export function sign(claims: import("./typedef.js").JwtPayload, secretOrPrivateKey: import("./typedef.js").Secret, options?: import("./typedef.js").SignOptions): string;
+/**
+ * Decode and verify a JWT token
+ * - Forces the use of the algorithm specified in VERIFY_OPTIONS
+ *
+ * @param {string} token - A JWT token
+ * @param {import('./typedef.js').Secret} secretOrPrivateKey
+ *   The secret of private key to be used for decoding
+ * @param {import('./typedef.js').VerifyOptions} [options=VERIFY_OPTIONS] - verify / decode options
+ *
+ * @returns {import('./typedef.js').JwtPayload} claims - The decoded JWT payload
+ */
+export function verify(token: string, secretOrPrivateKey: import("./typedef.js").Secret, options?: import("./typedef.js").VerifyOptions): import("./typedef.js").JwtPayload;

package/dist/auth/jwt/util.js

@@ -2,14 +2,26 @@
  * JWT utility functions
  *
  * @description
- * This module provides utility functions for JWT operations including error casting.
+ * This module provides utility functions for JWT operations including 
+ * sign, verify and error casting.
  */
 
-import jwt, { 
+import jwt from 'jsonwebtoken';
+
+import {
   TokenExpiredError as JwtTokenExpiredError,
   JsonWebTokenError as JwtJsonWebTokenError,
   NotBeforeError as JwtNotBeforeError
 } from 'jsonwebtoken';
+
+import * as expect from '../../util/expect.js';
+
+import {
+  JWT_DEFAULT_EXPIRES_IN,
+  DEFAULT_ALGORITHM,
+  VERIFY_OPTIONS 
+} from './constants.js';
+
 import {
   TokenExpiredError,
   JsonWebTokenError,
@@ -17,12 +29,109 @@ import {
   NotBeforeError
 } from './errors.js';
 
+/**
+ * Create a JSON Web Token (JWT)
+ * - Stringifies the claims as JSON object
+ * - Encodes the options
+ * - Calculates a Message Authentication Code (MAC)
+ *   (by default a Hash Based Authentication Code (HMAC) will be used: HS512)
+ * - Combines the parts into a JWT string
+ *
+ * @param {import('./typedef.js').JwtPayload} claims - JWT payload/claims
+ * @param {import('./typedef.js').Secret} secretOrPrivateKey
+ *   Secret or private key that is used by the MAC calculation algorithm
+ *
+ *   - To generate a secret for a Hash based Authentication Code (HMAC):
+ *     use a function like `generateSecretKeyForHmacBase58()`.
+ *
+ *   - For algorithms that use asymmetric keys, the secret is the private key
+ *     of the key pair.
+ *
+ * @param {import('./typedef.js').SignOptions} [options] - JWT signing options
+ *
+ * For more options:
+ * @see https://github.com/auth0/node-jsonwebtoken
+ *
+ * @returns {string} JsonWebToken
+ */
+export function sign(
+  claims,
+  secretOrPrivateKey,
+  options={} )
+{
+  expect.object( claims );
+  expect.defined( secretOrPrivateKey );
+
+  if( options )
+  {
+    expect.object( options );
+  }
+  else {
+    options = {};
+  }
+
+  if( !('algorithm' in options) )
+  {
+    options.algorithm = DEFAULT_ALGORITHM;
+  }
+
+  if( !('expiresIn' in options) )
+  {
+    options.expiresIn = JWT_DEFAULT_EXPIRES_IN;
+  }
+  else if( !options.expiresIn )
+  {
+    delete options.expiresIn;
+  }
+
+  // @ts-ignore
+  return jwt.sign( claims, secretOrPrivateKey, options );
+}
+
+/**
+ * Decode and verify a JWT token
+ * - Forces the use of the algorithm specified in VERIFY_OPTIONS
+ *
+ * @param {string} token - A JWT token
+ * @param {import('./typedef.js').Secret} secretOrPrivateKey
+ *   The secret of private key to be used for decoding
+ * @param {import('./typedef.js').VerifyOptions} [options=VERIFY_OPTIONS] - verify / decode options
+ *
+ * @returns {import('./typedef.js').JwtPayload} claims - The decoded JWT payload
+ */
+export function verify( token, secretOrPrivateKey, options=VERIFY_OPTIONS )
+{
+  expect.notEmptyString( token );
+  expect.defined( secretOrPrivateKey );
+
+  if( !('algorithms' in options) )
+  {
+    options.algorithms = VERIFY_OPTIONS.algorithms;
+  }
+
+  try {
+    // @ts-ignore
+    const decoded = jwt.verify( token, secretOrPrivateKey, options );
+
+    return decoded;
+  }
+  catch( e )
+  {
+    //
+    // Cast internal jsonwebtoken errors to Error types defined in this lib
+    //
+    throw castJwtError(e);
+  }
+}
+
+// Internals
+
 /**
  * Casts jsonwebtoken library errors to internal error types
  * @param {Error} error - The original jsonwebtoken error
  * @returns {Error} - The corresponding internal error
  */
-export function castJwtError(error) {
+function castJwtError(error) {
   if (error instanceof JwtTokenExpiredError) {
     return new TokenExpiredError(error.message, error.expiredAt, error);
   }
@@ -40,4 +149,4 @@ export function castJwtError(error) {
   
   // Return original error if not a known JWT error
   return error;
-}
+}

package/dist/auth/jwt.d.ts

@@ -1,4 +1,4 @@
-export * from "./jwt/core.js";
+export * from "./jwt/util.js";
 export * from "./jwt/generators.js";
 export * from "./jwt/errors.js";
 export * from "./jwt/constants.js";

package/dist/auth/jwt.js

@@ -6,7 +6,7 @@
  * verifying tokens, and generating secret keys.
  */
 
-export * from './jwt/core.js';
+export * from './jwt/util.js';
 export * from './jwt/generators.js';
 export * from './jwt/errors.js';
 export * from './jwt/constants.js';

package/dist/constants/bases.d.ts

@@ -0,0 +1 @@
+export * from "./bases/index.js";

package/dist/constants/bases.js

@@ -0,0 +1 @@
+export * from './bases/index.js';

package/dist/constants/http.d.ts

@@ -0,0 +1,2 @@
+export * from "./http/headers.js";
+export * from "./http/methods.js";

package/dist/constants/http.js

@@ -0,0 +1,2 @@
+export * from './http/headers.js';
+export * from './http/methods.js';

package/dist/constants/mime.d.ts

@@ -0,0 +1,4 @@
+export * from "./mime/application.js";
+export * from "./mime/audio.js";
+export * from "./mime/text.js";
+export * from "./mime/image.js";

package/dist/constants/mime.js

@@ -0,0 +1,4 @@
+export * from './mime/application.js';
+export * from './mime/audio.js';
+export * from './mime/text.js';
+export * from './mime/image.js';

package/dist/constants/regexp.d.ts

@@ -0,0 +1,3 @@
+export * from "./regexp/text.js";
+export * from "./regexp/url.js";
+export * from "./regexp/user.js";

package/dist/constants/regexp.js

@@ -0,0 +1,3 @@
+export * from './regexp/text.js';
+export * from './regexp/url.js';
+export * from './regexp/user.js';

package/dist/constants/states/drag.d.ts

@@ -1,4 +1,4 @@
-export const IDLE: "idle";
+export const DRAG_IDLE: "idle";
 export const DRAGGING: "dragging";
 export const DRAG_PREVIEW: "drag-preview";
 export const DROPPING: "dropping";

package/dist/constants/states/drag.js

@@ -1,5 +1,5 @@
 // Draggable states
-export const IDLE = 'idle';                     // Not being dragged
+export const DRAG_IDLE = 'idle';                // Not being dragged
 export const DRAGGING = 'dragging';             // Currently being dragged
 export const DRAG_PREVIEW = 'drag-preview';     // Mouse down, before drag
 export const DROPPING = 'dropping';             // Just dropped, animating

package/dist/constants/states/submit.d.ts

@@ -1,4 +1,4 @@
-export const IDLE: "idle";
+export const SUBMIT_IDLE: "idle";
 export const SUBMITTING: "submitting";
 export const SUBMIT_OK: "submit-ok";
 export const SUBMIT_FAILED: "submit-failed";

package/dist/constants/states/submit.js

@@ -1,4 +1,4 @@
-export const IDLE = 'idle';
+export const SUBMIT_IDLE = 'idle';
 export const SUBMITTING = 'submitting';
 export const SUBMIT_OK = 'submit-ok';
 export const SUBMIT_FAILED = 'submit-failed';

package/dist/constants/states.d.ts

@@ -0,0 +1,4 @@
+export * from "./states/drag.js";
+export * from "./states/drop.js";
+export * from "./states/input.js";
+export * from "./states/submit.js";

package/dist/constants/states.js

@@ -0,0 +1,4 @@
+export * from './states/drag.js';
+export * from './states/drop.js';
+export * from './states/input.js';
+export * from './states/submit.js';

package/dist/constants/time.d.ts

@@ -0,0 +1 @@
+export * from "./time/index.js";

package/dist/constants/time.js

@@ -0,0 +1 @@
+export * from './time/index.js';

package/dist/network/http/errors.js

@@ -1,9 +1,9 @@
 import * as expect from '../../util/expect.js';
 import { DetailedError } from '../../generic/errors.js';
 
-import { CONTENT_TYPE } from '../../constants/http/index.js';
+import { CONTENT_TYPE } from '../../constants/http.js';
 
-import { APPLICATION_JSON, TEXT_PLAIN } from '../../constants/mime/index.js';
+import { APPLICATION_JSON, TEXT_PLAIN } from '../../constants/mime.js';
 
 /**
  * Try to get error information from the server error response

package/dist/network/http/index.js

@@ -17,6 +17,6 @@ export * from './response.js';
 export * from './http-request.js';
 export * from './json-request.js';
 
-// import { CONTENT_TYPE, METHOD_GET, METHOD_POST } from '../../constants/http/index.js';
+// import { CONTENT_TYPE, METHOD_GET, METHOD_POST } from '../../constants/http.js';
 
-// import { APPLICATION_JSON } from '../../constants/mime/index.js';
+// import { APPLICATION_JSON } from '../../constants/mime.js';

package/dist/network/http/mocks.js

@@ -1,6 +1,6 @@
-import { CONTENT_TYPE, CONTENT_LENGTH } from '../../constants/http/index.js';
+import { CONTENT_TYPE, CONTENT_LENGTH } from '../../constants/http.js';
 
-import { OCTET_STREAM } from '../../constants/mime/index.js';
+import { OCTET_STREAM } from '../../constants/mime.js';
 
 /**
  * Create a response value that can be used by a mocked fetch function

package/dist/network/loaders/audio/mocks.js

@@ -1,4 +1,4 @@
-import { CONTENT_TYPE, CONTENT_LENGTH } from '../../../constants/http/index.js';
+import { CONTENT_TYPE, CONTENT_LENGTH } from '../../../constants/http.js';
 
 import { AUDIO_WAV } from '../../../constants/mime/audio.js';
 

package/dist/network/loaders/image/mocks.js

@@ -1,4 +1,4 @@
-import { CONTENT_TYPE, CONTENT_LENGTH } from '../../../constants/http/index.js';
+import { CONTENT_TYPE, CONTENT_LENGTH } from '../../../constants/http.js';
 
 import { IMAGE_PNG } from '../../../constants/mime/image.js';
 

package/dist/network/states/NetworkLoader.svelte.js

@@ -1,4 +1,4 @@
-import { CONTENT_TYPE } from '../../constants/http/index.js';
+import { CONTENT_TYPE } from '../../constants/http.js';
 
 import { LoadingStateMachine } from '../../state/classes.js';
 

package/dist/network/states/mocks.js

@@ -1,4 +1,4 @@
-import { CONTENT_TYPE, CONTENT_LENGTH } from '../../constants/http/index.js';
+import { CONTENT_TYPE, CONTENT_LENGTH } from '../../constants/http.js';
 
 import { OCTET_STREAM } from '../../constants/mime/application.js';
 

package/dist/ui/components/drag-drop/Draggable.svelte

@@ -6,7 +6,7 @@
   import { DragController } from './DragController.js';
   import { onDestroy } from 'svelte';
   import {
-    IDLE,
+    DRAG_IDLE,
     DRAGGING,
     DRAG_PREVIEW,
     DROPPING
@@ -91,7 +91,7 @@
   let draggableElement;
 
   let dragTimeout = null;
-  let currentState = $state(IDLE);
+  let currentState = $state(DRAG_IDLE);
 
   // Custom preview follower state
   let showPreview = $state(false);
@@ -112,7 +112,7 @@
 
   // Computed state object for CSS classes
   let stateObject = $derived({
-    idle: currentState === IDLE,
+    idle: currentState === DRAG_IDLE,
     dragging: currentState === DRAGGING,
     'drag-preview': currentState === DRAG_PREVIEW,
     dropping: currentState === DROPPING,
@@ -295,10 +295,10 @@
 
       // Brief dropping state before returning to idle
       setTimeout(() => {
-        currentState = IDLE;
+        currentState = DRAG_IDLE;
       }, 100);
     } else {
-      currentState = IDLE;
+      currentState = DRAG_IDLE;
     }
 
     onDragEnd?.({ event, item, wasDropped });
@@ -321,7 +321,7 @@
   function handleMouseUp(event) {
     if (dragTimeout) {
       clearTimeout(dragTimeout);
-      currentState = IDLE;
+      currentState = DRAG_IDLE;
     }
   }
 
@@ -456,7 +456,7 @@
 
     // Clean up
     touchDragging = false;
-    currentState = IDLE;
+    currentState = DRAG_IDLE;
     showPreview = false;
     dragState.end(draggableId);
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hkdigital/lib-core",
-	"version": "0.4.13",
+	"version": "0.4.15",
 	"author": {
 		"name": "HKdigital",
 		"url": "https://hkdigital.nl"

package/dist/auth/jwt/core.d.ts

@@ -1,38 +0,0 @@
-/**
- * Create a JSON Web Token (JWT)
- * - Stringifies the claims as JSON object
- * - Encodes the options
- * - Calculates a Message Authentication Code (MAC)
- *   (by default a Hash Based Authentication Code (HMAC) will be used: HS512)
- * - Combines the parts into a JWT string
- *
- * @param {import('./typedef.js').JwtPayload} claims - JWT payload/claims
- * @param {import('./typedef.js').Secret} secretOrPrivateKey
- *   Secret or private key that is used by the MAC calculation algorithm
- *
- *   - To generate a secret for a Hash based Authentication Code (HMAC):
- *     use a function like `generateSecretKeyForHmacBase58()`.
- *
- *   - For algorithms that use asymmetric keys, the secret is the private key
- *     of the key pair.
- *
- * @param {import('./typedef.js').SignOptions} [options] - JWT signing options
- *
- * For more options:
- * @see https://github.com/auth0/node-jsonwebtoken
- *
- * @returns {string} JsonWebToken
- */
-export function sign(claims: import("./typedef.js").JwtPayload, secretOrPrivateKey: import("./typedef.js").Secret, options?: import("./typedef.js").SignOptions): string;
-/**
- * Decode and verify a JWT token
- * - Forces the use of the algorithm specified in VERIFY_OPTIONS
- *
- * @param {string} token - A JWT token
- * @param {import('./typedef.js').Secret} secretOrPrivateKey
- *   The secret of private key to be used for decoding
- * @param {import('./typedef.js').VerifyOptions} [options=VERIFY_OPTIONS] - verify / decode options
- *
- * @returns {import('./typedef.js').JwtPayload} claims - The decoded JWT payload
- */
-export function verify(token: string, secretOrPrivateKey: import("./typedef.js").Secret, options?: import("./typedef.js").VerifyOptions): import("./typedef.js").JwtPayload;

package/dist/auth/jwt/core.js

@@ -1,114 +0,0 @@
-/**
- * Core JWT operations - sign and verify functions
- *
- * @description
- * This module provides the main JWT functionality for signing and verifying tokens.
- * It wraps the jsonwebtoken library with consistent error handling and validation.
- */
-
-import jwt from 'jsonwebtoken';
-
-import * as expect from '../../util/expect.js';
-
-import { 
-  JWT_DEFAULT_EXPIRES_IN,
-  DEFAULT_ALGORITHM,
-  VERIFY_OPTIONS 
-} from './constants.js';
-
-import { castJwtError } from './util.js';
-
-/**
- * Create a JSON Web Token (JWT)
- * - Stringifies the claims as JSON object
- * - Encodes the options
- * - Calculates a Message Authentication Code (MAC)
- *   (by default a Hash Based Authentication Code (HMAC) will be used: HS512)
- * - Combines the parts into a JWT string
- *
- * @param {import('./typedef.js').JwtPayload} claims - JWT payload/claims
- * @param {import('./typedef.js').Secret} secretOrPrivateKey
- *   Secret or private key that is used by the MAC calculation algorithm
- *
- *   - To generate a secret for a Hash based Authentication Code (HMAC):
- *     use a function like `generateSecretKeyForHmacBase58()`.
- *
- *   - For algorithms that use asymmetric keys, the secret is the private key
- *     of the key pair.
- *
- * @param {import('./typedef.js').SignOptions} [options] - JWT signing options
- *
- * For more options:
- * @see https://github.com/auth0/node-jsonwebtoken
- *
- * @returns {string} JsonWebToken
- */
-export function sign(
-  claims,
-  secretOrPrivateKey,
-  options={} )
-{
-  expect.object( claims );
-  expect.defined( secretOrPrivateKey );
-
-  if( options )
-  {
-    expect.object( options );
-  }
-  else {
-    options = {};
-  }
-
-  if( !('algorithm' in options) )
-  {
-    options.algorithm = DEFAULT_ALGORITHM;
-  }
-
-  if( !('expiresIn' in options) )
-  {
-    options.expiresIn = JWT_DEFAULT_EXPIRES_IN;
-  }
-  else if( !options.expiresIn )
-  {
-    delete options.expiresIn;
-  }
-
-  // @ts-ignore
-  return jwt.sign( claims, secretOrPrivateKey, options );
-}
-
-/**
- * Decode and verify a JWT token
- * - Forces the use of the algorithm specified in VERIFY_OPTIONS
- *
- * @param {string} token - A JWT token
- * @param {import('./typedef.js').Secret} secretOrPrivateKey
- *   The secret of private key to be used for decoding
- * @param {import('./typedef.js').VerifyOptions} [options=VERIFY_OPTIONS] - verify / decode options
- *
- * @returns {import('./typedef.js').JwtPayload} claims - The decoded JWT payload
- */
-export function verify( token, secretOrPrivateKey, options=VERIFY_OPTIONS )
-{
-  expect.notEmptyString( token );
-  expect.defined( secretOrPrivateKey );
-
-  if( !('algorithms' in options) )
-  {
-    options.algorithms = VERIFY_OPTIONS.algorithms;
-  }
-
-  try {
-    // @ts-ignore
-    const decoded = jwt.verify( token, secretOrPrivateKey, options );
-
-    return decoded;
-  }
-  catch( e )
-  {
-    //
-    // Cast internal jsonwebtoken errors to Error types defined in this lib
-    //
-    throw castJwtError(e);
-  }
-}

package/dist/constants/index.d.ts

@@ -1,6 +0,0 @@
-export * as bases from "./bases/index.js";
-export * as http from "./http/index.js";
-export * as mime from "./mime/index.js";
-export * as regexp from "./regexp/index.js";
-export * as states from "./states/index.js";
-export * as time from "./time/index.js";

package/dist/constants/index.js

@@ -1,6 +0,0 @@
-export * as bases from './bases/index.js';
-export * as http from './http/index.js';
-export * as mime from './mime/index.js';
-export * as regexp from './regexp/index.js';
-export * as states from './states/index.js';
-export * as time from './time/index.js';