Import JSON AD string function

Author: joepio

CHANGELOG.md

@@ -6,6 +6,9 @@ This changelog covers all three packages, as they are (for now) updated as a who
 
 - Add `Store.parseMetaTags` to load JSON-AD objects stored in the DOM. Speeds up initial page load by allowing server to set JSON-AD objects in the initial HTML response.
 - Move static assets around, align build with server and fix PWA #292
+- `store.createSubject` allows creating nested paths
+- Add `useChildren` hook and `Store.getChildren` method
+- Add `Store.postToServer` method, add `endpoints`, `import_json_ad_string`
 
 ## v0.35.0
 

lib/src/endpoints.ts

@@ -0,0 +1,11 @@
+import { Store } from './index.js';
+/** Endpoints are Resources that can respond to query parameters or POST bodies */
+
+/** POSTs a JSON-AD object to the Server */
+export function importJsonAdString(
+  store: Store,
+  importerUrl: string,
+  jsonAdString: string,
+) {
+  return store.postToServer(importerUrl, jsonAdString);
+}

lib/src/store.ts

@@ -435,6 +435,22 @@ export class Store {
     });
   }
 
+  /** Sends an HTTP POST request to the server to the Subject. Parses the returned Resource and adds it to the store. */
+  public async postToServer(
+    parent: string,
+    data: ArrayBuffer | string,
+  ): Promise<Resource> {
+    const url = new URL(parent);
+    url.searchParams.set('parent', parent);
+    url.pathname = '/import';
+
+    return this.fetchResourceFromServer(url.toString(), {
+      body: data,
+      noWebSocket: true,
+      method: 'POST',
+    });
+  }
+
   /** Removes (destroys / deletes) resource from this store */
   public removeResource(subject: string): void {
     const resource = this.resources.get(subject);

react/src/useImporter.ts

@@ -1,5 +1,9 @@
 import { useEffect, useState } from 'react';
-import { useResource } from './index.js';
+import {
+  importJsonAdString as importJsonAdString,
+  useResource,
+  useStore,
+} from './index.js';
 
 /** Easily send JSON-AD or a URL containing it to your server. */
 export function useImporter(importerUrl?: string) {