OwlFlow

Appearance

Changelog ​

OwlFlow 1.6.0 ​

Release Date: July 22, 2026 Native Registration, Outbox Worker & Conditional Domains

✨ New Features ​

  • Idempotent Registration: createUser now honors the Idempotency-Key header — a retried request (timeout, double submit) returns the original result instead of failing on a duplicate account.
  • Registration Inputs: CreateUserInput accepts coregs (co-registration offers), redemptionCode (prepaid order codes that activate a subscription on signup), and referrer (referral rewards) — see the User Management examples.
  • Pet Trait Collection & Scholarship Booster: Profiles can now store pet traits, unlocking booster scholarship support.
  • Add to Calendar: Scholarship deadlines can be exported to calendars.
  • Free-text Mapping: New mutation maps free-text input to structured profile data.
  • List Pagination: Added pagination to dashboard list pages, plus updated easy-apply scholarship queries.
  • MSI List Enhancements: Added requirementSummary, lazily-fetched statusTimeline, updateStatusV2, totalAmount, amountsList, and a typed derivedStatus enum for scholarship and application lists.

🛠️ Fixes & Improvements ​

  • Refresh Token Grace Window: refreshToken accepts expired JWTs within a 7-day grace window.
  • Timezone Correctness: All dates are now consistently handled as UTC; fixed dateApplied losing its timezone offset.
  • Submitted Tab Fixes: Corrected winner counts on submitted cards, submitted status-update sorting, and excluded expired scholarships from the started tab.
  • Dashboard Sorting & Filters: Fixed credibility sorting, requirement filtering, external scholarship ids, and easy-apply page sorting.

OwlFlow 1.5.0 ​

Release Date: April 15, 2026 Application Strategy, Cap Urgency & Analytics

✨ New Features ​

  • Users Analytics: Added DB-backed admin analytics query, schema, and resolvers for user analytics tracking.
  • Cap Urgency: Added applicationCap and capUrgency fields to Scholarship type in GraphQL schema to support cap-based urgency logic.
  • Application Strategy Health: Added application strategy health metrics and active applications filter.
  • GraphQL Logging: Implemented GraphQL logging middleware and enhanced consistent error handling across resolvers.

🛠️ Fixes & Improvements ​

  • Filtering Enhancements: Enhanced ScholarshipDataSource with additional filtering capabilities and clean search input.
  • CapUrgency Enum: Fixed CapUrgency enum to match Core's lowercase values.
  • Essay Similarity: Added aiGeneratedText field to ApplicationRequirementInput for similarity scoring.
  • Essay Generation Context: Added users answers to essay generation.
  • Scholarship List Tests: Enhanced GraphQL schema and queries for scholarships and applications.

OwlFlow 1.4.0 ​

Release Date: February 16, 2026 Essay Personalization & AI Logic Migration

✨ New Features ​

  • Essay Personalization: Added essay personalization features to GraphQL schema and resolvers, including generated questions for personalized essay content.
  • AI Essay Generation Proxy: Integrated essay generation logic through an OwlFlow proxy mutation, migrating AI logic into the API layer.

🛠️ Fixes & Improvements ​

  • Essay Topics Resolver: Fixed essayTopics resolver.

OwlFlow 1.3.0 ​

Release Date: February 11, 2026 Text Editor Parity, Phone Validation & Dictionary Enhancements

✨ New Features ​

  • Requirement Text Parity: Added RequirementText.scholarship schema field with datasource extraction and resolver, requirement query declaration, and source field on ApplicationRequirementInput for text editor parity.
  • Recommended Applied Count: Added recommendedAppliedCount field and deprecated recommendedNotSeenCount for clearer analytics.
  • Phone E.164 Validation: Added phone utility functions with E.164 normalization, throwing validation errors on invalid formats.

🛠️ Fixes & Improvements ​

  • Ignored Scholarships: Excluded ignored scholarships from counts and queries so they no longer skew statistics.
  • Dictionary Enhancements: Enhanced DictionaryService and GraphQL resolvers with improved public access.
  • Viewer Fallback: Fixed Scholarship.viewer fallback for bare scholarship objects.
  • Snapshot Status Fix: Fixed ScholarshipApplicationSnapshot application status mapping.
  • Build & Environment: Updated build script and environment configurations.

OwlFlow 1.2.0 ​

Release Date: January 16, 2026 Production Launch, Eligibility Mappings & Requirement Filtering

✨ New Features ​

  • ScholarshipApplicationSnapshot: Implemented new query for retrieving a full snapshot of a scholarship application with all its requirements.
  • Application Preview: Added support for viewing completed requirements before the application is submitted.
  • Requirement Type Filtering: Added INCLUDE/EXCLUDE filtering modes and search term for scholarship requirement types.
  • Eligibility Mappings: Added eligibility mappings for Career Goal, Enrolled in College, and school level fields.
  • Winner Announcement Date: Added winnerAnnouncementDate field to scholarship details.

🏗️ Schema Changes ​

  • Schema File Separation: Separated the monolithic schema file into domain-specific schema files.
  • School Level Rename: Renamed highSchoolLevel to schoolLevel with proper field mapping.
  • Country Default: Hardcoded country to USA for profile consistency.

🚀 Production Deployment ​

  • Pod Scaling: Optimized production pod count.

🛠️ Fixes & Improvements ​

  • Special Eligibility Validation: Fixed special eligibility validation in the apply mutation.
  • Survey Indexing: Fixed 0-based indexing for modern survey options.
  • Double Apply Prevention: Prevented duplicate application submissions after success.
  • Profile Update: Fixed profile update edge cases.
  • Scholarship List: Optimized scholarship list query performance.
  • Submit Applications: Fixed the application submission flow.

OwlFlow 1.1.0 ​

Release Date: January 9, 2026 Schema Refinements, New Fields & Paginated Search

✨ New Features ​

  • Paginated Scholarship Search: Added GraphQL endpoint for paginated scholarship search.
  • Application & Credibility Fields: Added applicationCount and credibility fields to scholarship queries.
  • Hybrid Dictionaries: Implemented hybrid dictionaries with human-readable values and enums.
  • Gender Field: Implemented gender on the account object.
  • Missing Endpoints: Implemented previously missing API endpoints for feature parity.

🏗️ Schema Improvements ​

  • Type Corrections: Fixed Account to use proper Ethnicity and CareerGoal types.
  • Requirements Refactor: Refactored requirements management with a dedicated RequirementTransformer class.
  • Registration Fix: Corrected the endpoint used for account registration.
  • Education & Address: Fixed and improved Education and Address schemas.
  • Schema Cleanup: Removed deprecated acceptedTerms, acceptedPrivacy, acceptedMarketing, and recaptchaToken fields. Refactored scholarship schema and resolvers for clarity.

🛠️ Fixes & Improvements ​

  • GeoData State Name: Fixed state not returning the state name in Query.references.geoData.
  • Login Validation: Return proper error message on login validation response.
  • Application Queries: Fixed querying submitted application requirements and application status.

OwlFlow 1.0.0 ​

Release Date: December 30, 2025 Bun + Yoga Migration, Performance Improvements & Core Infrastructure

🚀 Core Architecture & Infrastructure ​

  • Bun + Yoga Migration: Migrated the entire server from Node.js/Express to Bun and GraphQL Yoga for improved performance and developer experience.
  • Bun.serve Integration: Rebuilt the server initialization logic to leverage Bun.serve natively.
  • Docker & Build Optimization: Updated Docker configuration and documentation build processes for the new Bun-based architecture.

✨ New Features ​

  • Exchange Cookie API: Added exchangeCookie API to support legacy session synchronization.

🛠️ Fixes & Improvements ​

  • Login & Token Management: Enhanced login error handling with requestId logging.
  • Eligible Scholarships: Fixed issues in the eligible scholarships list retrieval.
  • Documentation System: Replaced the documentation generator with a more robust solution.
  • Cleanup: Removed redundant documentation and playground endpoints from the /partner path.

OwlFlow 0.5.0 ​

Release Date: December 30, 2025 API Documentation, Recommended Scholarships & Schema Improvements

📚 Documentation ​

  • VitePress Documentation: Implemented comprehensive API documentation using VitePress with improved styling and navigation.
  • Entity Documentation: Added documentation for most GraphQL entities including guides and examples.

✨ New Features ​

  • Recommended Scholarships: Implemented personalized scholarship recommendations for users.
  • Public Scholarship Access: Added public scholarship retrieval by ID via slug redirect for anonymous users.
  • Enhanced User Profile: Added stateName and address2 fields to user profile updates with improved address formatting.
  • Winner Deadline Field: Added deadline field to scholarship winners query for better tracking.

🏗️ Schema Improvements ​

  • Winner Data Structure: Refactored scholarship winner data structure - removed accountId and scholarshipId, introduced linked scholarship object, and consolidated winnerName into name.
  • Standardized Error Handling: Implemented consistent error handling patterns across the project.
  • REST API Enhancements: Added isStarted filter for scholarship list and enhanced viewer context handling.

🛠️ Fixes & Improvements ​

  • Scholarship Stats: Fixed scholarship count stats calculation.
  • Provider Details: Fixed provider details and field mapping issues.
  • Lint Improvements: Optimized linting to only check staged files for faster commits.
  • Additional Tests: Implemented additional Bruno tests for various edge cases.

OwlFlow 0.4.0 ​

Release Date: December 28, 2025 Full API Reshape, Data Loaders & Expanded Testing

🏗️ API Structure Reshape ​

  • Domain Consolidation: Major refactor to consolidate legacy endpoints into the scholarships namespace and streamline the API root tree.
  • Viewer & Winner Domains: Reshaped the API for viewer, winner, and scholarships to align with the new clean architecture.
  • Authentication Streamlining: Refactored authentication logic and implemented JWT usage.
  • Gateway Integration: Implemented Google API Gateway integration and fixed non-gateway request logic.

🚀 Performance & Infrastructure ​

  • Data Loaders: Implemented the Data Loader pattern for legacy, user, and dictionary data sources to solve N+1 query issues and improve performance.
  • Pre-commit Hooks: Added Husky for pre-commit testing hooks to ensure code quality before pushing.
  • Coverage Testing: Implemented coverage-based testing infrastructure.

🛠️ Fixes & Improvements ​

  • Submission Fixes: Resolved issues with special eligibility submission and survey requirements.
  • Dictionary Endpoint: Fixed dictionary endpoint behavior.
  • Linting: Addressed ESLint errors in resolvers and improved type safety.
  • Zod & Linter: Fixed Zod linter errors and type definitions.
  • MCP Verification: Added tests to verify MCP usage.

OwlFlow 0.3.0 ​

Release Date: December 19, 2025 Infrastructure Modernization, Expanded Testing & Scholarship Features

🚀 Core Architecture & Infrastructure ​

  • Package Manager Migration: Fully replaced npm with pnpm for faster and more efficient dependency management.
  • Build System Optimization: Removed nodemon and consolidated build/start processes into cleaner package.json scripts.
  • Deployment Improvements: Enhanced deployment steps for better reliability.

🧪 Testing & Quality ​

  • Legacy API Testing: Added comprehensive tests using brunocovering the legacy API endpoints to ensure regression safety.
  • Testing Framework: Integrated testing infrastructure (Vitest) and added initial test coverage.

OwlFlow 0.2.0 ​

Release Date: December 17, 2025 Scholarship Statistics & Requirements Engine

✨ New Features ​

  • Scholarship Stats: Implemented statistical analysis for scholarships (SC-90), providing richer data insights.
  • Requirements Implementation: Added full support for scholarship application requirements, enabling more complex application flows.

🛠️ Fixes & Improvements ​

  • Sorting & Filters: Resolved critical issues with scholarship sorting and filtering logic to ensure accurate search results.
  • Linter Fixes: Addressed various linter errors to improve code quality and maintainability.
  • Testing: Added initial testing infrastructure for the new features.
  • Deployment: Improve deploy step.

OwlFlow 0.1.0 ​

Release Date: November 11, 2025 Deployment Pipelines & Schema Refactoring

🚀 Infrastructure & Deployment ​

  • Kubernetes Integration: Finalized migration to Kubernetes for scalable container orchestration.

🏗️ Architecture ​

  • Schema Refactoring: Major refactor of the GraphQL schema to align with clean architecture principles.
  • Service Implementation: Implemented core Scholarship Service and expanded mock data coverage for development.
  • Postman Tests: Merged comprehensive Postman test collection for API validation.

OwlFlow 0.0.1 ​

Release Date: October 15, 2025 Initial Release & Legacy Integration

🎉 Initial Release ​

  • Project Launch: Initial release of OwlFlow, the modern GraphQL API for ScholarshipOwl.
  • Legacy Bridge: Implemented "Legacy Bridge" adapters to connect with the existing PHP backend services.

🧪 Quality Assurance ​

  • Test Coverage: Added extensive tests for legacy API endpoints including Login, User Applications, and Scholarship details.
  • Introspection Fixes: Resolved issues with GraphQL introspection queries to support development tools.

OwlFlow Developer Portal

Copyright © 2025 ScholarshipOwl