UNPKG

fraci

Version:

Fractional indexing that's robust, performant, and secure, with first-class support for Drizzle ORM and Prisma ORM.

670 lines (663 loc) 13.8 kB
// src/lib/errors.ts var c = class extends Error { constructor(r, t) { super(`[${r}] ${t}`); this.code = r; this.message = t; this.name = "FraciError"; } name; }; function En(n) { return n instanceof c; } function hn(n) { return n instanceof c ? n.code : void 0; } // src/lib/decimal-binary.ts var P = new Uint8Array([128, 0]), yn = new Uint8Array([127, 255]); function B(n, e) { let r = Math.min(n.length, e.length), t = 0; for (let o = 0; !t && o < r; o++) t = n[o] - e[o]; return t || n.length - e.length; } function I(n, e) { let r = new Uint8Array(n.length + e.length); return r.set(n), r.set(e, n.length), r; } function G(n) { let [e] = n; return e - (e >= 128 ? 127 : 128); } function v(n) { return n + (n < 0 ? 128 : 127); } function R(n) { return n.length === 129 && n.every((e) => e === 0); } function b(n) { let e = Math.abs(G(n)) + 1; if (!(Number.isNaN(e) || n.length < e)) return [n.subarray(0, e), n.subarray(e)]; } function V(n) { if (!n.length) return; let e = G(n), r = n.slice(0, Math.abs(e) + 1); for (let i = r.length - 1; i >= 1; i--) if (r[i]++ < 255) return r; if (e === -1) return P.slice(); let t = e + 1; if (t > 128) return null; let o = new Uint8Array(Math.abs(t) + 1); return o[0] = v(t), o; } function z(n) { let e = G(n); if (Number.isNaN(e)) return; let r = n.slice(0, Math.abs(e) + 1); for (let i = r.length - 1; i >= 1; i--) if (r[i]--) return r; if (e === 1) return yn.slice(); let t = e - 1; if (t < -128) return null; let o = new Uint8Array(Math.abs(t) + 1).fill(255); return o[0] = v(t), o; } function x(n, e) { if (e != null && B(n, e) >= 0) return; if (e) { let a = e.findIndex((l, s) => l !== (n[s] ?? 0)); if (a > 0) { let l = x( n.subarray(a), e.subarray(a) ); return l ? I(e.subarray(0, a), l) : void 0; } } let r = n[0] ?? 0, t = e ? e[0] : 256; if (t == null) return; if (r + 1 !== t) { let a = r + t >> 1; return new Uint8Array([a]); } if (e && e.length > 1) return new Uint8Array([e[0]]); let o = x(n.subarray(1), null); if (!o) return; let i = new Uint8Array(1 + o.length); return i[0] = r, i.set(o, 1), i; } // src/lib/decimal-string.ts function k(n, e) { return e.get(n[0]); } function w(n, e) { let r = Math.abs(k(n, e) ?? 0) + 1; if (!(r < 2 || n.length < r)) return [n.slice(0, r), n.slice(r)]; } function J(n, e) { return e.get(1) + n[0]; } function Q(n, e) { let r = Math.min(...Array.from(e.keys())); return `${e.get(r)}${n[0].repeat(Math.abs(r))}`; } function Z(n, e, r, t, o) { let i = k(n, o); if (!i) return; let a = e[0], [l, ...s] = n.slice(0, Math.abs(i) + 1); for (let g = s.length - 1; g >= 0; g--) { let y = r.get(s[g]); if (y == null) return; if (y < e.length - 1) return s[g] = e[y + 1], `${l}${s.join("")}`; s[g] = a; } if (i === -1) return `${t.get(1)}${a}`; let u = i + 1, f = t.get(u); return f ? `${f}${a.repeat(Math.abs(u))}` : null; } function Y(n, e, r, t, o) { let i = k(n, o); if (!i) return; let a = e[e.length - 1], [l, ...s] = n.slice(0, Math.abs(i) + 1); for (let g = s.length - 1; g >= 0; g--) { let y = r.get(s[g]); if (y == null) return; if (y > 0) return s[g] = e[y - 1], `${l}${s.join("")}`; s[g] = a; } if (i === 1) return `${t.get(-1)}${a}`; let u = i - 1, f = t.get(u); return f ? `${f}${a.repeat(Math.abs(u))}` : null; } function _(n, e, r, t) { if (e != null && e <= n) return; if (e) { let a = n.padEnd(e.length, r[0]), l = Array.prototype.findIndex.call( e, (s, u) => s !== a[u] ); if (l > 0) return `${e.slice(0, l)}${_( n.slice(l), e.slice(l), r, t )}`; } let o = n ? t.get(n[0]) : 0, i = e ? t.get(e[0]) : r.length; if (!(o == null || i == null)) { if (o + 1 !== i) { let a = o + i >> 1; return r[a]; } return e && e.length > 1 ? e[0] : `${r[o]}${_( n.slice(1), null, r, t )}`; } } // src/lib/fractional-indexing-binary.ts function N(n) { return n?.constructor.name === "Buffer" ? new Uint8Array(n.buffer, n.byteOffset, n.length) : n; } function D(n) { if (!n.length || R(n)) return !1; let e = b(n); if (!e) return !1; let [, r] = e; return r?.at(-1) !== 0; } function E(n) { if (n === void 0) throw console.error( "FraciError: [INTERNAL_ERROR] Unexpected undefined. Please file an issue to report this error." ), new c("INTERNAL_ERROR", "Unexpected undefined"); return n; } function M(n, e) { if (!n) { if (!e) return P.slice(); let [l, s] = E(b(e)); if (R(l)) return I( l, E(x(new Uint8Array(), s)) ); if (s.length) return l.slice(); let u = E( z(l) ); if (!R(u)) return u; let f = new Uint8Array(u.length + 1); return f.set(u), f[u.length] = 255, f; } if (!e) { let l = E(b(n)), [s, u] = l, f = E(V(s)); return f || I(s, E(x(u, null))); } let [r, t] = E(b(n)), [o, i] = E(b(e)); if (!B(r, o)) return I( r, E(x(t, i)) ); let a = E(V(r)); return a && B(a, o) ? ( // 1. If incrementing a's integer doesn't reach b's integer, // we can use the incremented value (shorter key) a ) : ( // 2. If incrementing a's integer equals b's integer or we can't increment, // we need to use a's integer with a fractional part that sorts after a's fractional part I(r, E(x(t, null))) ); } function nn(n, e) { return n != null && !D(n) || e != null && !D(e) || n != null && e != null && B(n, e) >= 0 ? void 0 : M(N(n), N(e)); } function H(n, e, r) { if (r < 1) return []; if (r === 1) return [M(n, e)]; if (e == null) { let i = n; return Array.from( { length: r }, () => i = M(i, e) ); } if (n == null) { let i = e; return Array.from( { length: r }, () => i = M(n, i) ).reverse(); } let t = r >> 1, o = M(n, e); return [ ...H(n, o, t), o, ...H(o, e, r - t - 1) ]; } function en(n, e, r) { return n != null && !D(n) || e != null && !D(e) || n != null && e != null && B(n, e) >= 0 ? void 0 : H(N(n), N(e), r); } function j(n) { let e = []; for (; n > 0; ) e.push(n & 255), n >>= 8; return new Uint8Array(e); } // src/lib/fractional-indexing-string.ts function L(n, e, r, t, o) { if (!n || n === o) return !1; let i = w(n, t); if (!i) return !1; let [a, l] = i; if (l.endsWith(e[0])) return !1; for (let s of a.slice(1)) if (!r.has(s)) return !1; for (let s of l) if (!r.has(s)) return !1; return !0; } function h(n) { if (n === void 0) throw console.error( "FraciError: [INTERNAL_ERROR] Unexpected undefined. Please file an issue to report this error." ), new c("INTERNAL_ERROR", "Unexpected undefined"); return n; } function T(n, e, r, t, o, i, a) { if (!n) { if (!e) return J(r, o); let [d, m] = h(w(e, i)); if (d === a) return `${d}${h( _("", m, r, t) )}`; if (m) return d; let p = h( Y( d, r, t, o, i ) ); return p === a ? `${p}${r[r.length - 1]}` : p; } if (!e) { let d = h(w(n, i)), [m, p] = d, F = h( Z( m, r, t, o, i ) ); return F !== null ? F : `${m}${h( _(p, null, r, t) )}`; } let l = h(w(n, i)), s = h(w(e, i)), [u, f] = l, [g, y] = s; if (u === g) return `${u}${h( _(f, y, r, t) )}`; let A = h( Z( u, r, t, o, i ) ); return A !== null && A !== g ? ( // 1. If incrementing a's integer doesn't reach b's integer, // we can use the incremented value (shorter key) A ) : ( // 2. If incrementing a's integer equals b's integer or we can't increment, // we need to use a's integer with a fractional part that sorts after a's fractional part `${u}${h( _(f, null, r, t) )}` ); } function rn(n, e, r, t, o, i, a) { return n != null && !L( n, r, t, i, a ) || e != null && !L( e, r, t, i, a ) || n != null && e != null && e <= n ? void 0 : T( n, e, r, t, o, i, a ); } function q(n, e, r, ...t) { if (r < 1) return []; if (r === 1) return [T(n, e, ...t)]; if (e == null) { let a = n; return Array.from( { length: r }, () => a = T(a, e, ...t) ); } if (n == null) { let a = e; return Array.from( { length: r }, () => a = T(n, a, ...t) ).reverse(); } let o = r >> 1, i = T(n, e, ...t); return [ ...q(n, i, o, ...t), i, ...q(i, e, r - o - 1, ...t) ]; } function tn(n, e, r, t, o, i, a, l) { return n != null && !L( n, t, o, a, l ) || e != null && !L( e, t, o, a, l ) || n != null && e != null && e <= n ? void 0 : q( n, e, r, t, o, i, a, l ); } function W(n, e) { let r = e.length, t = ""; for (; n > 0; ) t += e[n % r], n = Math.floor(n / r); return t; } // src/lib/utils.ts var on = "INITIALIZATION_FAILED"; function an(n) { let e = n.split(""); if (e.length < 4) throw new c( on, "Base string must have at least 4 unique characters" ); let r = -1; for (let t of e) { let o = t.charCodeAt(0); if (o <= r) throw new c( on, "Base string characters must be unique and in ascending order" ); r = o; } return e; } function ln(n) { let e = an(n); return [e, new Map(e.map((r, t) => [r, t]))]; } function sn(n) { let e = an(n), r = e.length >> 1, t = e.map( (o, i) => [ i < r ? ( // For characters in the first half, assign negative values starting from -1 i - r ) : ( // For characters in the second half, assign positive values starting from 1 i - r + 1 ), // This maps to 1, 2, 3, etc. (skipping 0) o ] ); return [ new Map(t), new Map(t.map(([o, i]) => [i, o])) ]; } // src/factory.ts var cn = 50, fn = 5, O = "INVALID_FRACTIONAL_INDEX", U = "Invalid indices provided", S = "MAX_LENGTH_EXCEEDED", X = "Exceeded maximum length", C = "MAX_RETRIES_EXCEEDED", $ = "Exceeded maximum retries"; function Sn() { return /* @__PURE__ */ new Map(); } function un(n, e, r) { if (!n) return r(); let t = n.get(e); return t === void 0 && (t = r(), n.set(e, t)), t; } function K(n, e, r) { console.error( `FraciError: [INVALID_FRACTIONAL_INDEX] ${U}. a = ${n}, b = ${e}, skip = ${r} Make sure that - Fractional indices generated by the same fraci instance with the same configuration are being used as-is - Indices in different groups have not been mixed up - a (the first argument item) comes before b (the second argument item) in the group File an issue if you use the library correctly and still encounter this error.` ); } function dn({ maxLength: n = cn, maxRetries: e = fn } = {}) { return { base: { type: "binary" }, *generateKeyBetween(r, t, o = 0) { let i = nn(r, t); if (!i) throw K(r, t, o), new c( O, U ); for (let a = 0; a < e; a++) { let l = I(i, j(a + o)); if (l.length > n) throw new c( S, X ); yield l; } throw new c( C, $ ); }, *generateNKeysBetween(r, t, o, i = 0) { let a = en(r, t, o); if (!a) throw K(r, t, i), new c( O, U ); let l = a.reduce((s, u) => Math.max(s, u.length), 0); for (let s = 0; s < e; s++) { let u = j(s + i); if (l + u.length > n) throw new c( S, X ); yield a.map((f) => I(f, u)); } throw new c( C, $ ); } }; } function pn({ lengthBase: n, digitBase: e, maxLength: r = cn, maxRetries: t = fn }, o) { let [i, a] = un( o, `L${n}`, sn.bind(null, n) ), [l, s] = un( o, `D${e}`, ln.bind(null, e) ), u = Q(l, i); return { base: { type: "string", lengthBase: n, digitBase: e }, *generateKeyBetween(f, g, y = 0) { let A = rn( f, g, l, s, i, a, u ); if (!A) throw K(f, g, y), new c( O, U ); for (let d = 0; d < t; d++) { let m = `${A}${W(d + y, l)}`; if (m.length > r) throw new c( S, X ); yield m; } throw new c( C, $ ); }, *generateNKeysBetween(f, g, y, A = 0) { let d = tn( f, g, y, l, s, i, a, u ); if (!d) throw K(f, g, A), new c( O, U ); let m = d.reduce((p, F) => Math.max(p, F.length), 0); for (let p = 0; p < t; p++) { let F = W(p + A, l); if (m + F.length > r) throw new c( S, X ); yield d.map((gn) => `${gn}${F}`); } throw new c( C, $ ); } }; } function Xn(n, e) { return n.type === "binary" ? (e && console.warn("Fraci: Cache is not used for binary base"), dn(n)) : pn(n, e); } export { c as a, En as b, hn as c, cn as d, fn as e, Sn as f, dn as g, pn as h, Xn as i }; //# sourceMappingURL=chunk-VEBTP4GL.js.map