@hexpro/qr-code-studio 0.0.0-stage → 0.1.1

package/dist/own-link/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/own-link/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACjE,YAAY,EACX,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,cAAc,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/own-link/index.js

@@ -0,0 +1,3 @@
+export { redirectRules, REDIRECT_TARGETS } from './redirects.js';
+export { utmLink } from './utm.js';
+//# sourceMappingURL=index.js.map

package/dist/own-link/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/own-link/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAQjE,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/own-link/query.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Setting query parameters on a URL as text.
+ *
+ * The same rule as `payload/uri.ts`, kept here because own-link may import
+ * only from core: the link comes back as the person wrote it, with the named
+ * parameters replaced or appended, rather than re-serialised by `URL`.
+ */
+/** Set the given parameters, of which there is always at least one. */
+export declare function withQueryParams(url: string, params: readonly (readonly [string, string])[]): string;
+//# sourceMappingURL=query.d.ts.map

package/dist/own-link/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/own-link/query.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,uEAAuE;AACvE,wBAAgB,eAAe,CAC9B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,GAC5C,MAAM,CAaR"}

package/dist/own-link/query.js

@@ -0,0 +1,33 @@
+/**
+ * Setting query parameters on a URL as text.
+ *
+ * The same rule as `payload/uri.ts`, kept here because own-link may import
+ * only from core: the link comes back as the person wrote it, with the named
+ * parameters replaced or appended, rather than re-serialised by `URL`.
+ */
+function decodedName(part) {
+    const equals = part.indexOf('=');
+    const raw = (equals === -1 ? part : part.slice(0, equals)).replace(/\+/g, ' ');
+    try {
+        return decodeURIComponent(raw);
+    }
+    catch {
+        return raw;
+    }
+}
+/** Set the given parameters, of which there is always at least one. */
+export function withQueryParams(url, params) {
+    const hash = url.indexOf('#');
+    const fragment = hash === -1 ? '' : url.slice(hash);
+    const rest = hash === -1 ? url : url.slice(0, hash);
+    const mark = rest.indexOf('?');
+    const base = mark === -1 ? rest : rest.slice(0, mark);
+    const existing = mark === -1 ? [] : rest.slice(mark + 1).split('&');
+    const names = new Set(params.map(([name]) => name));
+    const parts = [
+        ...existing.filter((part) => part !== '' && !names.has(decodedName(part))),
+        ...params.map(([name, value]) => `${encodeURIComponent(name)}=${encodeURIComponent(value)}`),
+    ];
+    return `${base}?${parts.join('&')}${fragment}`;
+}
+//# sourceMappingURL=query.js.map

package/dist/own-link/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/own-link/query.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,SAAS,WAAW,CAAC,IAAY;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC/E,IAAI,CAAC;QACJ,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,GAAG,CAAC;IACZ,CAAC;AACF,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,eAAe,CAC9B,GAAW,EACX,MAA8C;IAE9C,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG;QACb,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1E,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;KAC5F,CAAC;IACF,OAAO,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,EAAE,CAAC;AAChD,CAAC"}

package/dist/own-link/redirects.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Redirect rules for a person's own website, so a printed code can point at
+ * an address they control and its destination can change later without
+ * reprinting anything, and without a third party in the middle.
+ *
+ * One input, a rule for each hosting setup: Cloudflare (a Bulk Redirects
+ * list row and a single Redirect Rule), Netlify, Vercel, Apache, nginx, and a
+ * plain HTML page for hosts that offer no redirect settings at all. Each
+ * follows its platform's documented syntax, cited beside it.
+ *
+ * A temporary status, 302 or 307, is the right one here and the default.
+ * Browsers remember a permanent redirect (301 or 308) and may never ask the
+ * server again, so a destination changed later would not reach anybody who
+ * had scanned the code before. A permanent status is allowed, with a warning.
+ *
+ * The source path is limited to letters, digits, "-", ".", "_", "~" and "/".
+ * That is every path a QR code needs. Percent-escapes are refused because
+ * nginx and Apache match the decoded path and Cloudflare and Netlify the
+ * encoded one, so the same rule would match different requests. And no
+ * platform's pattern syntax (Vercel's ":name", Netlify's "*", a regular
+ * expression's ".") can change what the rule matches, beyond the one escape
+ * Apache needs for the dot. The destination is normalised by the WHATWG URL
+ * parser, which percent-encodes spaces and quotes, and "$" and "\" are
+ * percent-encoded on top because nginx and Apache read "$" as a variable or a
+ * back-reference and nginx has no way to escape one.
+ */
+import type { Issue } from '../core/issue.js';
+export type RedirectStatus = 301 | 302 | 307 | 308;
+export type RedirectTarget = 'cloudflare' | 'netlify' | 'vercel' | 'apache' | 'nginx' | 'html';
+export declare const REDIRECT_TARGETS: readonly RedirectTarget[];
+export interface RedirectInput {
+    /** The address on the person's own site that the code holds, such as https://example.com/qr/menu. */
+    readonly from: string;
+    /** Where it goes today. */
+    readonly to: string;
+    /** Default 302. */
+    readonly status?: RedirectStatus;
+    /** Which setups to write rules for; all of them when absent. */
+    readonly targets?: readonly RedirectTarget[];
+}
+export interface RedirectRule {
+    readonly target: RedirectTarget;
+    readonly filename: string;
+    readonly contents: string;
+    /** Where the file goes and anything the platform needs, as a message key. */
+    readonly noteKey: string;
+}
+export interface RedirectRulesResult {
+    /** Empty when there is an error issue. */
+    readonly rules: readonly RedirectRule[];
+    readonly issues: readonly Issue[];
+}
+export declare function redirectRules(input: RedirectInput): RedirectRulesResult;
+//# sourceMappingURL=redirects.d.ts.map

package/dist/own-link/redirects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirects.d.ts","sourceRoot":"","sources":["../../src/own-link/redirects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEnD,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAE/F,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAOzB,CAAC;AAE9B,MAAM,WAAW,aAAa;IAC7B,qGAAqG;IACrG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,gEAAgE;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IACnC,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;CAClC;AAsPD,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,mBAAmB,CAUvE"}

package/dist/own-link/redirects.js

@@ -0,0 +1,271 @@
+/**
+ * Redirect rules for a person's own website, so a printed code can point at
+ * an address they control and its destination can change later without
+ * reprinting anything, and without a third party in the middle.
+ *
+ * One input, a rule for each hosting setup: Cloudflare (a Bulk Redirects
+ * list row and a single Redirect Rule), Netlify, Vercel, Apache, nginx, and a
+ * plain HTML page for hosts that offer no redirect settings at all. Each
+ * follows its platform's documented syntax, cited beside it.
+ *
+ * A temporary status, 302 or 307, is the right one here and the default.
+ * Browsers remember a permanent redirect (301 or 308) and may never ask the
+ * server again, so a destination changed later would not reach anybody who
+ * had scanned the code before. A permanent status is allowed, with a warning.
+ *
+ * The source path is limited to letters, digits, "-", ".", "_", "~" and "/".
+ * That is every path a QR code needs. Percent-escapes are refused because
+ * nginx and Apache match the decoded path and Cloudflare and Netlify the
+ * encoded one, so the same rule would match different requests. And no
+ * platform's pattern syntax (Vercel's ":name", Netlify's "*", a regular
+ * expression's ".") can change what the rule matches, beyond the one escape
+ * Apache needs for the dot. The destination is normalised by the WHATWG URL
+ * parser, which percent-encodes spaces and quotes, and "$" and "\" are
+ * percent-encoded on top because nginx and Apache read "$" as a variable or a
+ * back-reference and nginx has no way to escape one.
+ */
+import { issue } from '../core/issue.js';
+import { hasErrors } from '../core/issue.js';
+export const REDIRECT_TARGETS = Object.freeze([
+    'cloudflare',
+    'netlify',
+    'vercel',
+    'apache',
+    'nginx',
+    'html',
+]);
+const STATUSES = [301, 302, 307, 308];
+/** Segments of the safe characters, with no empty segment: nginx merges "//", so a rule for one would never match. */
+const SAFE_PATH = /^(?:\/[A-Za-z0-9._~-]+)*\/?$/;
+/** A path compared the way Netlify matches one: with or without its trailing slash. */
+function samePath(a, b) {
+    return a.replace(/\/+$/, '') === b.replace(/\/+$/, '');
+}
+function parseWebUrl(text) {
+    if (typeof text !== 'string' || /\s/.test(text))
+        return undefined;
+    try {
+        const url = new URL(text);
+        return url.protocol === 'https:' || url.protocol === 'http:' ? url : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function validate(input) {
+    const issues = [];
+    const from = parseWebUrl(input.from);
+    if (from === undefined || from.username !== '' || from.password !== '' || from.port !== '') {
+        issues.push(issue('own-link.issue.from', ['from']));
+    }
+    else if (from.search !== '' || from.hash !== '' || /[?#]/.test(input.from)) {
+        issues.push(issue('own-link.issue.from-query', ['from']));
+    }
+    else if (!SAFE_PATH.test(from.pathname)) {
+        issues.push(issue('own-link.issue.from-path', ['from']));
+    }
+    const to = parseWebUrl(input.to);
+    if (to === undefined)
+        issues.push(issue('own-link.issue.to', ['to']));
+    else if (to.username !== '' || to.password !== '')
+        issues.push(issue('own-link.issue.to-userinfo', ['to']));
+    else if (to.protocol === 'http:')
+        issues.push(issue('own-link.issue.to-insecure', ['to'], 'warning'));
+    const status = input.status ?? 302;
+    if (!STATUSES.includes(status))
+        issues.push(issue('own-link.issue.status', ['status']));
+    else if (status === 301 || status === 308)
+        issues.push(issue('own-link.issue.permanent', ['status'], 'warning'));
+    if (from !== undefined &&
+        to !== undefined &&
+        from.host === to.host &&
+        samePath(from.pathname, to.pathname)) {
+        issues.push(issue('own-link.issue.loop', ['to']));
+    }
+    for (const target of input.targets ?? []) {
+        if (!REDIRECT_TARGETS.includes(target))
+            issues.push(issue('own-link.issue.target', ['targets']));
+    }
+    if (hasErrors(issues) || from === undefined || to === undefined)
+        return { issues };
+    return {
+        parsed: { host: from.hostname, path: from.pathname, to: safeUrl(to.href), status },
+        issues,
+    };
+}
+/** "$" and "\" as percent-escapes: nginx and Apache would read them as syntax, and a URL means the same either way. */
+function safeUrl(href) {
+    return href.replace(/\$/g, '%24').replace(/\\/g, '%5C');
+}
+/**
+ * The destination with the characters Netlify and Vercel read as pattern
+ * syntax percent-encoded. Both substitute named segments into a destination
+ * (Netlify's ":placeholder" and ":splat", Vercel's path-to-regexp segments,
+ * which also give "(", ")", "*", "+", "{" and "}" meaning), so a Wikipedia
+ * link such as /wiki/Help:Contents would otherwise be rewritten or refused.
+ * The scheme, host and port are left alone; in the query "+" is kept,
+ * because there it may mean a space.
+ */
+function inertDestination(href) {
+    const url = new URL(href);
+    const escape = (text, set) => text.replace(set, (char) => `%${char.charCodeAt(0).toString(16).toUpperCase()}`);
+    const path = /[:()*+{}]/g;
+    return `${url.protocol}//${url.host}${escape(url.pathname, path)}${escape(url.search, /[:()*{}]/g)}${escape(url.hash, path)}`;
+}
+/** A CSV field per RFC 4180: quoted when it holds a comma or a quote, with quotes doubled. */
+function csvField(text) {
+    return /[",\r\n]/.test(text) ? `"${text.replace(/"/g, '""')}"` : text;
+}
+function htmlAttribute(text) {
+    return text
+        .replace(/&/g, '&')
+        .replace(/"/g, '"')
+        .replace(/'/g, ''')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}
+/**
+ * Cloudflare Bulk Redirects, CSV upload format
+ * (developers.cloudflare.com/rules/url-forwarding/bulk-redirects/reference/csv-file-format/):
+ * source, target, status, then preserve query string, include subdomains,
+ * subpath matching and preserve path suffix, with no header row. The source
+ * has no scheme, so it matches both http and https. Every flag is written out
+ * as FALSE because Cloudflare's own pages disagree about one default.
+ */
+function cloudflareBulk({ host, path, to, status }) {
+    return {
+        target: 'cloudflare',
+        filename: 'cloudflare-bulk-redirects.csv',
+        contents: `${csvField(`${host}${path}`)},${csvField(to)},${status},FALSE,FALSE,FALSE,FALSE\n`,
+        noteKey: 'own-link.note.cloudflare-bulk',
+    };
+}
+/**
+ * A single Cloudflare Redirect Rule, as the Rulesets API takes it
+ * (developers.cloudflare.com/rules/url-forwarding/single-redirects/create-api/):
+ * an expression matching the exact host and path
+ * (developers.cloudflare.com/ruleset-engine/rules-language/fields/reference/)
+ * and a static target. The expression can be pasted into the dashboard's
+ * expression editor as it is.
+ */
+function cloudflareRule({ host, path, to, status }) {
+    const rule = {
+        expression: `(http.host eq ${JSON.stringify(host)} and http.request.uri.path eq ${JSON.stringify(path)})`,
+        action: 'redirect',
+        action_parameters: {
+            from_value: { target_url: { value: to }, status_code: status, preserve_query_string: false },
+        },
+    };
+    return {
+        target: 'cloudflare',
+        filename: 'cloudflare-redirect-rule.json',
+        contents: `${JSON.stringify(rule, null, '\t')}\n`,
+        noteKey: 'own-link.note.cloudflare-rule',
+    };
+}
+/**
+ * Netlify `_redirects` (docs.netlify.com/manage/routing/redirects/overview/):
+ * path, destination, status. The "!" forces the rule even when a file exists
+ * at the path, which Netlify otherwise lets win (redirect-options). Netlify
+ * does not support 307, and its documentation says to use 302 instead, so a
+ * 307 is written as 302 and a 308 as 301, and the note says so.
+ */
+function netlify({ path, to, status }) {
+    const written = status === 307 ? 302 : status === 308 ? 301 : status;
+    return {
+        target: 'netlify',
+        filename: '_redirects',
+        contents: `${path}  ${inertDestination(to)}  ${written}!\n`,
+        noteKey: written === status ? 'own-link.note.netlify' : 'own-link.note.netlify-status',
+    };
+}
+/**
+ * Vercel `vercel.json` redirects (vercel.com/docs/project-configuration/vercel-json#redirects):
+ * source, destination and statusCode, which is used rather than `permanent`
+ * so that 302 and 301 can be written as well as 307 and 308.
+ */
+function vercel({ path, to, status }) {
+    const config = {
+        redirects: [{ source: path, destination: inertDestination(to), statusCode: status }],
+    };
+    return {
+        target: 'vercel',
+        filename: 'vercel.json',
+        contents: `${JSON.stringify(config, null, '\t')}\n`,
+        noteKey: 'own-link.note.vercel',
+    };
+}
+/**
+ * Apache httpd 2.4 mod_alias (httpd.apache.org/docs/2.4/mod/mod_alias.html#redirectmatch):
+ * RedirectMatch with an anchored expression, because plain Redirect matches
+ * the path as a prefix and appends whatever follows it. Allowed in .htaccess
+ * where AllowOverride includes FileInfo.
+ */
+function apache({ path, to, status }) {
+    const pattern = `^${path.replace(/\./g, '\\.')}$`;
+    return {
+        target: 'apache',
+        filename: '.htaccess',
+        contents: `RedirectMatch ${status} "${pattern}" "${to}"\n`,
+        noteKey: 'own-link.note.apache',
+    };
+}
+/**
+ * nginx (nginx.org/en/docs/http/ngx_http_core_module.html#location and
+ * ngx_http_rewrite_module.html#return): an exact-match location returning
+ * the status and the URL. A "$" in the URL would start a variable and nginx
+ * has no escape for one, which is why it arrives here percent-encoded.
+ */
+function nginx({ path, to, status }) {
+    return {
+        target: 'nginx',
+        filename: 'nginx-redirect.conf',
+        contents: `location = ${path} {\n\treturn ${status} "${to}";\n}\n`,
+        noteKey: 'own-link.note.nginx',
+    };
+}
+/**
+ * A page that forwards, for a host with no redirect settings: a meta refresh
+ * (HTML Living Standard, "Shared declarative refresh steps") and a link for
+ * anything that ignores it. It carries no words of its own, so it reads the
+ * same in any language: the title is the destination's host and the link text
+ * is the destination. It is not an HTTP redirect, so there is no status.
+ */
+function html({ path, to }) {
+    const trimmed = path.replace(/^\/+|\/+$/g, '');
+    const filename = trimmed === '' ? 'index.html' : /\.html?$/.test(trimmed) ? trimmed : `${trimmed}/index.html`;
+    // The refresh URL is quoted with apostrophes, and the HTML standard ends a
+    // quoted refresh URL at the first matching quote, so an apostrophe in the
+    // destination (WHATWG leaves one in a path) is percent-encoded first.
+    const href = htmlAttribute(to.replace(/'/g, '%27'));
+    const title = htmlAttribute(new URL(to).hostname);
+    const contents = [
+        '<!doctype html>',
+        '<meta charset="utf-8">',
+        '<meta name="robots" content="noindex">',
+        `<meta http-equiv="refresh" content="0; url='${href}'">`,
+        `<title>${title}</title>`,
+        `<a href="${href}">${href}</a>`,
+        '',
+    ].join('\n');
+    return { target: 'html', filename, contents, noteKey: 'own-link.note.html' };
+}
+const WRITERS = {
+    cloudflare: [cloudflareBulk, cloudflareRule],
+    netlify: [netlify],
+    vercel: [vercel],
+    apache: [apache],
+    nginx: [nginx],
+    html: [html],
+};
+export function redirectRules(input) {
+    if (typeof input !== 'object' || input === null)
+        throw new TypeError('redirectRules takes an object with from and to.');
+    const { parsed, issues } = validate(input);
+    if (parsed === undefined)
+        return { rules: [], issues };
+    const targets = input.targets ?? REDIRECT_TARGETS;
+    const rules = REDIRECT_TARGETS.filter((target) => targets.includes(target)).flatMap((target) => WRITERS[target].map((writer) => writer(parsed)));
+    return { rules, issues };
+}
+//# sourceMappingURL=redirects.js.map

package/dist/own-link/redirects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirects.js","sourceRoot":"","sources":["../../src/own-link/redirects.ts"],"names":[],"mappings":"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"}

package/dist/own-link/utm.d.ts

@@ -0,0 +1,24 @@
+/**
+ * A link with Google Analytics campaign parameters (utm_source, utm_medium,
+ * utm_campaign, and optionally utm_term and utm_content), as Google documents
+ * them (support.google.com/analytics/answer/10917952).
+ *
+ * Source, medium and campaign are required together: Analytics groups a
+ * visit by all three, and a tag missing one is reported in a bucket of its
+ * own, which is rarely what was meant.
+ */
+import type { Issue } from '../core/issue.js';
+export interface UtmParams {
+    readonly source: string;
+    readonly medium: string;
+    readonly campaign: string;
+    readonly term?: string;
+    readonly content?: string;
+}
+export interface UtmLinkResult {
+    /** The tagged link, or null when there is an error issue. */
+    readonly url: string | null;
+    readonly issues: readonly Issue[];
+}
+export declare function utmLink(url: string, params: UtmParams): UtmLinkResult;
+//# sourceMappingURL=utm.d.ts.map

package/dist/own-link/utm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utm.d.ts","sourceRoot":"","sources":["../../src/own-link/utm.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAI9C,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;CAClC;AA0CD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,aAAa,CAqBrE"}

package/dist/own-link/utm.js

@@ -0,0 +1,82 @@
+/**
+ * A link with Google Analytics campaign parameters (utm_source, utm_medium,
+ * utm_campaign, and optionally utm_term and utm_content), as Google documents
+ * them (support.google.com/analytics/answer/10917952).
+ *
+ * Source, medium and campaign are required together: Analytics groups a
+ * visit by all three, and a tag missing one is reported in a bucket of its
+ * own, which is rarely what was meant.
+ */
+import { issue } from '../core/issue.js';
+import { hasErrors } from '../core/issue.js';
+import { withQueryParams } from './query.js';
+const NAMES = [
+    ['source', 'utm_source'],
+    ['medium', 'utm_medium'],
+    ['campaign', 'utm_campaign'],
+    ['term', 'utm_term'],
+    ['content', 'utm_content'],
+];
+const REQUIRED = new Set(['source', 'medium', 'campaign']);
+function isWebUrl(text) {
+    if (/\s/.test(text))
+        return false;
+    try {
+        const parsed = new URL(text);
+        return parsed.protocol === 'https:' || parsed.protocol === 'http:';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * A control character, or half of a surrogate pair. The second matters as
+ * much as the first: encodeURIComponent throws on one, and a link with a
+ * broken character in it cannot be written at all.
+ */
+function unusable(text) {
+    for (let i = 0; i < text.length; i += 1) {
+        const code = text.charCodeAt(i);
+        if (code < 0x20 || code === 0x7f)
+            return true;
+        if (code >= 0xd800 && code <= 0xdbff) {
+            const next = text.charCodeAt(i + 1);
+            if (!(next >= 0xdc00 && next <= 0xdfff))
+                return true;
+            i += 1;
+        }
+        else if (code >= 0xdc00 && code <= 0xdfff) {
+            return true;
+        }
+    }
+    return false;
+}
+export function utmLink(url, params) {
+    if (typeof url !== 'string' || typeof params !== 'object' || params === null) {
+        throw new TypeError('utmLink takes a URL string and an object of campaign parameters.');
+    }
+    const issues = [];
+    if (!isWebUrl(url))
+        issues.push(issue('own-link.issue.url', ['url']));
+    const pairs = [];
+    for (const [key, name] of NAMES) {
+        const value = params[key] ?? '';
+        if (typeof value !== 'string') {
+            issues.push(issue('own-link.issue.utm-value', [key]));
+        }
+        else if (value.trim() === '') {
+            if (REQUIRED.has(key))
+                issues.push(issue('own-link.issue.utm-required', [key]));
+        }
+        else if (unusable(value)) {
+            issues.push(issue('own-link.issue.utm-value', [key]));
+        }
+        else {
+            pairs.push([name, value]);
+        }
+    }
+    if (hasErrors(issues))
+        return { url: null, issues };
+    return { url: withQueryParams(url, pairs), issues };
+}
+//# sourceMappingURL=utm.js.map

package/dist/own-link/utm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utm.js","sourceRoot":"","sources":["../../src/own-link/utm.ts"],"names":[],"mappings":"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"}

package/dist/payload/banking.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Bank identifiers: IBAN (ISO 13616), BIC (ISO 9362) and the structured
+ * creditor reference (ISO 11649).
+ *
+ * The IBAN check is the one that saves somebody's money. A transposed pair of
+ * digits passes every "looks like an IBAN" pattern and fails MOD 97-10, and a
+ * payment code with a wrong IBAN that still validates at the bank sends the
+ * money to a stranger.
+ */
+/** The electronic form: no spaces, upper case. A printed IBAN is grouped in fours. */
+export declare function compactIban(text: string): string;
+/** Letters to their two-digit values (A is 10), as ISO 13616 and ISO 11649 both convert them. */
+export declare function lettersToDigits(text: string): string;
+export type IbanProblem = {
+    readonly code: 'format' | 'country' | 'checksum';
+} | {
+    readonly code: 'length';
+    readonly length: number;
+    readonly expected: number;
+};
+/** Undefined for a valid IBAN, printed or electronic; otherwise what is wrong with it. */
+export declare function ibanProblem(text: string): IbanProblem | undefined;
+/** For tests and generators: an IBAN with its check digits worked out. */
+export declare function ibanWithCheckDigits(country: string, bban: string): string;
+/**
+ * Business party prefix, country, location and an optional branch (ISO 9362).
+ * Lower case is accepted and upper-cased when built: people type BICs.
+ */
+export declare function isBic(text: string): boolean;
+/**
+ * An ISO 11649 structured creditor reference: "RF", two check digits, and 1
+ * to 21 letters and digits, valid when MOD 97-10 over the rearranged
+ * reference leaves 1. Printed in groups of four, so spaces are dropped first.
+ */
+export declare function compactCreditorReference(text: string): string;
+export declare function isCreditorReference(text: string): boolean;
+/** For tests and generators: the full reference for a body. */
+export declare function creditorReferenceFor(body: string): string;
+//# sourceMappingURL=banking.d.ts.map

package/dist/payload/banking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banking.d.ts","sourceRoot":"","sources":["../../src/payload/banking.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyBH,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,iGAAiG;AACjG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED,MAAM,MAAM,WAAW,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAQjE;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGzE;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIzD;AAED,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGzD"}