@myko.pk/response 1.0.0

package/dist/builders/response.builder.js

@@ -0,0 +1,313 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/response.constants.ts
+var HTTP_STATUS = {
+  OK: 200,
+  CREATED: 201,
+  ACCEPTED: 202,
+  NO_CONTENT: 204,
+  MULTI_STATUS: 207,
+  FOUND: 302,
+  BAD_REQUEST: 400
+};
+var RESPONSE_MESSAGES = {
+  SUCCESS: "Success",
+  CREATED: "Created successfully",
+  ACCEPTED: "Request accepted",
+  NO_CONTENT: "No content",
+  UPDATED: "Updated successfully",
+  DELETED: "Deleted successfully",
+  PARTIAL_SUCCESS: "Partially successful",
+  REDIRECTING: "Redirecting",
+  FILE_READY: "File ready for download"
+};
+
+// src/builders/response.builder.ts
+var ResponseBuilder = class {
+  static {
+    __name(this, "ResponseBuilder");
+  }
+  /**
+   * Build a success response
+   * @template T - Type of response data
+   * @param data - Response data
+   * @param message - Success message
+   * @param statusCode - HTTP status code
+   * @param requestId - Request tracking ID for correlation
+   * @returns ApiResponse with success data
+   */
+  static success(data, message = RESPONSE_MESSAGES.SUCCESS, statusCode = HTTP_STATUS.OK, requestId) {
+    return {
+      success: true,
+      statusCode,
+      message,
+      data,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      requestId
+    };
+  }
+  /**
+   * Shorthand success response with no data payload (e.g. status-only endpoints)
+   * @param message - Success message
+   * @param statusCode - HTTP status code
+   * @param requestId - Request tracking ID for correlation
+   * @returns ApiResponse with no data field
+   */
+  static ok(message = RESPONSE_MESSAGES.SUCCESS, statusCode = HTTP_STATUS.OK, requestId) {
+    return {
+      success: true,
+      statusCode,
+      message,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      requestId
+    };
+  }
+  /**
+   * Build an error response
+   * @param message - Error message
+   * @param code - Error code for categorization
+   * @param statusCode - HTTP status code
+   * @param details - Additional error details
+   * @param requestId - Request tracking ID for correlation
+   * @returns ApiResponse with error information
+   */
+  static error(message, code, statusCode = HTTP_STATUS.BAD_REQUEST, details, requestId) {
+    return {
+      success: false,
+      statusCode,
+      message,
+      error: {
+        code,
+        details
+      },
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      requestId
+    };
+  }
+  /**
+   * Build a paginated response
+   * @template T - Type of array items
+   * @param data - Array of items
+   * @param total - Total number of items available
+   * @param page - Current page number
+   * @param limit - Items per page
+   * @param message - Success message
+   * @param statusCode - HTTP status code
+   * @param requestId - Request tracking ID for correlation
+   * @returns PaginatedResponse with pagination metadata
+   */
+  static paginated(data, total, page, limit, message = RESPONSE_MESSAGES.SUCCESS, statusCode = HTTP_STATUS.OK, requestId) {
+    const pages = Math.ceil(total / limit);
+    return {
+      success: true,
+      statusCode,
+      message,
+      data,
+      pagination: {
+        total,
+        page,
+        limit,
+        pages
+      },
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      requestId
+    };
+  }
+  /**
+   * Build a cursor-based paginated response for infinite-scroll / "load more" patterns
+   * @template T - Type of array items
+   * @param data - Array of items for the current page
+   * @param total - Total number of items available
+   * @param nextCursor - Cursor string for the next page
+   * @param hasNextPage - Whether more items exist after this page
+   * @param limit - Items per page
+   * @param message - Success message
+   * @param statusCode - HTTP status code
+   * @param requestId - Request tracking ID for correlation
+   * @returns CursorPaginatedResponse with cursor metadata
+   */
+  static cursorPaginated(data, total, nextCursor, hasNextPage, limit, previousCursor, hasPreviousPage, message = RESPONSE_MESSAGES.SUCCESS, statusCode = HTTP_STATUS.OK, requestId) {
+    return {
+      success: true,
+      statusCode,
+      message,
+      data,
+      pagination: {
+        total,
+        nextCursor,
+        previousCursor,
+        hasNextPage,
+        hasPreviousPage: hasPreviousPage ?? false,
+        limit
+      },
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      requestId
+    };
+  }
+  /**
+   * Build a created (201) response
+   * @template T - Type of response data
+   * @param data - Created resource data
+   * @param message - Success message
+   * @param requestId - Request tracking ID for correlation
+   * @returns ApiResponse with 201 status code
+   */
+  static created(data, message = RESPONSE_MESSAGES.CREATED, requestId) {
+    return this.success(data, message, HTTP_STATUS.CREATED, requestId);
+  }
+  /**
+   * Build an accepted (202) response for async operations
+   * @template T - Type of response data
+   * @param data - Response data (optional)
+   * @param message - Success message
+   * @param requestId - Request tracking ID for correlation
+   * @returns ApiResponse with 202 status code
+   */
+  static accepted(data, message = RESPONSE_MESSAGES.ACCEPTED, requestId) {
+    return this.success(data, message, HTTP_STATUS.ACCEPTED, requestId);
+  }
+  /**
+   * Build a no content (204) response
+   * @param message - Success message
+   * @param requestId - Request tracking ID for correlation
+   * @returns ApiResponse with 204 status code
+   */
+  static noContent(message = RESPONSE_MESSAGES.NO_CONTENT, requestId) {
+    return {
+      success: true,
+      statusCode: HTTP_STATUS.NO_CONTENT,
+      message,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      requestId
+    };
+  }
+  /**
+   * Response for successful update operations
+   * @param data - Updated resource data
+   * @param message - Success message
+   * @param requestId - Request tracking ID
+   */
+  static updated(data, message = RESPONSE_MESSAGES.UPDATED, requestId) {
+    return this.success(data, message, HTTP_STATUS.OK, requestId);
+  }
+  /**
+   * Response for successful delete operations
+   * @param message - Success message
+   * @param requestId - Request tracking ID
+   */
+  static deleted(message = RESPONSE_MESSAGES.DELETED, requestId) {
+    return {
+      success: true,
+      statusCode: HTTP_STATUS.OK,
+      message,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      requestId
+    };
+  }
+  /**
+   * Response for bulk operations (create, update, delete multiple)
+   * @param succeeded - Number of successful operations
+   * @param failed - Number of failed operations
+   * @param total - Total operations attempted
+   * @param requestId - Request tracking ID
+   */
+  static bulkOperation(succeeded, failed, total, requestId) {
+    const message = failed === 0 ? `All ${total} operations completed successfully` : `${succeeded} succeeded, ${failed} failed out of ${total} operations`;
+    return {
+      success: failed === 0,
+      statusCode: failed === 0 ? HTTP_STATUS.OK : HTTP_STATUS.MULTI_STATUS,
+      message,
+      data: {
+        succeeded,
+        failed,
+        total
+      },
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      requestId
+    };
+  }
+  /**
+   * Response for partial success scenarios
+   * @param data - Partial data that was processed
+   * @param message - Message describing the partial success
+   * @param requestId - Request tracking ID
+   */
+  static partialSuccess(data, message = RESPONSE_MESSAGES.PARTIAL_SUCCESS, requestId) {
+    return {
+      success: true,
+      statusCode: HTTP_STATUS.MULTI_STATUS,
+      message,
+      data,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      requestId
+    };
+  }
+  /**
+   * Response for redirect operations
+   * @param url - Redirect URL
+   * @param statusCode - HTTP status code (301, 302, 307, 308)
+   * @param message - Redirect message
+   * @param requestId - Request tracking ID
+   */
+  static redirect(url, statusCode = HTTP_STATUS.FOUND, message = RESPONSE_MESSAGES.REDIRECTING, requestId) {
+    return {
+      success: true,
+      statusCode,
+      message,
+      data: { url },
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      requestId
+    };
+  }
+  /**
+   * Response for file download operations
+   * @param filename - Name of the file being downloaded
+   * @param size - File size in bytes
+   * @param mimeType - MIME type of the file
+   * @param requestId - Request tracking ID
+   */
+  static fileDownload(filename, size, mimeType, requestId) {
+    return {
+      success: true,
+      statusCode: HTTP_STATUS.OK,
+      message: RESPONSE_MESSAGES.FILE_READY,
+      data: {
+        filename,
+        size,
+        mimeType
+      },
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      requestId
+    };
+  }
+  /**
+   * Response for import/export operations
+   * @param processed - Number of records processed
+   * @param imported - Number of records imported
+   * @param skipped - Number of records skipped
+   * @param errors - Array of error messages
+   * @param requestId - Request tracking ID
+   */
+  static importExport(processed, imported, skipped, errors = [], requestId) {
+    const hasErrors = errors.length > 0;
+    const message = hasErrors ? `Imported ${imported} records with ${errors.length} errors` : `Successfully imported ${imported} records`;
+    return {
+      success: !hasErrors,
+      statusCode: hasErrors ? HTTP_STATUS.MULTI_STATUS : HTTP_STATUS.OK,
+      message,
+      data: {
+        processed,
+        imported,
+        skipped,
+        errors: hasErrors ? errors : void 0
+      },
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      requestId
+    };
+  }
+};
+
+export { ResponseBuilder };
+//# sourceMappingURL=response.builder.js.map
+//# sourceMappingURL=response.builder.js.map

package/dist/builders/response.builder.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/response.constants.ts","../../src/builders/response.builder.ts"],"names":[],"mappings":"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","file":"response.builder.js","sourcesContent":["export const RESPONSE_FILTERS = {\n  GLOBAL: 'global',\n  VALIDATION: 'validation',\n  HTTP: 'http',\n  DATABASE: 'database',\n  AUTH: 'auth',\n} as const;\n\nexport const HTTP_STATUS = {\n  OK: 200,\n  CREATED: 201,\n  ACCEPTED: 202,\n  NO_CONTENT: 204,\n  MULTI_STATUS: 207,\n  FOUND: 302,\n  BAD_REQUEST: 400,\n} as const;\n\nexport const RESPONSE_MESSAGES = {\n  SUCCESS: 'Success',\n  CREATED: 'Created successfully',\n  ACCEPTED: 'Request accepted',\n  NO_CONTENT: 'No content',\n  UPDATED: 'Updated successfully',\n  DELETED: 'Deleted successfully',\n  PARTIAL_SUCCESS: 'Partially successful',\n  REDIRECTING: 'Redirecting',\n  FILE_READY: 'File ready for download',\n} as const;\n","import { ApiResponse, PaginatedResponse, CursorPaginatedResponse } from '../types';\nimport { HTTP_STATUS, RESPONSE_MESSAGES } from '../response.constants';\nimport { responseContext } from '../response.context';\n\nexport class ResponseBuilder {\n  /**\n   * Build a success response\n   * @template T - Type of response data\n   * @param data - Response data\n   * @param message - Success message\n   * @param statusCode - HTTP status code\n   * @param requestId - Request tracking ID for correlation\n   * @returns ApiResponse with success data\n   */\n  static success<T = any>(\n    data: T,\n    message: string = RESPONSE_MESSAGES.SUCCESS,\n    statusCode: number = HTTP_STATUS.OK,\n    requestId?: string\n  ): ApiResponse<T> {\n    return {\n      success: true,\n      statusCode,\n      message,\n      data,\n      timestamp: new Date().toISOString(),\n      requestId,\n    };\n  }\n\n  /**\n   * Shorthand success response with no data payload (e.g. status-only endpoints)\n   * @param message - Success message\n   * @param statusCode - HTTP status code\n   * @param requestId - Request tracking ID for correlation\n   * @returns ApiResponse with no data field\n   */\n  static ok(\n    message: string = RESPONSE_MESSAGES.SUCCESS,\n    statusCode: number = HTTP_STATUS.OK,\n    requestId?: string\n  ): ApiResponse {\n    return {\n      success: true,\n      statusCode,\n      message,\n      timestamp: new Date().toISOString(),\n      requestId,\n    };\n  }\n\n  /**\n   * Build an error response\n   * @param message - Error message\n   * @param code - Error code for categorization\n   * @param statusCode - HTTP status code\n   * @param details - Additional error details\n   * @param requestId - Request tracking ID for correlation\n   * @returns ApiResponse with error information\n   */\n  static error(\n    message: string,\n    code: string,\n    statusCode: number = HTTP_STATUS.BAD_REQUEST,\n    details?: string,\n    requestId?: string\n  ): ApiResponse {\n    return {\n      success: false,\n      statusCode,\n      message,\n      error: {\n        code,\n        details,\n      },\n      timestamp: new Date().toISOString(),\n      requestId,\n    };\n  }\n\n  /**\n   * Build a paginated response\n   * @template T - Type of array items\n   * @param data - Array of items\n   * @param total - Total number of items available\n   * @param page - Current page number\n   * @param limit - Items per page\n   * @param message - Success message\n   * @param statusCode - HTTP status code\n   * @param requestId - Request tracking ID for correlation\n   * @returns PaginatedResponse with pagination metadata\n   */\n  static paginated<T = any>(\n    data: T[],\n    total: number,\n    page: number,\n    limit: number,\n    message: string = RESPONSE_MESSAGES.SUCCESS,\n    statusCode: number = HTTP_STATUS.OK,\n    requestId?: string\n  ): PaginatedResponse<T> {\n    const pages = Math.ceil(total / limit);\n    return {\n      success: true,\n      statusCode,\n      message,\n      data,\n      pagination: {\n        total,\n        page,\n        limit,\n        pages,\n      },\n      timestamp: new Date().toISOString(),\n      requestId,\n    };\n  }\n\n  /**\n   * Build a cursor-based paginated response for infinite-scroll / \"load more\" patterns\n   * @template T - Type of array items\n   * @param data - Array of items for the current page\n   * @param total - Total number of items available\n   * @param nextCursor - Cursor string for the next page\n   * @param hasNextPage - Whether more items exist after this page\n   * @param limit - Items per page\n   * @param message - Success message\n   * @param statusCode - HTTP status code\n   * @param requestId - Request tracking ID for correlation\n   * @returns CursorPaginatedResponse with cursor metadata\n   */\n  static cursorPaginated<T = any>(\n    data: T[],\n    total: number,\n    nextCursor: string | undefined,\n    hasNextPage: boolean,\n    limit: number,\n    previousCursor?: string,\n    hasPreviousPage?: boolean,\n    message: string = RESPONSE_MESSAGES.SUCCESS,\n    statusCode: number = HTTP_STATUS.OK,\n    requestId?: string\n  ): CursorPaginatedResponse<T> {\n    return {\n      success: true,\n      statusCode,\n      message,\n      data,\n      pagination: {\n        total,\n        nextCursor,\n        previousCursor,\n        hasNextPage,\n        hasPreviousPage: hasPreviousPage ?? false,\n        limit,\n      },\n      timestamp: new Date().toISOString(),\n      requestId,\n    };\n  }\n\n  /**\n   * Build a created (201) response\n   * @template T - Type of response data\n   * @param data - Created resource data\n   * @param message - Success message\n   * @param requestId - Request tracking ID for correlation\n   * @returns ApiResponse with 201 status code\n   */\n  static created<T = any>(\n    data: T,\n    message: string = RESPONSE_MESSAGES.CREATED,\n    requestId?: string\n  ): ApiResponse<T> {\n    return this.success(data, message, HTTP_STATUS.CREATED, requestId);\n  }\n\n  /**\n   * Build an accepted (202) response for async operations\n   * @template T - Type of response data\n   * @param data - Response data (optional)\n   * @param message - Success message\n   * @param requestId - Request tracking ID for correlation\n   * @returns ApiResponse with 202 status code\n   */\n  static accepted<T = any>(\n    data: T,\n    message: string = RESPONSE_MESSAGES.ACCEPTED,\n    requestId?: string\n  ): ApiResponse<T> {\n    return this.success(data, message, HTTP_STATUS.ACCEPTED, requestId);\n  }\n\n  /**\n   * Build a no content (204) response\n   * @param message - Success message\n   * @param requestId - Request tracking ID for correlation\n   * @returns ApiResponse with 204 status code\n   */\n  static noContent(\n    message: string = RESPONSE_MESSAGES.NO_CONTENT,\n    requestId?: string\n  ): ApiResponse {\n    return {\n      success: true,\n      statusCode: HTTP_STATUS.NO_CONTENT,\n      message,\n      timestamp: new Date().toISOString(),\n      requestId,\n    };\n  }\n\n  /**\n   * Response for successful update operations\n   * @param data - Updated resource data\n   * @param message - Success message\n   * @param requestId - Request tracking ID\n   */\n  static updated<T = any>(\n    data: T,\n    message: string = RESPONSE_MESSAGES.UPDATED,\n    requestId?: string\n  ): ApiResponse<T> {\n    return this.success(data, message, HTTP_STATUS.OK, requestId);\n  }\n\n  /**\n   * Response for successful delete operations\n   * @param message - Success message\n   * @param requestId - Request tracking ID\n   */\n  static deleted(\n    message: string = RESPONSE_MESSAGES.DELETED,\n    requestId?: string\n  ): ApiResponse {\n    return {\n      success: true,\n      statusCode: HTTP_STATUS.OK,\n      message,\n      timestamp: new Date().toISOString(),\n      requestId,\n    };\n  }\n\n  /**\n   * Response for bulk operations (create, update, delete multiple)\n   * @param succeeded - Number of successful operations\n   * @param failed - Number of failed operations\n   * @param total - Total operations attempted\n   * @param requestId - Request tracking ID\n   */\n  static bulkOperation(\n    succeeded: number,\n    failed: number,\n    total: number,\n    requestId?: string\n  ): ApiResponse {\n    const message = failed === 0\n      ? `All ${total} operations completed successfully`\n      : `${succeeded} succeeded, ${failed} failed out of ${total} operations`;\n\n    return {\n      success: failed === 0,\n      statusCode: failed === 0 ? HTTP_STATUS.OK : HTTP_STATUS.MULTI_STATUS,\n      message,\n      data: {\n        succeeded,\n        failed,\n        total,\n      },\n      timestamp: new Date().toISOString(),\n      requestId,\n    };\n  }\n\n  /**\n   * Response for partial success scenarios\n   * @param data - Partial data that was processed\n   * @param message - Message describing the partial success\n   * @param requestId - Request tracking ID\n   */\n  static partialSuccess<T = any>(\n    data: T,\n    message: string = RESPONSE_MESSAGES.PARTIAL_SUCCESS,\n    requestId?: string\n  ): ApiResponse<T> {\n    return {\n      success: true,\n      statusCode: HTTP_STATUS.MULTI_STATUS,\n      message,\n      data,\n      timestamp: new Date().toISOString(),\n      requestId,\n    };\n  }\n\n  /**\n   * Response for redirect operations\n   * @param url - Redirect URL\n   * @param statusCode - HTTP status code (301, 302, 307, 308)\n   * @param message - Redirect message\n   * @param requestId - Request tracking ID\n   */\n  static redirect(\n    url: string,\n    statusCode: number = HTTP_STATUS.FOUND,\n    message: string = RESPONSE_MESSAGES.REDIRECTING,\n    requestId?: string\n  ): ApiResponse {\n    return {\n      success: true,\n      statusCode,\n      message,\n      data: { url },\n      timestamp: new Date().toISOString(),\n      requestId,\n    };\n  }\n\n  /**\n   * Response for file download operations\n   * @param filename - Name of the file being downloaded\n   * @param size - File size in bytes\n   * @param mimeType - MIME type of the file\n   * @param requestId - Request tracking ID\n   */\n  static fileDownload(\n    filename: string,\n    size: number,\n    mimeType: string,\n    requestId?: string\n  ): ApiResponse {\n    return {\n      success: true,\n      statusCode: HTTP_STATUS.OK,\n      message: RESPONSE_MESSAGES.FILE_READY,\n      data: {\n        filename,\n        size,\n        mimeType,\n      },\n      timestamp: new Date().toISOString(),\n      requestId,\n    };\n  }\n\n  /**\n   * Response for import/export operations\n   * @param processed - Number of records processed\n   * @param imported - Number of records imported\n   * @param skipped - Number of records skipped\n   * @param errors - Array of error messages\n   * @param requestId - Request tracking ID\n   */\n  static importExport(\n    processed: number,\n    imported: number,\n    skipped: number,\n    errors: string[] = [],\n    requestId?: string\n  ): ApiResponse {\n    const hasErrors = errors.length > 0;\n    const message = hasErrors\n      ? `Imported ${imported} records with ${errors.length} errors`\n      : `Successfully imported ${imported} records`;\n\n    return {\n      success: !hasErrors,\n      statusCode: hasErrors ? HTTP_STATUS.MULTI_STATUS : HTTP_STATUS.OK,\n      message,\n      data: {\n        processed,\n        imported,\n        skipped,\n        errors: hasErrors ? errors : undefined,\n      },\n      timestamp: new Date().toISOString(),\n      requestId,\n    };\n  }\n}\n"]}