@apifreaks/openapi-specs 0.1.0 → 0.1.1

package/dist/index.cjs

@@ -24,6 +24,8 @@ __export(index_exports, {
   SPECS_BY_CATEGORY: () => SPECS_BY_CATEGORY,
   SPEC_CATEGORIES: () => SPEC_CATEGORIES,
   SPEC_SLUGS: () => SPEC_SLUGS,
+  SpecCategory: () => SpecCategory,
+  SpecSlug: () => SpecSlug,
   getSpec: () => getSpec,
   getSpecsByCategory: () => getSpecsByCategory
 });
@@ -44644,6 +44646,133 @@ var SPECS_BY_CATEGORY = {
   "whois": ["asn-lookup", "bulk-whois-lookup", "domain-whois-history-lookup", "reverse-whois", "whois-domain-lookup", "whois-ip-lookup"],
   "zip-code": ["bulk-zip-code-lookup", "zip-code-api", "zip-code-distance-match", "zip-code-distance", "zip-codes-by-city", "zip-codes-by-region", "zip-codes-radius-search"]
 };
+var SpecSlug = {
+  ADMINISTRATIVE_UNITS: "administrative-units",
+  ADMINISTRATIVE_UNITS_DETAILS: "administrative-units-details",
+  ADMINISTRATIVE_UNITS_LEVELS: "administrative-units-levels",
+  AIR_QUALITY: "air-quality",
+  ASN_LOOKUP: "asn-lookup",
+  ASTRONOMY_DATA: "astronomy-data",
+  BULK_DNS_LOOKUP: "bulk-dns-lookup",
+  BULK_DOMAIN_CHECKER: "bulk-domain-checker",
+  BULK_EMAIL_VALIDATION: "bulk-email-validation",
+  BULK_IP_LOOKUP: "bulk-ip-lookup",
+  BULK_IP_THREAT_INTELLIGENCE: "bulk-ip-threat-intelligence",
+  BULK_LIVE_WEATHER: "bulk-live-weather",
+  BULK_PHONE_NUMBER_VALIDATION: "bulk-phone-number-validation",
+  BULK_SCREENSHOT: "bulk-screenshot",
+  BULK_USER_AGENT_PARSER: "bulk-user-agent-parser",
+  BULK_VAT_RATES_COUNTRY: "bulk-vat-rates-country",
+  BULK_WHOIS_LOOKUP: "bulk-whois-lookup",
+  BULK_ZIP_CODE_LOOKUP: "bulk-zip-code-lookup",
+  CITIES: "cities",
+  COMMODITY_FLUCTUATION: "commodity-fluctuation",
+  COMMODITY_PRICES: "commodity-prices",
+  COMMODITY_SYMBOLS: "commodity-symbols",
+  COMMODITY_TIME_SERIES: "commodity-time-series",
+  COUNTRIES: "countries",
+  COUNTRIES_DETAILS: "countries-details",
+  CURRENCY_CONVERTER: "currency-converter",
+  CURRENCY_FLUCTUATION: "currency-fluctuation",
+  CURRENCY_HISTORICAL_DATA_LIMIT: "currency-historical-data-limit",
+  CURRENCY_RATE: "currency-rate",
+  CURRENCY_SUPPORTED: "currency-supported",
+  CURRENCY_SYMBOLS: "currency-symbols",
+  CURRENCY_TIME_SERIES: "currency-time-series",
+  DELETE_PDF_PAGE: "delete-pdf-page",
+  DNS_HISTORY_LOOKUP: "dns-history-lookup",
+  DNS_LOOKUP: "dns-lookup",
+  DOMAIN_SEARCH: "domain-search",
+  DOMAIN_SEARCH_WITH_SUGGESTIONS: "domain-search-with-suggestions",
+  DOMAIN_WHOIS_HISTORY_LOOKUP: "domain-whois-history-lookup",
+  EMAIL_CHECKER: "email-checker",
+  FINANCIAL_APIS_SUPPORTED_COUNTRIES: "financial-apis-supported-countries",
+  FLAGS: "flags",
+  FLAGS_SUPPORTED: "flags-supported",
+  FLOOD_FORECAST: "flood-forecast",
+  FORWARD_GEOCODING: "forward-geocoding",
+  GEOLOCALIZED_CURRENCY_CONVERSION: "geolocalized-currency-conversion",
+  HISTORICAL_COMMODITY_PRICES: "historical-commodity-prices",
+  HISTORICAL_CURRENCY_CONVERTER: "historical-currency-converter",
+  HISTORICAL_CURRENCY_RATE: "historical-currency-rate",
+  HISTORICAL_WEATHER: "historical-weather",
+  IBAN_VALIDATION: "iban-validation",
+  IP_LOCATOR: "ip-locator",
+  IP_THREAT_INTELLIGENCE: "ip-threat-intelligence",
+  LINEARIZE_PDF: "linearize-pdf",
+  LIVE_WEATHER: "live-weather",
+  MARINE_WEATHER: "marine-weather",
+  MERGE_PDF: "merge-pdf",
+  PDF_COMPRESS: "pdf-compress",
+  PDF_DECRYPT: "pdf-decrypt",
+  PDF_ENCRYPT: "pdf-encrypt",
+  PDF_EXTRACT_PAGES: "pdf-extract-pages",
+  PDF_FILE: "pdf-file",
+  PDF_FILE_STATUS: "pdf-file-status",
+  PDF_FILES: "pdf-files",
+  PDF_RESOURCE_DOWNLOAD: "pdf-resource-download",
+  PDF_RESOURCE_UPLOAD: "pdf-resource-upload",
+  PDF_RESOURCE_UPLOAD_BINARY: "pdf-resource-upload-binary",
+  PDF_RESTRICT: "pdf-restrict",
+  PDF_SPLIT_PAGES: "pdf-split-pages",
+  PDF_TASK_STATUS: "pdf-task-status",
+  PDF_TO_IMAGE: "pdf-to-image",
+  PDF_UNRESTRICT: "pdf-unrestrict",
+  PHONE_NUMBER_VALIDATION: "phone-number-validation",
+  REGIONS: "regions",
+  REVERSE_DNS_LOOKUP: "reverse-dns-lookup",
+  REVERSE_GEOCODING: "reverse-geocoding",
+  REVERSE_WHOIS: "reverse-whois",
+  ROTATE_PDF_PAGES: "rotate-pdf-pages",
+  SSL_CERTIFICATE_CHAIN_LOOKUP: "ssl-certificate-chain-lookup",
+  SSL_CERTIFICATE_LOOKUP: "ssl-certificate-lookup",
+  SUBDOMAIN_LOOKUP: "subdomain-lookup",
+  SUBREGIONS: "subregions",
+  SWIFT_CODE_FINDER: "swift-code-finder",
+  SWIFT_CODE_LOOKUP: "swift-code-lookup",
+  TIME_SERIES_WEATHER: "time-series-weather",
+  TIMEZONE_CONVERTER: "timezone-converter",
+  TIMEZONE_LOOKUP: "timezone-lookup",
+  USAGE_CREDITS: "usage-credits",
+  USER_AGENT_PARSER: "user-agent-parser",
+  VAT_NUMBER_VALIDATION: "vat-number-validation",
+  VAT_RATES_BY_IP: "vat-rates-by-ip",
+  VAT_RATES_COUNTRY: "vat-rates-country",
+  WEATHER_FORECAST: "weather-forecast",
+  WEB_SCRAPER: "web-scraper",
+  WEBSITE_SCREENSHOT: "website-screenshot",
+  WHOIS_DOMAIN_LOOKUP: "whois-domain-lookup",
+  WHOIS_IP_LOOKUP: "whois-ip-lookup",
+  ZIP_CODE_API: "zip-code-api",
+  ZIP_CODE_DISTANCE: "zip-code-distance",
+  ZIP_CODE_DISTANCE_MATCH: "zip-code-distance-match",
+  ZIP_CODES_BY_CITY: "zip-codes-by-city",
+  ZIP_CODES_BY_REGION: "zip-codes-by-region",
+  ZIP_CODES_RADIUS_SEARCH: "zip-codes-radius-search"
+};
+var SpecCategory = {
+  COMMODITY: "commodity",
+  CURRENCY: "currency",
+  DNS: "dns",
+  DOMAIN: "domain",
+  EMAIL_VALIDATION: "email-validation",
+  FINANCIAL: "financial",
+  GENERAL: "general",
+  GEOCODING: "geocoding",
+  GEODB: "geodb",
+  IP_INTELLIGENCE: "ip-intelligence",
+  OTHER: "other",
+  PDF: "pdf",
+  PHONE_VALIDATION: "phone-validation",
+  SCRAPER: "scraper",
+  SCREENSHOT: "screenshot",
+  SSL: "ssl",
+  TIMEZONE: "timezone",
+  USER_AGENT: "user-agent",
+  WEATHER: "weather",
+  WHOIS: "whois",
+  ZIP_CODE: "zip-code"
+};
 
 // src/index.ts
 function getSpec(slug) {
@@ -44658,6 +44787,8 @@ function getSpecsByCategory(category) {
   SPECS_BY_CATEGORY,
   SPEC_CATEGORIES,
   SPEC_SLUGS,
+  SpecCategory,
+  SpecSlug,
   getSpec,
   getSpecsByCategory
 });

package/dist/index.d.cts

@@ -23,8 +23,145 @@ declare const SPECS: Record<string, OpenAPISpec>;
 declare const SPEC_SLUGS: string[];
 declare const SPEC_CATEGORIES: string[];
 declare const SPECS_BY_CATEGORY: Record<string, string[]>;
+/**
+ * Enumerated spec slugs. Import and reference these instead of raw strings —
+ * if a spec file is renamed or removed, the corresponding key disappears here
+ * and every usage in a host app fails to compile instead of failing silently at runtime.
+ */
+declare const SpecSlug: {
+    readonly ADMINISTRATIVE_UNITS: "administrative-units";
+    readonly ADMINISTRATIVE_UNITS_DETAILS: "administrative-units-details";
+    readonly ADMINISTRATIVE_UNITS_LEVELS: "administrative-units-levels";
+    readonly AIR_QUALITY: "air-quality";
+    readonly ASN_LOOKUP: "asn-lookup";
+    readonly ASTRONOMY_DATA: "astronomy-data";
+    readonly BULK_DNS_LOOKUP: "bulk-dns-lookup";
+    readonly BULK_DOMAIN_CHECKER: "bulk-domain-checker";
+    readonly BULK_EMAIL_VALIDATION: "bulk-email-validation";
+    readonly BULK_IP_LOOKUP: "bulk-ip-lookup";
+    readonly BULK_IP_THREAT_INTELLIGENCE: "bulk-ip-threat-intelligence";
+    readonly BULK_LIVE_WEATHER: "bulk-live-weather";
+    readonly BULK_PHONE_NUMBER_VALIDATION: "bulk-phone-number-validation";
+    readonly BULK_SCREENSHOT: "bulk-screenshot";
+    readonly BULK_USER_AGENT_PARSER: "bulk-user-agent-parser";
+    readonly BULK_VAT_RATES_COUNTRY: "bulk-vat-rates-country";
+    readonly BULK_WHOIS_LOOKUP: "bulk-whois-lookup";
+    readonly BULK_ZIP_CODE_LOOKUP: "bulk-zip-code-lookup";
+    readonly CITIES: "cities";
+    readonly COMMODITY_FLUCTUATION: "commodity-fluctuation";
+    readonly COMMODITY_PRICES: "commodity-prices";
+    readonly COMMODITY_SYMBOLS: "commodity-symbols";
+    readonly COMMODITY_TIME_SERIES: "commodity-time-series";
+    readonly COUNTRIES: "countries";
+    readonly COUNTRIES_DETAILS: "countries-details";
+    readonly CURRENCY_CONVERTER: "currency-converter";
+    readonly CURRENCY_FLUCTUATION: "currency-fluctuation";
+    readonly CURRENCY_HISTORICAL_DATA_LIMIT: "currency-historical-data-limit";
+    readonly CURRENCY_RATE: "currency-rate";
+    readonly CURRENCY_SUPPORTED: "currency-supported";
+    readonly CURRENCY_SYMBOLS: "currency-symbols";
+    readonly CURRENCY_TIME_SERIES: "currency-time-series";
+    readonly DELETE_PDF_PAGE: "delete-pdf-page";
+    readonly DNS_HISTORY_LOOKUP: "dns-history-lookup";
+    readonly DNS_LOOKUP: "dns-lookup";
+    readonly DOMAIN_SEARCH: "domain-search";
+    readonly DOMAIN_SEARCH_WITH_SUGGESTIONS: "domain-search-with-suggestions";
+    readonly DOMAIN_WHOIS_HISTORY_LOOKUP: "domain-whois-history-lookup";
+    readonly EMAIL_CHECKER: "email-checker";
+    readonly FINANCIAL_APIS_SUPPORTED_COUNTRIES: "financial-apis-supported-countries";
+    readonly FLAGS: "flags";
+    readonly FLAGS_SUPPORTED: "flags-supported";
+    readonly FLOOD_FORECAST: "flood-forecast";
+    readonly FORWARD_GEOCODING: "forward-geocoding";
+    readonly GEOLOCALIZED_CURRENCY_CONVERSION: "geolocalized-currency-conversion";
+    readonly HISTORICAL_COMMODITY_PRICES: "historical-commodity-prices";
+    readonly HISTORICAL_CURRENCY_CONVERTER: "historical-currency-converter";
+    readonly HISTORICAL_CURRENCY_RATE: "historical-currency-rate";
+    readonly HISTORICAL_WEATHER: "historical-weather";
+    readonly IBAN_VALIDATION: "iban-validation";
+    readonly IP_LOCATOR: "ip-locator";
+    readonly IP_THREAT_INTELLIGENCE: "ip-threat-intelligence";
+    readonly LINEARIZE_PDF: "linearize-pdf";
+    readonly LIVE_WEATHER: "live-weather";
+    readonly MARINE_WEATHER: "marine-weather";
+    readonly MERGE_PDF: "merge-pdf";
+    readonly PDF_COMPRESS: "pdf-compress";
+    readonly PDF_DECRYPT: "pdf-decrypt";
+    readonly PDF_ENCRYPT: "pdf-encrypt";
+    readonly PDF_EXTRACT_PAGES: "pdf-extract-pages";
+    readonly PDF_FILE: "pdf-file";
+    readonly PDF_FILE_STATUS: "pdf-file-status";
+    readonly PDF_FILES: "pdf-files";
+    readonly PDF_RESOURCE_DOWNLOAD: "pdf-resource-download";
+    readonly PDF_RESOURCE_UPLOAD: "pdf-resource-upload";
+    readonly PDF_RESOURCE_UPLOAD_BINARY: "pdf-resource-upload-binary";
+    readonly PDF_RESTRICT: "pdf-restrict";
+    readonly PDF_SPLIT_PAGES: "pdf-split-pages";
+    readonly PDF_TASK_STATUS: "pdf-task-status";
+    readonly PDF_TO_IMAGE: "pdf-to-image";
+    readonly PDF_UNRESTRICT: "pdf-unrestrict";
+    readonly PHONE_NUMBER_VALIDATION: "phone-number-validation";
+    readonly REGIONS: "regions";
+    readonly REVERSE_DNS_LOOKUP: "reverse-dns-lookup";
+    readonly REVERSE_GEOCODING: "reverse-geocoding";
+    readonly REVERSE_WHOIS: "reverse-whois";
+    readonly ROTATE_PDF_PAGES: "rotate-pdf-pages";
+    readonly SSL_CERTIFICATE_CHAIN_LOOKUP: "ssl-certificate-chain-lookup";
+    readonly SSL_CERTIFICATE_LOOKUP: "ssl-certificate-lookup";
+    readonly SUBDOMAIN_LOOKUP: "subdomain-lookup";
+    readonly SUBREGIONS: "subregions";
+    readonly SWIFT_CODE_FINDER: "swift-code-finder";
+    readonly SWIFT_CODE_LOOKUP: "swift-code-lookup";
+    readonly TIME_SERIES_WEATHER: "time-series-weather";
+    readonly TIMEZONE_CONVERTER: "timezone-converter";
+    readonly TIMEZONE_LOOKUP: "timezone-lookup";
+    readonly USAGE_CREDITS: "usage-credits";
+    readonly USER_AGENT_PARSER: "user-agent-parser";
+    readonly VAT_NUMBER_VALIDATION: "vat-number-validation";
+    readonly VAT_RATES_BY_IP: "vat-rates-by-ip";
+    readonly VAT_RATES_COUNTRY: "vat-rates-country";
+    readonly WEATHER_FORECAST: "weather-forecast";
+    readonly WEB_SCRAPER: "web-scraper";
+    readonly WEBSITE_SCREENSHOT: "website-screenshot";
+    readonly WHOIS_DOMAIN_LOOKUP: "whois-domain-lookup";
+    readonly WHOIS_IP_LOOKUP: "whois-ip-lookup";
+    readonly ZIP_CODE_API: "zip-code-api";
+    readonly ZIP_CODE_DISTANCE: "zip-code-distance";
+    readonly ZIP_CODE_DISTANCE_MATCH: "zip-code-distance-match";
+    readonly ZIP_CODES_BY_CITY: "zip-codes-by-city";
+    readonly ZIP_CODES_BY_REGION: "zip-codes-by-region";
+    readonly ZIP_CODES_RADIUS_SEARCH: "zip-codes-radius-search";
+};
+type SpecSlugValue = (typeof SpecSlug)[keyof typeof SpecSlug];
+/**
+ * Enumerated spec categories, same rename-safety guarantee as SpecSlug.
+ */
+declare const SpecCategory: {
+    readonly COMMODITY: "commodity";
+    readonly CURRENCY: "currency";
+    readonly DNS: "dns";
+    readonly DOMAIN: "domain";
+    readonly EMAIL_VALIDATION: "email-validation";
+    readonly FINANCIAL: "financial";
+    readonly GENERAL: "general";
+    readonly GEOCODING: "geocoding";
+    readonly GEODB: "geodb";
+    readonly IP_INTELLIGENCE: "ip-intelligence";
+    readonly OTHER: "other";
+    readonly PDF: "pdf";
+    readonly PHONE_VALIDATION: "phone-validation";
+    readonly SCRAPER: "scraper";
+    readonly SCREENSHOT: "screenshot";
+    readonly SSL: "ssl";
+    readonly TIMEZONE: "timezone";
+    readonly USER_AGENT: "user-agent";
+    readonly WEATHER: "weather";
+    readonly WHOIS: "whois";
+    readonly ZIP_CODE: "zip-code";
+};
+type SpecCategoryValue = (typeof SpecCategory)[keyof typeof SpecCategory];
 
-declare function getSpec(slug: string): OpenAPISpec | undefined;
-declare function getSpecsByCategory(category: string): string[];
+declare function getSpec(slug: SpecSlugValue | (string & {})): OpenAPISpec | undefined;
+declare function getSpecsByCategory(category: SpecCategoryValue | (string & {})): string[];
 
-export { type OpenAPISpec, SPECS, SPECS_BY_CATEGORY, SPEC_CATEGORIES, SPEC_SLUGS, getSpec, getSpecsByCategory };
+export { type OpenAPISpec, SPECS, SPECS_BY_CATEGORY, SPEC_CATEGORIES, SPEC_SLUGS, SpecCategory, type SpecCategoryValue, SpecSlug, type SpecSlugValue, getSpec, getSpecsByCategory };

package/dist/index.d.ts

@@ -23,8 +23,145 @@ declare const SPECS: Record<string, OpenAPISpec>;
 declare const SPEC_SLUGS: string[];
 declare const SPEC_CATEGORIES: string[];
 declare const SPECS_BY_CATEGORY: Record<string, string[]>;
+/**
+ * Enumerated spec slugs. Import and reference these instead of raw strings —
+ * if a spec file is renamed or removed, the corresponding key disappears here
+ * and every usage in a host app fails to compile instead of failing silently at runtime.
+ */
+declare const SpecSlug: {
+    readonly ADMINISTRATIVE_UNITS: "administrative-units";
+    readonly ADMINISTRATIVE_UNITS_DETAILS: "administrative-units-details";
+    readonly ADMINISTRATIVE_UNITS_LEVELS: "administrative-units-levels";
+    readonly AIR_QUALITY: "air-quality";
+    readonly ASN_LOOKUP: "asn-lookup";
+    readonly ASTRONOMY_DATA: "astronomy-data";
+    readonly BULK_DNS_LOOKUP: "bulk-dns-lookup";
+    readonly BULK_DOMAIN_CHECKER: "bulk-domain-checker";
+    readonly BULK_EMAIL_VALIDATION: "bulk-email-validation";
+    readonly BULK_IP_LOOKUP: "bulk-ip-lookup";
+    readonly BULK_IP_THREAT_INTELLIGENCE: "bulk-ip-threat-intelligence";
+    readonly BULK_LIVE_WEATHER: "bulk-live-weather";
+    readonly BULK_PHONE_NUMBER_VALIDATION: "bulk-phone-number-validation";
+    readonly BULK_SCREENSHOT: "bulk-screenshot";
+    readonly BULK_USER_AGENT_PARSER: "bulk-user-agent-parser";
+    readonly BULK_VAT_RATES_COUNTRY: "bulk-vat-rates-country";
+    readonly BULK_WHOIS_LOOKUP: "bulk-whois-lookup";
+    readonly BULK_ZIP_CODE_LOOKUP: "bulk-zip-code-lookup";
+    readonly CITIES: "cities";
+    readonly COMMODITY_FLUCTUATION: "commodity-fluctuation";
+    readonly COMMODITY_PRICES: "commodity-prices";
+    readonly COMMODITY_SYMBOLS: "commodity-symbols";
+    readonly COMMODITY_TIME_SERIES: "commodity-time-series";
+    readonly COUNTRIES: "countries";
+    readonly COUNTRIES_DETAILS: "countries-details";
+    readonly CURRENCY_CONVERTER: "currency-converter";
+    readonly CURRENCY_FLUCTUATION: "currency-fluctuation";
+    readonly CURRENCY_HISTORICAL_DATA_LIMIT: "currency-historical-data-limit";
+    readonly CURRENCY_RATE: "currency-rate";
+    readonly CURRENCY_SUPPORTED: "currency-supported";
+    readonly CURRENCY_SYMBOLS: "currency-symbols";
+    readonly CURRENCY_TIME_SERIES: "currency-time-series";
+    readonly DELETE_PDF_PAGE: "delete-pdf-page";
+    readonly DNS_HISTORY_LOOKUP: "dns-history-lookup";
+    readonly DNS_LOOKUP: "dns-lookup";
+    readonly DOMAIN_SEARCH: "domain-search";
+    readonly DOMAIN_SEARCH_WITH_SUGGESTIONS: "domain-search-with-suggestions";
+    readonly DOMAIN_WHOIS_HISTORY_LOOKUP: "domain-whois-history-lookup";
+    readonly EMAIL_CHECKER: "email-checker";
+    readonly FINANCIAL_APIS_SUPPORTED_COUNTRIES: "financial-apis-supported-countries";
+    readonly FLAGS: "flags";
+    readonly FLAGS_SUPPORTED: "flags-supported";
+    readonly FLOOD_FORECAST: "flood-forecast";
+    readonly FORWARD_GEOCODING: "forward-geocoding";
+    readonly GEOLOCALIZED_CURRENCY_CONVERSION: "geolocalized-currency-conversion";
+    readonly HISTORICAL_COMMODITY_PRICES: "historical-commodity-prices";
+    readonly HISTORICAL_CURRENCY_CONVERTER: "historical-currency-converter";
+    readonly HISTORICAL_CURRENCY_RATE: "historical-currency-rate";
+    readonly HISTORICAL_WEATHER: "historical-weather";
+    readonly IBAN_VALIDATION: "iban-validation";
+    readonly IP_LOCATOR: "ip-locator";
+    readonly IP_THREAT_INTELLIGENCE: "ip-threat-intelligence";
+    readonly LINEARIZE_PDF: "linearize-pdf";
+    readonly LIVE_WEATHER: "live-weather";
+    readonly MARINE_WEATHER: "marine-weather";
+    readonly MERGE_PDF: "merge-pdf";
+    readonly PDF_COMPRESS: "pdf-compress";
+    readonly PDF_DECRYPT: "pdf-decrypt";
+    readonly PDF_ENCRYPT: "pdf-encrypt";
+    readonly PDF_EXTRACT_PAGES: "pdf-extract-pages";
+    readonly PDF_FILE: "pdf-file";
+    readonly PDF_FILE_STATUS: "pdf-file-status";
+    readonly PDF_FILES: "pdf-files";
+    readonly PDF_RESOURCE_DOWNLOAD: "pdf-resource-download";
+    readonly PDF_RESOURCE_UPLOAD: "pdf-resource-upload";
+    readonly PDF_RESOURCE_UPLOAD_BINARY: "pdf-resource-upload-binary";
+    readonly PDF_RESTRICT: "pdf-restrict";
+    readonly PDF_SPLIT_PAGES: "pdf-split-pages";
+    readonly PDF_TASK_STATUS: "pdf-task-status";
+    readonly PDF_TO_IMAGE: "pdf-to-image";
+    readonly PDF_UNRESTRICT: "pdf-unrestrict";
+    readonly PHONE_NUMBER_VALIDATION: "phone-number-validation";
+    readonly REGIONS: "regions";
+    readonly REVERSE_DNS_LOOKUP: "reverse-dns-lookup";
+    readonly REVERSE_GEOCODING: "reverse-geocoding";
+    readonly REVERSE_WHOIS: "reverse-whois";
+    readonly ROTATE_PDF_PAGES: "rotate-pdf-pages";
+    readonly SSL_CERTIFICATE_CHAIN_LOOKUP: "ssl-certificate-chain-lookup";
+    readonly SSL_CERTIFICATE_LOOKUP: "ssl-certificate-lookup";
+    readonly SUBDOMAIN_LOOKUP: "subdomain-lookup";
+    readonly SUBREGIONS: "subregions";
+    readonly SWIFT_CODE_FINDER: "swift-code-finder";
+    readonly SWIFT_CODE_LOOKUP: "swift-code-lookup";
+    readonly TIME_SERIES_WEATHER: "time-series-weather";
+    readonly TIMEZONE_CONVERTER: "timezone-converter";
+    readonly TIMEZONE_LOOKUP: "timezone-lookup";
+    readonly USAGE_CREDITS: "usage-credits";
+    readonly USER_AGENT_PARSER: "user-agent-parser";
+    readonly VAT_NUMBER_VALIDATION: "vat-number-validation";
+    readonly VAT_RATES_BY_IP: "vat-rates-by-ip";
+    readonly VAT_RATES_COUNTRY: "vat-rates-country";
+    readonly WEATHER_FORECAST: "weather-forecast";
+    readonly WEB_SCRAPER: "web-scraper";
+    readonly WEBSITE_SCREENSHOT: "website-screenshot";
+    readonly WHOIS_DOMAIN_LOOKUP: "whois-domain-lookup";
+    readonly WHOIS_IP_LOOKUP: "whois-ip-lookup";
+    readonly ZIP_CODE_API: "zip-code-api";
+    readonly ZIP_CODE_DISTANCE: "zip-code-distance";
+    readonly ZIP_CODE_DISTANCE_MATCH: "zip-code-distance-match";
+    readonly ZIP_CODES_BY_CITY: "zip-codes-by-city";
+    readonly ZIP_CODES_BY_REGION: "zip-codes-by-region";
+    readonly ZIP_CODES_RADIUS_SEARCH: "zip-codes-radius-search";
+};
+type SpecSlugValue = (typeof SpecSlug)[keyof typeof SpecSlug];
+/**
+ * Enumerated spec categories, same rename-safety guarantee as SpecSlug.
+ */
+declare const SpecCategory: {
+    readonly COMMODITY: "commodity";
+    readonly CURRENCY: "currency";
+    readonly DNS: "dns";
+    readonly DOMAIN: "domain";
+    readonly EMAIL_VALIDATION: "email-validation";
+    readonly FINANCIAL: "financial";
+    readonly GENERAL: "general";
+    readonly GEOCODING: "geocoding";
+    readonly GEODB: "geodb";
+    readonly IP_INTELLIGENCE: "ip-intelligence";
+    readonly OTHER: "other";
+    readonly PDF: "pdf";
+    readonly PHONE_VALIDATION: "phone-validation";
+    readonly SCRAPER: "scraper";
+    readonly SCREENSHOT: "screenshot";
+    readonly SSL: "ssl";
+    readonly TIMEZONE: "timezone";
+    readonly USER_AGENT: "user-agent";
+    readonly WEATHER: "weather";
+    readonly WHOIS: "whois";
+    readonly ZIP_CODE: "zip-code";
+};
+type SpecCategoryValue = (typeof SpecCategory)[keyof typeof SpecCategory];
 
-declare function getSpec(slug: string): OpenAPISpec | undefined;
-declare function getSpecsByCategory(category: string): string[];
+declare function getSpec(slug: SpecSlugValue | (string & {})): OpenAPISpec | undefined;
+declare function getSpecsByCategory(category: SpecCategoryValue | (string & {})): string[];
 
-export { type OpenAPISpec, SPECS, SPECS_BY_CATEGORY, SPEC_CATEGORIES, SPEC_SLUGS, getSpec, getSpecsByCategory };
+export { type OpenAPISpec, SPECS, SPECS_BY_CATEGORY, SPEC_CATEGORIES, SPEC_SLUGS, SpecCategory, type SpecCategoryValue, SpecSlug, type SpecSlugValue, getSpec, getSpecsByCategory };

package/dist/index.js

@@ -44613,6 +44613,133 @@ var SPECS_BY_CATEGORY = {
   "whois": ["asn-lookup", "bulk-whois-lookup", "domain-whois-history-lookup", "reverse-whois", "whois-domain-lookup", "whois-ip-lookup"],
   "zip-code": ["bulk-zip-code-lookup", "zip-code-api", "zip-code-distance-match", "zip-code-distance", "zip-codes-by-city", "zip-codes-by-region", "zip-codes-radius-search"]
 };
+var SpecSlug = {
+  ADMINISTRATIVE_UNITS: "administrative-units",
+  ADMINISTRATIVE_UNITS_DETAILS: "administrative-units-details",
+  ADMINISTRATIVE_UNITS_LEVELS: "administrative-units-levels",
+  AIR_QUALITY: "air-quality",
+  ASN_LOOKUP: "asn-lookup",
+  ASTRONOMY_DATA: "astronomy-data",
+  BULK_DNS_LOOKUP: "bulk-dns-lookup",
+  BULK_DOMAIN_CHECKER: "bulk-domain-checker",
+  BULK_EMAIL_VALIDATION: "bulk-email-validation",
+  BULK_IP_LOOKUP: "bulk-ip-lookup",
+  BULK_IP_THREAT_INTELLIGENCE: "bulk-ip-threat-intelligence",
+  BULK_LIVE_WEATHER: "bulk-live-weather",
+  BULK_PHONE_NUMBER_VALIDATION: "bulk-phone-number-validation",
+  BULK_SCREENSHOT: "bulk-screenshot",
+  BULK_USER_AGENT_PARSER: "bulk-user-agent-parser",
+  BULK_VAT_RATES_COUNTRY: "bulk-vat-rates-country",
+  BULK_WHOIS_LOOKUP: "bulk-whois-lookup",
+  BULK_ZIP_CODE_LOOKUP: "bulk-zip-code-lookup",
+  CITIES: "cities",
+  COMMODITY_FLUCTUATION: "commodity-fluctuation",
+  COMMODITY_PRICES: "commodity-prices",
+  COMMODITY_SYMBOLS: "commodity-symbols",
+  COMMODITY_TIME_SERIES: "commodity-time-series",
+  COUNTRIES: "countries",
+  COUNTRIES_DETAILS: "countries-details",
+  CURRENCY_CONVERTER: "currency-converter",
+  CURRENCY_FLUCTUATION: "currency-fluctuation",
+  CURRENCY_HISTORICAL_DATA_LIMIT: "currency-historical-data-limit",
+  CURRENCY_RATE: "currency-rate",
+  CURRENCY_SUPPORTED: "currency-supported",
+  CURRENCY_SYMBOLS: "currency-symbols",
+  CURRENCY_TIME_SERIES: "currency-time-series",
+  DELETE_PDF_PAGE: "delete-pdf-page",
+  DNS_HISTORY_LOOKUP: "dns-history-lookup",
+  DNS_LOOKUP: "dns-lookup",
+  DOMAIN_SEARCH: "domain-search",
+  DOMAIN_SEARCH_WITH_SUGGESTIONS: "domain-search-with-suggestions",
+  DOMAIN_WHOIS_HISTORY_LOOKUP: "domain-whois-history-lookup",
+  EMAIL_CHECKER: "email-checker",
+  FINANCIAL_APIS_SUPPORTED_COUNTRIES: "financial-apis-supported-countries",
+  FLAGS: "flags",
+  FLAGS_SUPPORTED: "flags-supported",
+  FLOOD_FORECAST: "flood-forecast",
+  FORWARD_GEOCODING: "forward-geocoding",
+  GEOLOCALIZED_CURRENCY_CONVERSION: "geolocalized-currency-conversion",
+  HISTORICAL_COMMODITY_PRICES: "historical-commodity-prices",
+  HISTORICAL_CURRENCY_CONVERTER: "historical-currency-converter",
+  HISTORICAL_CURRENCY_RATE: "historical-currency-rate",
+  HISTORICAL_WEATHER: "historical-weather",
+  IBAN_VALIDATION: "iban-validation",
+  IP_LOCATOR: "ip-locator",
+  IP_THREAT_INTELLIGENCE: "ip-threat-intelligence",
+  LINEARIZE_PDF: "linearize-pdf",
+  LIVE_WEATHER: "live-weather",
+  MARINE_WEATHER: "marine-weather",
+  MERGE_PDF: "merge-pdf",
+  PDF_COMPRESS: "pdf-compress",
+  PDF_DECRYPT: "pdf-decrypt",
+  PDF_ENCRYPT: "pdf-encrypt",
+  PDF_EXTRACT_PAGES: "pdf-extract-pages",
+  PDF_FILE: "pdf-file",
+  PDF_FILE_STATUS: "pdf-file-status",
+  PDF_FILES: "pdf-files",
+  PDF_RESOURCE_DOWNLOAD: "pdf-resource-download",
+  PDF_RESOURCE_UPLOAD: "pdf-resource-upload",
+  PDF_RESOURCE_UPLOAD_BINARY: "pdf-resource-upload-binary",
+  PDF_RESTRICT: "pdf-restrict",
+  PDF_SPLIT_PAGES: "pdf-split-pages",
+  PDF_TASK_STATUS: "pdf-task-status",
+  PDF_TO_IMAGE: "pdf-to-image",
+  PDF_UNRESTRICT: "pdf-unrestrict",
+  PHONE_NUMBER_VALIDATION: "phone-number-validation",
+  REGIONS: "regions",
+  REVERSE_DNS_LOOKUP: "reverse-dns-lookup",
+  REVERSE_GEOCODING: "reverse-geocoding",
+  REVERSE_WHOIS: "reverse-whois",
+  ROTATE_PDF_PAGES: "rotate-pdf-pages",
+  SSL_CERTIFICATE_CHAIN_LOOKUP: "ssl-certificate-chain-lookup",
+  SSL_CERTIFICATE_LOOKUP: "ssl-certificate-lookup",
+  SUBDOMAIN_LOOKUP: "subdomain-lookup",
+  SUBREGIONS: "subregions",
+  SWIFT_CODE_FINDER: "swift-code-finder",
+  SWIFT_CODE_LOOKUP: "swift-code-lookup",
+  TIME_SERIES_WEATHER: "time-series-weather",
+  TIMEZONE_CONVERTER: "timezone-converter",
+  TIMEZONE_LOOKUP: "timezone-lookup",
+  USAGE_CREDITS: "usage-credits",
+  USER_AGENT_PARSER: "user-agent-parser",
+  VAT_NUMBER_VALIDATION: "vat-number-validation",
+  VAT_RATES_BY_IP: "vat-rates-by-ip",
+  VAT_RATES_COUNTRY: "vat-rates-country",
+  WEATHER_FORECAST: "weather-forecast",
+  WEB_SCRAPER: "web-scraper",
+  WEBSITE_SCREENSHOT: "website-screenshot",
+  WHOIS_DOMAIN_LOOKUP: "whois-domain-lookup",
+  WHOIS_IP_LOOKUP: "whois-ip-lookup",
+  ZIP_CODE_API: "zip-code-api",
+  ZIP_CODE_DISTANCE: "zip-code-distance",
+  ZIP_CODE_DISTANCE_MATCH: "zip-code-distance-match",
+  ZIP_CODES_BY_CITY: "zip-codes-by-city",
+  ZIP_CODES_BY_REGION: "zip-codes-by-region",
+  ZIP_CODES_RADIUS_SEARCH: "zip-codes-radius-search"
+};
+var SpecCategory = {
+  COMMODITY: "commodity",
+  CURRENCY: "currency",
+  DNS: "dns",
+  DOMAIN: "domain",
+  EMAIL_VALIDATION: "email-validation",
+  FINANCIAL: "financial",
+  GENERAL: "general",
+  GEOCODING: "geocoding",
+  GEODB: "geodb",
+  IP_INTELLIGENCE: "ip-intelligence",
+  OTHER: "other",
+  PDF: "pdf",
+  PHONE_VALIDATION: "phone-validation",
+  SCRAPER: "scraper",
+  SCREENSHOT: "screenshot",
+  SSL: "ssl",
+  TIMEZONE: "timezone",
+  USER_AGENT: "user-agent",
+  WEATHER: "weather",
+  WHOIS: "whois",
+  ZIP_CODE: "zip-code"
+};
 
 // src/index.ts
 function getSpec(slug) {
@@ -44626,6 +44753,8 @@ export {
   SPECS_BY_CATEGORY,
   SPEC_CATEGORIES,
   SPEC_SLUGS,
+  SpecCategory,
+  SpecSlug,
   getSpec,
   getSpecsByCategory
 };