@kalutskii/foundation 0.6.25 → 0.7.1

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { SQL } from 'drizzle-orm';
 import { ErrorHandler, MiddlewareHandler, Context, TypedResponse } from 'hono';
 import { Locale } from 'date-fns';
-import z, { ZodObject, ZodRawShape, z as z$1 } from 'zod';
+import z$1, { z, ZodObject, ZodRawShape } from 'zod';
 import { SymmetricAlgorithm } from 'hono/utils/jwt/jwa';
 
 /**
@@ -66,6 +66,16 @@ declare function respond<T extends object = Record<string, never>, S extends Suc
     status: S;
     data?: T;
 }): Response & TypedResponse<APISuccess<T> | APIError, S, 'json'>;
+/**
+ * Responds with a file download, setting the appropriate headers for content disposition and type.
+ * Supports specifying a filename and optional content type, defaulting to 'application/octet-stream'.
+ */
+declare function fileRespond<S extends SuccessStatusCode>(c: Context, options: {
+    status: S;
+    content: ArrayBuffer;
+    filename: string;
+    contentType?: string;
+}): Response;
 
 /**
  * Factory for creating successful API responses with serializable data.
@@ -252,7 +262,7 @@ declare const zodBulkSelectionSchema: <const TIdentifierSchema extends z.ZodType
  * Shared bulk-selection payload produced by `zodBulkSelectionSchema`.
  * String identifiers are used by default for frontend table integrations.
  */
-type ZodBulkSelection<TIdentifier extends string | number = string> = z.infer<ReturnType<typeof zodBulkSelectionSchema<z.ZodType<TIdentifier>>>>;
+type ZodBulkSelection<TIdentifier extends string | number = string> = z$1.infer<ReturnType<typeof zodBulkSelectionSchema<z.ZodType<TIdentifier>>>>;
 /**
  * Explicit bulk selection containing only identifiers chosen by the client.
  * This branch does not require resolving an all-matching search snapshot.
@@ -283,11 +293,11 @@ type JWTSignOptions = {
 /**
  * Utility types for inferring payload types from Zod schemas.
  */
-type Payload<T> = T extends z.ZodType ? z.infer<T> : T;
+type Payload<T> = T extends z$1.ZodType ? z$1.infer<T> : T;
 /**
  * Utility type to extract the payload schema type from a Zod schema.
  * */
-type PayloadSchema<T> = T extends z.ZodType ? T : never;
+type PayloadSchema<T> = T extends z$1.ZodType ? T : never;
 
 /**
  * A service class for handling JWT operations with optional Zod schema validation for the payload.
@@ -341,7 +351,7 @@ declare const zodPaginationShape: {
  * TypeScript output produced after successful pagination validation.
  * Defaulted fields are represented as required numeric properties.
  */
-type ZodPaginationOptions = z.infer<typeof zodPaginationSchema>;
+type ZodPaginationOptions = z$1.infer<typeof zodPaginationSchema>;
 /**
  * Feature flags shared by both supported search schema composition modes.
  * Literal values are preserved in the resulting runtime and static shapes.
@@ -365,12 +375,12 @@ type ZodSearchFeatureOptions<TQueryEnabled extends boolean, TPaginationEnabled e
  * `filters` is the concise mode that applies partial and non-empty rules.
  * `whereSchema` accepts a fully prepared schema with custom Zod effects.
  */
-type ZodSearchSchemaOptions<TShape extends z.ZodRawShape = never, TWhereSchema extends z.ZodType<Record<string, unknown>> = never, TQueryEnabled extends boolean = true, TPaginationEnabled extends boolean = true> = ZodSearchFeatureOptions<TQueryEnabled, TPaginationEnabled> & ({
+type ZodSearchSchemaOptions<TShape extends z$1.ZodRawShape = never, TWhereSchema extends z$1.ZodType<Record<string, unknown>> = never, TQueryEnabled extends boolean = true, TPaginationEnabled extends boolean = true> = ZodSearchFeatureOptions<TQueryEnabled, TPaginationEnabled> & ({
     /**
      * Object schema whose fields become optional filters inside `where`.
      * The factory requires one defined value whenever `where` is present.
      */
-    filters: z.ZodObject<TShape>;
+    filters: z$1.ZodObject<TShape>;
     /** Prevents combining automatic filters with a prepared schema. */
     whereSchema?: never;
 } | {
@@ -470,7 +480,7 @@ type AtLeastOne<T, Keys extends keyof T = keyof T> = Keys extends keyof T ? Simp
  * zQuery(zodAtLeastOne(userSelectSchema)) // result: UserSelect ✓
  * ```
  */
-declare const zodAtLeastOne: <T extends ZodObject<ZodRawShape>>(schema: T) => z$1.ZodPipe<T, z$1.ZodTransform<Awaited<AtLeastOne<z$1.core.output<T>>>, z$1.core.output<T>>>;
+declare const zodAtLeastOne: <T extends ZodObject<ZodRawShape>>(schema: T) => z.ZodPipe<T, z.ZodTransform<Awaited<AtLeastOne<z.core.output<T>>>, z.core.output<T>>>;
 
 declare const parseQueryValue: (value: unknown) => unknown;
 /**
@@ -498,4 +508,4 @@ declare const asQuery: <T extends z.ZodTypeAny>(schema: T) => z.ZodPreprocess<T>
  */
 declare const isPlainObject: (value: unknown) => value is Record<string, unknown>;
 
-export { type APIContractData, type APIContractError, type APIContractResult, type APIError, type APISuccess, type AsQuery, type AtLeastOne, EXCEPTION_STATUS_CODES, type ExceptionStatusCode, type FetchResult, type JWTServiceOptions, type JWTSignOptions, type MeasuredExecution, type Payload, type PayloadSchema, type ReplaceDotsWithUnderscores, SUCCESS_STATUS_CODES, type Simplify, type StringEnumRecord, type SuccessStatusCode, type ZodBulkExcludeSelection, type ZodBulkIncludeSelection, type ZodBulkSelection, ZodJWTService, type ZodPaginationOptions, type ZodSearchSchemaOptions, asQuery, createStringEnumRecord, failure, fetchAndThrow, fetchSafely, formatTime, generateRandomString, getColoredHTTPStatus, getFormattedDate, getFormattedTime, getUTCOffset, getZonedTime, honoLoggingHandler, isPlainObject, log, measureExecutionTime, onHandlerError, parseQueryValue, respond, safeExecute, sqlWhere, success, zodAtLeastOne, zodBulkSelectionSchema, zodPaginationSchema, zodPaginationShape, zodSearchSchema };
+export { type APIContractData, type APIContractError, type APIContractResult, type APIError, type APISuccess, type AsQuery, type AtLeastOne, EXCEPTION_STATUS_CODES, type ExceptionStatusCode, type FetchResult, type JWTServiceOptions, type JWTSignOptions, type MeasuredExecution, type Payload, type PayloadSchema, type ReplaceDotsWithUnderscores, SUCCESS_STATUS_CODES, type Simplify, type StringEnumRecord, type SuccessStatusCode, type ZodBulkExcludeSelection, type ZodBulkIncludeSelection, type ZodBulkSelection, ZodJWTService, type ZodPaginationOptions, type ZodSearchSchemaOptions, asQuery, createStringEnumRecord, failure, fetchAndThrow, fetchSafely, fileRespond, formatTime, generateRandomString, getColoredHTTPStatus, getFormattedDate, getFormattedTime, getUTCOffset, getZonedTime, honoLoggingHandler, isPlainObject, log, measureExecutionTime, onHandlerError, parseQueryValue, respond, safeExecute, sqlWhere, success, zodAtLeastOne, zodBulkSelectionSchema, zodPaginationSchema, zodPaginationShape, zodSearchSchema };

package/dist/index.js

@@ -123,6 +123,11 @@ var honoLoggingHandler = async (c, next) => {
 function respond(c, options) {
   return c.json(success({ status: options.status, data: options.data ?? {} }), options.status);
 }
+function fileRespond(c, options) {
+  c.header("Content-Disposition", `attachment; filename="${options.filename}"`);
+  c.header("Content-Type", options.contentType ?? "application/octet-stream");
+  return c.body(options.content, options.status);
+}
 
 // src/http/http.constants.ts
 var SUCCESS_STATUS_CODES = [200, 201, 202, 307];
@@ -165,7 +170,7 @@ async function measureExecutionTime(execution) {
 }
 
 // src/zod-bulk/zod-bulk.schemas.ts
-import z from "zod";
+import { z } from "zod";
 var DEFAULT_ERROR_MESSAGE = "Selection identifiers must be provided.";
 var zodBulkSelectionSchema = ({ identifierSchema }) => {
   const identifiersSchema = z.array(identifierSchema).refine((identifiers) => new Set(identifiers).size === identifiers.length, {
@@ -227,7 +232,7 @@ var ZodJWTService = class {
 };
 
 // src/zod-search/zod-search.pagination.schemas.ts
-import z2 from "zod";
+import { z as z2 } from "zod";
 var zodPaginationSchema = z2.object({
   /**
    * Zero-based number of records skipped before collecting a result page.
@@ -243,7 +248,7 @@ var zodPaginationSchema = z2.object({
 var zodPaginationShape = zodPaginationSchema.shape;
 
 // src/zod-search/zod-search.schemas.ts
-import z3 from "zod";
+import { z as z3 } from "zod";
 
 // src/zod-validation/zod-validation.refiners.ts
 var DEFAULT_ERROR_MESSAGE2 = "Invalid input. At least one field must be provided.";
@@ -267,7 +272,7 @@ var zodSearchSchema = (options) => {
 };
 
 // src/zod-validation/zod-validation.parsing.ts
-import z4 from "zod";
+import { z as z4 } from "zod";
 
 // src/zod-validation/zod-validation.utilities.ts
 var isPlainObject = (value) => {
@@ -304,6 +309,7 @@ export {
   failure,
   fetchAndThrow,
   fetchSafely,
+  fileRespond,
   formatTime,
   generateRandomString,
   getColoredHTTPStatus,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kalutskii/foundation",
-  "version": "0.6.25",
+  "version": "0.7.1",
   "description": "Typescript collection of most common utilities, schemas and functions among private projects.",
   "type": "module",
   "repository": {
@@ -12,10 +12,10 @@
   },
   "scripts": {
     "build": "tsup",
+    "typecheck": "tsc --noEmit",
     "lint": "eslint . --ext .ts --fix",
     "format": "prettier --write .",
-    "test": "bun test",
-    "typecheck": "tsc --noEmit"
+    "test": "bun test"
   },
   "exports": {
     ".": {