nuqs
Version:
Type-safe search params state manager for Next.js - Like React.useState, but stored in the URL query string
55 lines (50 loc) • 1.95 kB
JavaScript
import { createContext, createElement, useContext } from 'react';
// src/url-encoding.ts
function renderQueryString(search) {
if (search.size === 0) {
return "";
}
const query = [];
for (const [key, value] of search.entries()) {
const safeKey = key.replace(/#/g, "%23").replace(/&/g, "%26").replace(/\+/g, "%2B").replace(/=/g, "%3D").replace(/\?/g, "%3F");
query.push(`${safeKey}=${encodeQueryValue(value)}`);
}
return "?" + query.join("&");
}
function encodeQueryValue(input) {
return input.replace(/%/g, "%25").replace(/\+/g, "%2B").replace(/ /g, "+").replace(/#/g, "%23").replace(/&/g, "%26").replace(/"/g, "%22").replace(/'/g, "%27").replace(/`/g, "%60").replace(/</g, "%3C").replace(/>/g, "%3E");
}
// src/errors.ts
var errors = {
404: "nuqs requires an adapter to work with your framework.",
409: "Multiple versions of the library are loaded. This may lead to unexpected behavior. Currently using `%s`, but `%s` was about to load on top.",
429: "URL update rate-limited by the browser. Consider increasing `throttleMs` for key(s) `%s`. %O",
500: "Empty search params cache. Search params can't be accessed in Layouts.",
501: "Search params cache already populated. Have you called `parse` twice?"
};
function error(code) {
return `[nuqs] ${errors[code]}
See https://err.47ng.com/NUQS-${code}`;
}
// src/adapters/internal.context.ts
var context = createContext({
useAdapter() {
throw new Error(error(404));
}
});
context.displayName = "NuqsAdapterContext";
function createAdapterProvider(useAdapter2) {
return ({ children, ...props }) => createElement(
context.Provider,
{ ...props, value: { useAdapter: useAdapter2 } },
children
);
}
function useAdapter() {
const value = useContext(context);
if (!("useAdapter" in value)) {
throw new Error(error(404));
}
return value.useAdapter();
}
export { context, createAdapterProvider, error, renderQueryString, useAdapter };