@kalutskii/foundation 0.3.6 → 0.4.0

package/dist/index.d.ts

@@ -45,6 +45,8 @@ declare function failure({ status, error }: {
 declare function fetchSafely<TResult extends APIContractResult<unknown>>(fetcher: () => Promise<TResult>): Promise<FetchResult<APIContractData<TResult>>>;
 /** Resolves an APIContractResult fetcher, throwing an error if the result is an APIError. */
 declare function fetchAndThrow<TResult extends APIContractResult<unknown>>(fetcher: () => Promise<TResult>): Promise<APIContractData<TResult>>;
+/** Pure type guard for APIError responses, used to narrow the type of a response object. */
+declare function isErrorResponse<TResponse>(response: TResponse): response is TResponse & APIError;
 
 /**
  * Global error handler for Hono framework. Catches all exceptions thrown in route handlers and middlewares.
@@ -212,4 +214,4 @@ declare class ZodJWTService<TPayloadOrSchema> {
     verifyOrThrow(token: string, secret: string): Promise<Payload<TPayloadOrSchema>>;
 }
 
-export { type APIContractData, type APIContractError, type APIContractResult, type APIError, type APISuccess, EXCEPTION_STATUS_CODES, type ExceptionStatusCode, type FetchResult, type JWTServiceOptions, type JWTSignOptions, type Payload, type PayloadSchema, SUCCESS_STATUS_CODES, type SerializeDates, type SuccessStatusCode, type XOR, ZodJWTService, asQueryBoolean, asQueryNumber, failure, fetchAndThrow, fetchSafely, formatTime, generateRandomString, getColoredHTTPStatus, getFormattedDate, getFormattedTime, getUTCOffset, getZonedTime, honoLoggingHandler, log, onHandlerError, respond, safeExecute, success };
+export { type APIContractData, type APIContractError, type APIContractResult, type APIError, type APISuccess, EXCEPTION_STATUS_CODES, type ExceptionStatusCode, type FetchResult, type JWTServiceOptions, type JWTSignOptions, type Payload, type PayloadSchema, SUCCESS_STATUS_CODES, type SerializeDates, type SuccessStatusCode, type XOR, ZodJWTService, asQueryBoolean, asQueryNumber, failure, fetchAndThrow, fetchSafely, formatTime, generateRandomString, getColoredHTTPStatus, getFormattedDate, getFormattedTime, getUTCOffset, getZonedTime, honoLoggingHandler, isErrorResponse, log, onHandlerError, respond, safeExecute, success };

package/dist/index.js

@@ -23,6 +23,14 @@ async function fetchAndThrow(fetcher) {
     throw new Error(response.error);
   return response.data;
 }
+function isErrorResponse(response) {
+  if (typeof response !== "object" || response === null)
+    return false;
+  if (!("kind" in response) || !("status" in response))
+    return false;
+  const { kind, status } = response;
+  return kind === "error" && (typeof status === "number" || typeof status === "string");
+}
 
 // src/hono/hono.execution.ts
 import { HTTPException } from "hono/http-exception";
@@ -223,6 +231,7 @@ export {
   getUTCOffset,
   getZonedTime,
   honoLoggingHandler,
+  isErrorResponse,
   log,
   onHandlerError,
   respond,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kalutskii/foundation",
-  "version": "0.3.6",
+  "version": "0.4.0",
   "description": "Typescript collection of most common utilities, schemas and functions among private projects.",
   "type": "module",
   "repository": {