registerFile

Author: mbostock

src/runtime/index.ts

@@ -11,7 +11,7 @@ export * from "./stdlib/index.js";
 export type * from "./stdlib/databaseClient.js";
 export type * from "./stdlib/fileAttachment.js";
 export {DatabaseClient} from "./stdlib/databaseClient.js";
-export {FileAttachment} from "./stdlib/fileAttachment.js";
+export {FileAttachment, registerFile} from "./stdlib/fileAttachment.js";
 
 export const runtime = Object.assign(new Runtime({...library, __ojs_runtime: () => runtime}), {fileAttachments});
 export const main = (runtime as typeof runtime & {main: Module}).main = runtime.module();

src/runtime/stdlib/fileAttachment.ts

@@ -47,6 +47,7 @@ export interface FileAttachment {
   html(): Promise<Document>;
 }
 
+// TODO Enforce that files have been registered; throw error if not found.
 export const FileAttachment = (name: string, base = document.baseURI): FileAttachment => {
   const href = new URL(name, base).href;
   let file = files.get(href);
@@ -57,6 +58,31 @@ export const FileAttachment = (name: string, base = document.baseURI): FileAttac
   return file;
 };
 
+export interface FileInfo {
+  path: string;
+  mimeType?: string;
+  lastModified?: number;
+  size?: number;
+}
+
+export function registerFile(name: string, info: FileInfo, base: string | URL = location.href) {
+  const href = new URL(name, base).href;
+  if (info == null) {
+    files.delete(href);
+  } else {
+    const {path, mimeType, lastModified, size} = info;
+    const file = new FileAttachmentImpl(
+      new URL(path, base).href,
+      name.split("/").pop()!,
+      mimeType,
+      lastModified,
+      size
+    );
+    files.set(href, file);
+    return file;
+  }
+}
+
 async function fetchFile(file: FileAttachment): Promise<Response> {
   const response = await fetch(file.href);
   if (!response.ok) throw new Error(`Unable to load file: ${file.name}`);