franchiser.js

/*
Franchiser: Downloading and processing Financial Disclosure Documents (FDD's) for academic purposes.
Copyright (C) 2025 Alex Eski <alexeski at gmail dot com>

This file downloads FDDs from the California Department of Financial Protection & Innovation.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.
*/

const assert = require('node:assert');
const { chromium, devices } = require('playwright');

(async () => {
	console.log('Franchiser: setting up to download FDDs.');

	const browser = await chromium.launch();
	const context = await browser.newContext(devices['Desktop Chrome']);
	const page = await context.newPage();

	await page.goto('https://docqnet.dfpi.ca.gov/search/');
	assert(await page.title() == 'Search');

	console.log('Franchiser: starting to download FDDs.');

	for (const franchise of franchises) {
		try {
			assert(await page.title() == 'Search');
			console.log('Processing franchise ' + franchise);
			await page.locator('#MainContent_txtLegalName').fill(franchise);
			await page.locator('#MainContent_btnSearch').click();

			const searchResultsNotFound = await page.locator('#MainContent_SearchResults', { hasText: noSearchResultsText }).isVisible();

			if (searchResultsNotFound) {
				console.log('Skipping franchise ' + franchise + ' because no search results.')
				sleep();
				continue;
			}
			else {
				await page.locator('#MainContent_gvSearchResults_btnSelect_0').click();
				const download_promise = page.waitForEvent('download', { timeout: 30_000 });
				download_promise.catch(() => {
					console.log('Error downloading FDD for franchise ' + franchise);
				});
				if (await page.locator('#MainContent_SearchResults', { hasText: 'No documents found' }).isVisible()) {
					console.log('No documents found for ' + franchise);
					await page.getByRole('link', { name: 'Search', exact: true }).click();
					await sleep();
					continue;
				}
				const fdd_link = page.getByRole('link', { name: 'Franchise Disclosure Document', exact: true });
				if (await fdd_link.count() == 0) {
					console.log('No FDD found for ' + franchise);
					await page.getByRole('link', { name: 'Search', exact: true }).click();
					await sleep();
					continue;
				}
				if (!await fdd_link.first().isVisible()) {
					console.log('No FDD found for ' + franchise);
					await page.getByRole('link', { name: 'Search', exact: true }).click();
					await sleep();
					continue;
				}
				fdd_link.first().click();
				const download = await download_promise;
				await download.saveAs("C:/Users/Alex/source/repos/PersonalRepos/Franchiser/Data/" + franchise + '_' + download.suggestedFilename());
				await sleep();
				console.log('Downloaded FDD for franchise ' + franchise);
				await page.getByRole('link', { name: 'Search', exact: true }).click();
				await sleep();
			}
		}
		catch (error) {
			console.log('Error when processing franchise ' + franchise + ': ' + error);
			await page.getByRole('link', { name: 'Search', exact: true }).click();
			await sleep();
			continue;
		}
	}

	console.log('Franchiser finished!');
	exit();
})();


const noSearchResultsText = 'No Search results found for the selected criteria';

function sleep() {
	let min = Math.ceil(200);
	let max = Math.floor(1800);
	let ms = Math.floor(Math.random() * (max - min + 1)) + min;
	return new Promise(resolve => setTimeout(resolve, ms));
}

// more franchises located in other javascript files (i.e. franchises_one.js, franchises_two.js, etc.)
const franchises = ["Acai Express Superfood Bowls", "Accelerated Waste Solutions", "Access Garage Doors", "Ace Handyman Services", "Ace Pickleball Club", "Acti-Kare", "AeroWest", "AIM Mail Centers", "Aire Sery", "All County Property Management", "All Dry Services", "Allegra Marketing Print Mail", "Alloy Personal Training", "Aloha Poke Co", "Altered States Wellness", "The Alternative Board", "AmeriCare", "America's Color Consultants", "Americlnn by Wyndham", "Amide International Insurance", "Agency & FM0", "Anago Cleaning Systems", "Angelina Italian Bakery", "Angel Spa", "Angry Chickz", "Angry Crab Shack.", "Apex Leadership Co.", "A Place to Grow", "Apola Greek Grill", "Apricot Lane Boutique", "Archadeck Outdoor Living", "Aroma Joe's", "ASP-America's Swimming", "Pool Company", "As You Wish Lifestyle", "At Home Eldercare", "Atwell Suites", "AtWork Group", "Augusta Lawn Care Services", "Avanti Body", "avid hotels", "Awards of Happiness", "Aww Shucks", "B Bach to Rock", "Bahia Bowls Acai Cafe", "Balance Pan-Asian Grille", "Balensi Spa", "19 Cookies", "Barrel House", "Barrio Burrito Bar", "Barry Bagels", "Basecamp Fitness", "Bath Tune-Up", "Batteries Plus", "Batter Up Pancakes", "Baya Bar", "Baymont by Wyndham", "B.C. Pizza", "Beans & Brews", "Beauty Bungalows", "Beef-a-Roo", "Beef '0' Brady's Family Sports Pub", "beem Light Sauna", "Benny's Pizza", "Best Brains Learning Centers", "Best Option Restoration", "Between Rounds Bakery", "Sandwich Cafe", "Beyond Juicery + Eatery", "The Big Biscuit", "Big Chicken", "Big Frog Custom T-Shirts &More", "Big 0 Tires", "Blingle!", "bluefrog Plumbing + Drain", "Blue Kangaroo Packoutz", "Blue Margaritas", "Blushington", "Boba Nation", "Bodybar Pilates", "Body Fit Training", "Body20", "Bojangles", "Bonchon Korean Fried Chicken", "Boost Home Healthcare", "BooXkeeping", "Boss' Pizza and Chicken", "Boston's Pizza Restaurant & Sports Bar", "Bowled Healthy Food Company", "Brass Tap", "Brightway Insurance", "Brooklyn Robot Foundry", "Brunch", "Brush Masters Painting", "The B12 Store", "Bud's Place", "Buffalo's Cafe", "Bumble Bee Blinds", "Bumble Roofing", "The Bunny Hive", "Buona", "Burrito Shak", "Cabinet IQ", "Caffe Aronne", "Canopy by Hilton", "Canopy Lawn Care", "Captain Tony's Pizza & Pasta", "Emporium", "CareBuilders at Home", "Care with Love", "Carstar", "Carve!", "Celebree School", "Central Bark", "Century262", "Cereset", "Charleys Cheesesteaks & Wings", "Onetime", "Cheba Hut Toasted Subs", "Checkers and Rally's", "Cheeky Monkeys", "Chef It Upl/Chef It Upo!", "Chem-Dry Carpet & Upholstery Cleaning", "Chicken Salad Chick", "Chick N Max", "Children's Art Classes", "Children's Lighthouse", "Children's Orchard", "Chill-N Nitrogen Ice Cream", "Church's Texas Chicken", "Cicis Pizza", "Cilantro Taco Grill", "Cinch I.T.", "City Brew Tour", "Clean Eatz INF", "Space Place", "Clothes BD", "Club Pilate", "ClusterTruck", "College Hunks Junk & Moving", "Color Go", "Color World Paintrig", "Combo Brands", "Comet Cleaners", "ComForCare", "Complete Weddings & Events", "ComputerXplorers", "Concrete Craft", "Cookie Plug", "Cool-Binz", "Costa Oil", "The Coven", "CPA Moms", "CPR Cell Phone Repair", "Creatif", "Crestoorn", "Crispy Cores", "Digna Insurance", "Dill Dinkers", "Discover Strength", "District Taco", "Di Thurma Wellness and Recovery", "Dolce by Wyndham", "Donatos", "DonerHaus2", "Dl Training", "DonutNV", "Dope CFO Certified Advisor", "DoubleDave's Pizzaworks", "DoubleTree by Hilton", "Doughnuttery", "Drama Kids", "DreamMaker Bath & Kitchen", "Dream Vacations", "East Coast Wings + Grill", "ECHO Suites Extended Stay by Wyndham", "EcoGreen Lawn Care", "Eggs Up Grill", "Eiffel Waffle", "810 Billiards & Bowling", "Element by Westin", "Elevation Burger", "Elite Window Cleaning", "Ellianos Coffee", "Ellie Mental Health", "Elmer's Breakfast Lunch", "Dinner/Egg N' Joe", "El Pollo Loco", "Epic Health and Fitness", "Essential Speech and ABA Therapy", "Even Hotels", "Everbowl", "Everline Coatings and Services", "Every Detail Solar", "Executive Home Care", "Exit Factor", "Expedia Cruises", "Express Employment", "Professionals _172", "Eye Level Learning Centers", "F Face Foundrie", "Facial Mania Med Spa", "FairyTail Pet Care", "Fantastt Sarns Cut & Color", "Farm acres", "Ferox Ninja Park", "Fiesta Auto Insurance", "1st Inspection Services", "FirstLight Home Care", "Fish & Things Poke Bar", "Fish Window Cleaning", "Fit4Mom", "Fix Auto USA", "Flour Power Kids Cooking Studios", "Floyd's 99 Barbershop", "FlyLock Security Solutions", "Ford's Garage", "Fortune Personnel", "Founding Fathers Affordable Housing", "4Ever Young", "Fowling Warehouse", "Foxy Box", "Freckled Frog Dance Studio", "Freedom Fun USA", "FreeForm Chiropractic", "Freeway Insurance", "French Florist", "The French Workshop", "Fresh Coat Painters", "The Fresh Monkee", "Friendly's", "Frios Gourmet Pops", "Fuse HVAC & Apliance Repair", "Fyzal The' & Belem", "Cams", "GameDay Men's Health", "GarageExperts", "The Garage Floor Company", "Gatsby Glass", "Get A Grip Resurfacing", "Get In Shape For Women", "Get Up And Go Kayaking", "6-Force Parking Lot Striping", "Gigglewaters", "r3lo Tanning", "Glo30", "Glow Sauna Studios", "GoDog", "goGlow", "GoldenTrust Insurance", "Gone for Good", "Gong cha", "Goodcents", "Goodness Bowls", "The Good Pour", "Grain & Berry", "GrandStay Hotels", "Grand Welcome", "Granite Garage Floors", "Grasons Estate Sales & Business", "Liquidations", "The Gravity Vault", "Graze Craze", "GreatFlorida Insurance", "Great Harvest", "Green Food Solutions", "Greenlight Mobility", "Gregoire", "Groovy Hues", "Groucho's Deli", "Grumpy's Restaurant", "GW Gyro & Wings", "Gyro Republic", "Gyu-Kaku Japanese BBQ Restaurant", "Habit Burger & Grill", "Hampton by Hilton", "Hand & Stone Massage and Facial Spa", "Handel's Homemade Ice Cream", "H&H Bagels", "Hangry Joe's Hot Chicken & Wings", "Happy Cat Hotel & Spa", "Happy Joe's Pizza & Ice Cream", "HardTop Hotel", "Harlem Shake", "Hawaiian Bros Island Grill", "Hawaii Fluid Art", "Hawthorn Extended Stay by Wyndham", "HealthSource America's Chiropractor", "Heaven's Best Carpet & Upholstery Cleaning", "Hello Sugar", "Helping Hand Security", "Heroes Lawn Care", "The Highland Cleaning Company", "Hilton Hotels and Resorts", "Holiday Inn Express", "HomeCare Advocacy Network", "Home Helpers Home Care", "Home Instead", "HomeSmart", "HomeVestors of America", "Honest Abe Roofing.", "The Honey Baked Ham Co.", "Hoodz", "Hot Dog on a Stick", "HouseMaster Home Inspections", "Jinya Ramen Bar", "Hudson Valley Swim", "Joshua Tree Experts", "The Human Bean JPAR Real Estate", "Hummingbird Music School", "Hurricane Grill & Wings", "Hydrate IV Bar", "Hydrogen Fitness", "Icebox Cryotherapy", "Ice Cream Hut", "iCode School", "Ideal Siding", "iFlex Stretch Studios", "iFoam", "i4 Search Group", "Image One USA", "Image Studios", "Infinity, beyond fitness", "Iris Environmental Laboratories", "Iron Valley Real Estate", "ISI Elite Training", "iTan", "The IV Hub Wellness", "Ivybrook Academy", "Jamba", "Jan-Pro Cleaning & Disinfecting", "Jantize America", "Jars by Fabio Vivian", "JDI Cleaning Services", "Jeff's Bagel Run", "JEI Learning Center", "Jersey Mike's Subs", "Jet-Black/Yellow Dawg Striping", "Jimmy John'suice It Up!", "Junbi", "The Junkluggers", "Just Poke", "Keep Safe Care", "KeyGlee", "Kidokinetics", "KidStrong", "Kilwins", "King of Pops", "Kitchen Guard", "Kitchen Wise & Closet Wise", "The Knight School", "K9 Resorts Luxury Pet Hotel", "Koala Insulation", "Koibito Poke", "Krystal", "Kwik Kopy", "la Madeleine", "L&L Hawaiian Barbecue", "Lapels Cleaners", "La Quinta by Wyndham", "LaRosa's Pizzeria", "LashKind", "Launch Entertainment", "LaundroLab", "Lawn Pride", "Lawn Squad", "Layne's Chicken Fingers", "Leadership Management", "International Lean Kitchen", "The Leamina", "Early Edna", "Ledo Pizza", "Lee's Fatell", "Legato Lill", "Level Up Autt", "Liberty Tax", "Lime House", "Linden Creek", "Lindora", "Line-X", "Little Kickers", "Little Kitcher", "Little Medics", "Logan's Row", "Lumin Lash", "Ledgers", "Ledo Pizza", "Legally Tan", "Legato Living", "Links Golf Cafe", "Little Kickers", "Logan's Roadhouse", "Lumin Lash", "Made in the Shade", "MAD Greens", "Magnolia Soap and Bath Co", "Maha Juice Bar", "MaidThis Cleaning", "Mariam Coffee", "Marigold Academy", "Martinizing", "Mateo Tools", "Meals of Hope", "MediPlus Clinic", "Mcsaito Authority", "Mosquito Hunters & Humbug", "Holiday Lighting", "Motto by Hilton", "Movita Juice Bar", "Moxies", "MrAppliance", "MrCool", "Mr. Gatti's Pizza", "Mr. Rooter Plumbing", "Mulberrys Garment Care", "Murphy Business Sales", "My Beer Spa", "Naf Naf Grill", "National Academy of Athletics", "Native Grill & Wings", "Natural Rejuvenation MedSpa", "Nautical Boat Club", "Nautical Bowls", "Nevis Pack & Ship", "Negranti Creamery", "Neighborhood Barre", "NEST Protection Plan", "New Again Houses", "New Mom School", "New York Fries", "N-Hance Wood Refinishing", "Nick the Greek", "NinjaTrix", "NorthStar Moving Company", "The Now Massage", "Nurse Next Door Home", "Care Services", "NuSpine Chiropractic", "NutritionHQ", "N Zone Sports", "Office Pride Commercial", "Cleaning Services", "TheOfficeSquad", "ohDeer", "Ohm Fitness", "Old Chicago Pizza + Taproom", "1-800-Got-Junk?", "1-800-Plumber +Air", "1-800-Textiles", "One Hour Heating & Air Conditioning", "1-Tom-Plumber", "One You Love Homecare", "On The Hook Fish and Chips", "Onyva", "OrangeTheory Fitness", "The Original Rainbow Cone", "Orlando Cat Cafe", "OTA World", "Overlie Top Pita Overtime Athletics", "Paint Corps.", "Painter Bros", "Painterl", "Paint EZ", "Painting with a Twist", "Pak Mail", "The Pampered Peach Wax Bar", "Pancheros", "PapaJohns", "Papa Murphy's Take 'N' Bake Pizza", "Parcel Plus", "Pastanito", "PayMore", "Pecan Jacks", "Penn Station East Coast Subs", "Pepper Lunch", "Performance Painting", "Perkins American Food Co.", "Pestmaster", "petbar", "Peterbrooke Chocolatier", "Pet Evolution", "Pet Passages", "PetWellClinic", "Philly's Best Cheesesteaks", "Phoenix Drone Pros", "Pickleball Kingdom", "Pickleman's Gourmet Cafe", "Pillar To Post Home Inspectors", "Pinch A Penny Pool Patio Spa", "Pink Zebra Moving", "Pinspiration", "PIP Marketing, Signs, Print", "PIRTEK", "Pizza Inn", "Pokemoto", "Postal Annex+", "Postal Connections & iSold It", "PottyPro", "Powerflex Gym", "Precision Garage Door Service", "Precision Tune Auto Care", "PremierGarage", "Premier Pools &Spas", "Prepaze Academy", "Preserve Services", "Press Waffle Co.", "Prime IV Hydration & Wellness", "PrimoHoagies", "Prism Specialties", "Puff les", "Puparazzi Mobile Pet Spaw", "Pure Fitness", "Pure Green", "Pvolve", "Q QC Kinetix", "R Radiant Waxing", "Rainbow Restoration", "Rainbow Snow", "Rakkan Ramen", "Randy's Donuts", "Rapid Hose", "The Real Fobd Academy", "Realty One Group", "Red Barn Homebuyers", "redbox", "Red Mango Cafe & Juice Bar", "Registry Collection Hotels by Wyndham", "RE/MAX", "Renovation Sells", "Repicci's Real Italian", "Restoration Hardware", "Restore Hyper Wellness", "Richard's Painting", "Right Hand Senior Care", "Rise Southern Biscuits & Righteous Chicken", "Rita's Italian Ice & Frozen Custard", "Robeks Fresh Juices & Smoothies", "RoboThink", "Rocket Fizz Soda Pop and Candy Shop", "Rock N Roll Sushi", "Rocky Mountain Wraps", "Rolling Suds", "The Roof Resource", "Rooster & Rice", "RooterMan", "Roots Chicken Shak", "Roy Rogers Restaurants", "RSVP Direct Mail Advertising", "Rubbish Works", "Rumble Boxing", "Russo's New York Pizzeria & Italian Kitchen", "Rytech Restorations", "SaaviHome", "Sabai Thai Spa", "Safer Home Services", "SafeSplash Swim School", "Salad House", "Salad Station", "Salata Salad Kitchen", "Salons by JC", "Salty Dawg Pet Salon + Bakery", "Salty Paws Ice Cream Truck", "Sambazon Acai Bowls", "Sammy's Sliders", "Sam the Concrete Man", "Sandler Sanford Rose Associates", "Saunatica", "Savvy Sliders", "Scary Strokes", "Scenthound", "Schmackary's", "Scissors &Scotch", "Scoop Soldiers", "Sea Love", "Seasononsign", "sek Sauna Studio", "Send Me a Pro", "Serotonin Anti-Aging Centers", "ServiceMaster Clean", "ServiceMaster Restore", "Shake Shack", "Sharkey's Cuts For Kids", "Shawarma Press", "Sheenco Travel", "Shine", "Shipley Do-Nuts", "Shoot Indoors", "Shoppers Drapes & Blinds", "Shrunk 3D", "Signal", "Sign Gypsies", "Silver Bear Swim School", "Simply Cabinetry", "Singas Famous Pizza", "Sip Fresh", "Siri's Gourmet Burgers & Pizza", "Sir Speedy Print Signs Marketing", "Sit Means Sit Dog Training", "16 Handles", "Skedaddle Humane Wildlife Control", "Skinovatio Medical Spa", "Skyhawks & SuperTots Sports Academy", "SkyRun Vacation Rentals", "Sky Zone", "Slice House by Tony Gemignani", "Slick City Action Park", "Slim Chickens Slumberland Furniture", "Smalls Sliders", "Smokin' Oak Wood-Fired Pizza & Taproom", "Smoothie Factory + Kitchen", "Snapchef", "SnapHouss", "Snap-on Tools", "Soccer Stars", "Social Play Haus", "Softroc", "Sola Salons", "Sonny's BBQ", "Southern Steer Butcher", "Spark by Hilton", "Sparkle Squad", "Spavia Day Spa", "Special Strong", "Speed Pro", "Speed Queen", "Spherion Staffing & Recruiting", "The Spice &Tea Exchange", "Spoiled Rotten Photography", "Sport Clips Haircuts", "Spray Foam Genie.", "Spray-Net", "Spring-Green Lawn Care", "SpringHill Suites by Marriott", "Square Cow Moovers", "Stand Strong Fencing", "Starbird", "The Starz Program", "Statemint", "Steamoji", "STEM For Kids", "Sticks Kebob Shop", "Sticky Fingers Cooking", "StretchLab", "StretchMed", "Strickland Brothers 10 Minute Oil Change", "Sub-Ology", "Sub Zero", "Swensen's", "The Swing Bays", "Synergy HomeCare", "Taco Casa", "Taco Works", "Taffer's Tavern", "The Tailored Closet", "Take 5 Oil Change", "Talem Home Care & Placement Services", "Tapestry Collection by Hilton", "Tapster", "Tapville Social", "TeaCupFuls", "TM Up Athletics", "Techy", "Ternpo by Man", "Tams", "Toastique", "Tootl Transport", "Top Rail Fence", "Top This Chocolate", "Totaly Nu12", "Touching Hearts At Home", "Tousles Join", "The Tox", "Trademark Collection by Wyndham", "Travelin' Tom's Coffee", "TruBlue Home Service Ally", "True Install", "TrueNest Property Management", "True North Restoration", "True REST Spa", "Tryp by Wyndham", "Turbo Tint", "Tutuland", "Twinkle Star Dance Academy", "Twin Peaks Restaurant", "Two Maids", "UBuildlt", "Uncle Sharkii Poke Bar", "Unishigiers", "Slime", "Vanguard Key Clubs", "Vanity Fur", "Vara Juice", "Vegan District Asian Eatery", "VepoClean", "Vicious Biscuit", "Vicky Bakery", "Vignette Collection", "Village Idiot Pizza", "Vinny's Pizza & Wings", "VIO Med Spa", "Virgin Island Thyme", "Vital Care Infusion Services", "The Vital Stretch", "The Vitamin Shoppe", "voco hotels", "Voda Cleaning & Restoration", "Voodoo Brewing Co.", "VooDoo Wing Company", "Wagbar", "Wag N' Wash", "Walk-On's Sports Bistreaux", "Watch Broadband America", "Waters Edge Wineries", "WaveMax Laundry", "WCH Service Bureau", "Wed Society", "Weichert", "WePlay Music", "Window Gang", "Window Hero", "Wingers Restaurant & Atrium", "Wing It On!", "Wings and Rings", "Wing Snob", "Wingstop", "Wise Coatings", "W.O.L.F. Fitness Gyms", "Wonderly Lights", "Woodhouse Spa", "Woof Gang Bakery", "Woofie's", "Wyndham Garden", "Wyndham Grand", "XP League", "YogaSix", "Zaxbys", "Zebra Robotics", "Zen Massage", "Zoornil Grown", "Zorfortin"];