@kalutskii/foundation 0.7.0 → 0.7.2

package/README.md

@@ -288,4 +288,6 @@ bun run lint
 bun run test
 bun run typecheck
 bun run build
+
+just quality-assurance
 ```

package/dist/index.d.ts

@@ -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: Uint8Array<ArrayBuffer>;
+    filename: string;
+    contentType?: string;
+}): Response;
 
 /**
  * Factory for creating successful API responses with serializable data.
@@ -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];
@@ -304,6 +309,7 @@ export {
   failure,
   fetchAndThrow,
   fetchSafely,
+  fileRespond,
   formatTime,
   generateRandomString,
   getColoredHTTPStatus,

package/package.json

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