@7365admin1/layer-common 4.64.4 → 4.65.1

package/utils/vehicle-bulk-sheet.ts

@@ -97,6 +97,8 @@ export type UploadedSheet = {
   matchesTemplate: boolean;
   /** The heading line as the file spells it - for telling a person what it has. */
   header: string[];
+  /** A template example row was left in and was not read. */
+  exampleRowIgnored?: boolean;
 };
 
 /**
@@ -138,14 +140,16 @@ export function mapUploadedGrid(grid: string[][]): UploadedSheet {
   // Every line under the header is somebody's car. Nothing is dropped for
   // looking like something else - two people in one household can have the
   // same details but for the plate, and a repeated row is the person's to fix.
-  const rows = lines
-    .slice(1)
+  const body = lines.slice(1);
+  // The example row of a template the server made is marked beside it; it is nobody's car.
+  const rows = body
+    .filter((line) => !isExampleLine(line))
     .map((line) =>
       BULK_SHEET_HEADINGS.map((_, column) => String(line[column] ?? "").trim()),
     )
     .filter((line) => !isEmptyLine(line));
 
-  return { rows, matchesTemplate: true, header };
+  return { rows, matchesTemplate: true, header, exampleRowIgnored: body.some(isExampleLine) };
 }
 
 /**
@@ -385,3 +389,55 @@ export async function xlsxToGrid(data: ArrayBuffer | Uint8Array): Promise<string
 export function isWorkbookName(name: string): boolean {
   return /\.(xlsx|xlsm)$/i.test(String(name ?? ""));
 }
+
+/* ------------------------------ live templates ----------------------------- */
+
+/** Beside the example row of every template the server makes. */
+export const TEMPLATE_EXAMPLE_MARK = "Example – delete this row";
+
+/** Does this line carry the template's example-row mark? */
+export function isExampleLine(cells: string[]): boolean {
+  return (cells ?? []).some((cell) => String(cell ?? "").includes(TEMPLATE_EXAMPLE_MARK));
+}
+
+/**
+ * The hidden "_meta" sheet of a template the server made: which kind of
+ * template it is and the property it was made for (`kind`, `site`,
+ * `siteName`). Empty for any other workbook.
+ */
+export async function xlsxMeta(data: ArrayBuffer | Uint8Array): Promise<Record<string, string>> {
+  const bytes = data instanceof Uint8Array ? data : new Uint8Array(data);
+  const entries = readZipEntries(bytes);
+  const book = entries.get("xl/workbook.xml");
+  const rels = entries.get("xl/_rels/workbook.xml.rels");
+  if (!book || !rels) return {};
+  const sheet = (await readPart(bytes, book)).match(/<sheet\b[^>]*\bname="_meta"[^>]*>/)?.[0];
+  const rid = sheet?.match(/\br:id="([^"]+)"/)?.[1];
+  if (!rid) return {};
+  const relation = ((await readPart(bytes, rels)).match(/<Relationship\b[^>]*>/g) ?? []).find((tag) => tag.includes(` Id="${rid}"`));
+  const target = relation?.match(/\bTarget="([^"]+)"/)?.[1];
+  const part = target ? entries.get(target.startsWith("/") ? target.slice(1) : `xl/${target}`) : undefined;
+  if (!part) return {};
+  const sharedEntry = entries.get("xl/sharedStrings.xml");
+  const strings = sharedEntry ? sharedStringsOf(await readPart(bytes, sharedEntry)) : [];
+  const meta: Record<string, string> = {};
+  for (const line of sheetToGrid(await readPart(bytes, part), strings).slice(1)) {
+    if (line[0]) meta[String(line[0])] = String(line[1] ?? "");
+  }
+  return meta;
+}
+
+/**
+ * Why a template may not be used here, or "" when it may: a template made for
+ * another property, or a different kind of template. A workbook without the
+ * hidden sheet (an older template, a person's own file) is allowed.
+ */
+export function templateRefusal(meta: Record<string, string>, expected: { kind: string; site: string }): string {
+  if (meta.kind && meta.kind !== expected.kind) {
+    return "This is a different kind of template. Download the template on this screen and copy your rows into it.";
+  }
+  if (meta.site && expected.site && meta.site !== expected.site) {
+    return `This file was made for ${meta.siteName ? `"${meta.siteName}"` : "another property"}. Download the template on this screen and copy your rows into it.`;
+  }
+  return "";
+}