queria 0.0.0 → 0.1.0

package/src/render/map.ts

@@ -0,0 +1,18 @@
+import type { Map, MapOptions, StyleSpecification } from "maplibre-gl";
+
+export type MapHandle = { map: Promise<Map>; destroy: () => void };
+
+/** Create a MapLibre map in an element. maplibre-gl is loaded on first use; include its CSS in your page. */
+export const mountMap = (
+  el: HTMLElement,
+  style: StyleSpecification | string,
+  options: Omit<MapOptions, "container" | "style"> = {},
+): MapHandle => {
+  const map = import("maplibre-gl").then(
+    ({ default: maplibregl }) => new maplibregl.Map({ container: el, style, ...options }),
+  );
+  const destroy = () => {
+    map.then((m) => m.remove(), console.error);
+  };
+  return { map, destroy };
+};

package/src/render/poweredBy.ts

@@ -0,0 +1,6 @@
+const logo = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 8373.1 2008.4"> <g transform="translate(0 127.1)"> <g fill="none" stroke="#7846BE" stroke-linecap="round" stroke-linejoin="round"> <circle cx="753.3" cy="753.3" r="604.3" stroke-width="297.9"/> <path d="M912.4 912.4 L1356.2 1356.2" stroke-width="291.7"/> <path d="M1560.4 1207.8 L1560.4 1560.4 L1207.8 1560.4" stroke-width="202.3"/> </g> <path fill="currentColor" d="M2665.5 1506.5Q2471.1 1506.5 2322.7 1415.4Q2174.2 1324.3 2091.2 1153.6Q2008.1 982.9 2008.1 745.9Q2008.1 508.6 2091.2 341.7Q2174.2 174.8 2322.7 87.4Q2471.1 0 2665.5 0Q2861.7 0 3009.3 88.3Q3156.8 176.6 3239.9 342.6Q3323 508.6 3323 745.9Q3323 982.9 3239.9 1153.6Q3156.8 1324.3 3009.3 1415.4Q2861.7 1506.5 2665.5 1506.5ZM2665.5 1245.1Q2767.5 1245.1 2841.7 1186.2Q2915.9 1127.3 2956.7 1014.8Q2997.6 902.4 2997.6 745.9Q2997.6 598.1 2956.7 492Q2915.9 385.9 2841.7 330Q2767.5 274 2665.5 274Q2563.8 274 2489.5 330Q2415.2 385.9 2375.2 492Q2335.2 598.1 2335.2 745.9Q2335.2 902.4 2375.2 1014.8Q2415.2 1127.3 2489.5 1186.2Q2563.8 1245.1 2665.5 1245.1ZM3142.5 1881.2Q2984.8 1881.2 2859.6 1827.7Q2734.4 1774.2 2646.5 1680.6Q2558.7 1587 2509.9 1468.9L2834.2 1435.8Q2861.8 1503.8 2915.7 1546.7Q2969.5 1589.7 3038.9 1608.7Q3108.4 1627.7 3178.2 1627.7Q3225.4 1627.7 3266.5 1620.2Q3307.6 1612.7 3340 1601.4L3397.6 1835.1Q3356.5 1855.1 3290.6 1868.2Q3224.7 1881.2 3142.5 1881.2Z M3906.6 1506.5Q3725.4 1506.5 3643.9 1387.1Q3562.3 1267.7 3562.3 1060.9V374.8H3880.1V1021.7Q3880.1 1141.5 3914.3 1188.1Q3948.6 1234.6 4022.2 1234.6Q4085 1234.6 4131.2 1205.2Q4177.3 1175.8 4226.2 1109.3V374.8H4544V1479.3H4284.8L4261.2 1324.1H4253.9Q4184.3 1407.1 4101.9 1456.8Q4019.5 1506.5 3906.6 1506.5Z M5330.3 1506.5Q5173.3 1506.5 5047.3 1437.6Q4921.4 1368.6 4847.4 1238.7Q4773.3 1108.8 4773.3 926.5Q4773.3 792.4 4816.5 685.6Q4859.7 578.8 4933.7 503Q5007.8 427.2 5101 387.4Q5194.2 347.6 5292.5 347.6Q5448.4 347.6 5552 416.4Q5655.7 485.1 5708 604.8Q5760.3 724.5 5760.3 877.2Q5760.3 920.7 5755.9 959.1Q5751.6 997.5 5745.9 1019.1H5081.1Q5095 1101.8 5135.3 1155.4Q5175.7 1208.9 5236.1 1235.7Q5296.5 1262.5 5372.5 1262.5Q5436.2 1262.5 5494.3 1244Q5552.3 1225.6 5612.8 1189.5L5719 1382.5Q5635.9 1440.4 5533 1473.4Q5430.1 1506.5 5330.3 1506.5ZM5075.9 808.2H5489.7Q5489.7 712 5444.3 651.8Q5399 591.6 5297.7 591.6Q5245.8 591.6 5199.5 615.4Q5153.2 639.2 5120.4 686.8Q5087.6 734.5 5075.9 808.2Z M5989.7 1479.3V374.8H6248.7L6272.6 568.6H6278.3Q6339.6 459 6423.6 403.3Q6507.5 347.6 6592.5 347.6Q6640.8 347.6 6670.4 354.2Q6700 360.7 6723.7 370.9L6671.2 644.5Q6640.6 636.5 6614.2 631.7Q6587.9 626.9 6551.4 626.9Q6489.8 626.9 6421.1 673.7Q6352.4 720.6 6307.5 834.9V1479.3Z M6870.3 1479.3V374.8H7188.1V1479.3ZM7029.4 208.6Q6947.6 208.6 6898.4 162.7Q6849.2 116.8 6849.2 39.5Q6849.2 -35.5 6898.4 -81.3Q6947.6 -127.1 7029.4 -127.1Q7109.3 -127.1 7159.5 -81.3Q7209.6 -35.5 7209.6 39.5Q7209.6 116.8 7159.5 162.7Q7109.3 208.6 7029.4 208.6Z M7758 1506.5Q7658.6 1506.5 7585 1462.3Q7511.4 1418.2 7471.2 1342.6Q7430.9 1267 7430.9 1174.4Q7430.9 998.7 7579.4 900.9Q7727.9 803.2 8055.4 767.5Q8052.3 718.2 8034.6 680.8Q8016.9 643.3 7978.6 622.7Q7940.4 602.1 7878 602.1Q7806.7 602.1 7734.4 629.5Q7662 656.8 7581.5 702.9L7469.6 492.9Q7539.5 450.3 7614.4 418.1Q7689.3 385.9 7770.6 366.8Q7851.8 347.6 7937.7 347.6Q8079.9 347.6 8176.4 402.3Q8272.8 457 8323 566.9Q8373.1 676.7 8373.1 843.3V1479.3H8114.1L8092.2 1365H8082.8Q8013.2 1426.1 7932.3 1466.3Q7851.3 1506.5 7758 1506.5ZM7864.9 1259Q7922 1259 7966.6 1233.3Q8011.1 1207.5 8055.4 1161.5V962.3Q7935 977.1 7863.9 1004.6Q7792.8 1032.1 7763 1068.7Q7733.2 1105.3 7733.2 1149.8Q7733.2 1206.5 7769.5 1232.8Q7805.8 1259 7864.9 1259Z"/> </g></svg>`;
+
+/** Markup of a link that shows the app is built on Queria. */
+export const poweredByHtml = (): string =>
+  '<a class="queria-powered" href="https://queria.io/" target="_blank" rel="noopener">Powered by ' +
+  `<span role="img" aria-label="Queria" style="display:inline-block;height:1em;width:4.2em;vertical-align:-0.15em">${logo}</span></a>`;

package/src/sql.test.ts

@@ -0,0 +1,21 @@
+import { describe, expect, it } from "vitest";
+import { datasetsIn, lit } from "./sql.js";
+
+describe("datasetsIn", () => {
+  it("finds datasets of three-part names", () => {
+    expect(datasetsIn("SELECT * FROM e_stat.census.population p JOIN lg_code.main.cities c USING (code)")).toEqual([
+      "e_stat",
+      "lg_code",
+    ]);
+  });
+  it("ignores names inside string literals and two-part names", () => {
+    expect(datasetsIn("SELECT 'a.b.c' AS s, t.x FROM mlit.main.stations t")).toEqual(["mlit"]);
+  });
+  it("ignores comments and quoted identifiers", () => {
+    expect(datasetsIn('SELECT x AS "a.b.c" -- d.e.f\nFROM /* g.h.i */ mlit.main.stations')).toEqual(["mlit"]);
+  });
+});
+
+describe("lit", () => {
+  it("escapes quotes", () => expect(lit("O'Hare")).toBe("'O''Hare'"));
+});

package/src/sql.ts

@@ -0,0 +1,19 @@
+/** Quote a string as an SQL literal. */
+export const lit = (s: string): string => `'${s.replaceAll("'", "''")}'`;
+
+/** Blank out string literals, quoted identifiers and comments, scanning left to right. */
+export const stripLiterals = (sql: string): string =>
+  sql.replace(/'(?:[^']|'')*'|"(?:[^"]|"")*"|--[^\n]*|\/\*[\s\S]*?\*\//g, (m) => (m.startsWith("'") ? "''" : " "));
+
+/**
+ * Dataset names referenced in SQL. Tables are written as <dataset>.<schema>.<table>,
+ * so the first part of every three-part name outside string literals and comments is a dataset.
+ * A struct field read as alias.column.field also matches; the client skips names that are not datasets.
+ */
+export const datasetsIn = (sql: string): string[] => [
+  ...new Set(
+    [...stripLiterals(sql).matchAll(/\b([a-z_][a-z0-9_]*)\.[a-z_][a-z0-9_]*\.[a-z_][a-z0-9_]*/gi)].map(
+      (m) => m[1].toLowerCase(),
+    ),
+  ),
+];