akanjs 2.2.4-rc.4 → 2.2.4

package/document/into.ts

@@ -150,6 +150,7 @@ export const into = <
   const DefaultModel = Object.assign(class DefaultModel {}, {
     [LOADER_META]: Object.assign({}, ...addMdls.map((mdl) => mdl[LOADER_META]), loaderInfoMap),
     _onSchema(schema: SchemaOf) {
+      //
     },
     _libsOnSchema(schema: SchemaOf) {
       libsOnSchemaFns.map((libsOnSchema) => libsOnSchema(schema));

package/fetch/client/fetchClient.ts

@@ -121,6 +121,7 @@ export class FetchClient {
         if (token) return { Authorization: `Bearer ${token}` };
       }
     } catch {
+      // Tests and standalone clients can run without Akan public env. Fall back to instance JWT.
     }
     return this.jwt ? { Authorization: `Bearer ${this.jwt}` } : {};
   }
@@ -128,6 +129,7 @@ export class FetchClient {
     this.sortKeyMap.set(refName, sortKeys);
   }
   #registerFilterQuery(suffix: string, args: SerializedArg[]) {
+    // TODO: Implement
   }
   #makeHttpFn(key: string, endpoint: SerializedEndpoint, prefix?: string) {
     const argLength = endpoint.args.length;
@@ -143,7 +145,8 @@ export class FetchClient {
           const url = FetchClient.makeHttpUrl(key, endpoint, prefix, argMap);
           const headers = this.#makeAuthHeaders(option);
           const baseUrl = option?.origin;
-
+          // A per-request origin override targets an arbitrary server, so the shared
+          // request-query cache (keyed by the client origin) must be bypassed.
           const requestQuery = () => this.http.get(url, { headers, baseUrl });
           const response = baseUrl
             ? await requestQuery()
@@ -417,12 +420,14 @@ export class FetchClient {
       getInit: `get${capRefName}Init${capSuffix}`,
     };
 
+    // 1. slice endpoints
     const endpoint = FetchClient.getEndpointFromSlice(refName, suffix, slice);
     const handler = Object.fromEntries(
       Object.entries(endpoint).map(([key, value]) => [key, this.#makeHttpFn(key, value, prefix)]),
     );
     Object.assign(this.handler, handler);
 
+    // 2. slice utils
     const argLength = slice.args.length;
     this.slice[sliceName] = { refName, sliceName, argLength };
     const listFn = this.handler[names.list] as (...args: unknown[]) => Promise<unknown[]>;

package/fetch/client/httpClient.ts

@@ -49,7 +49,8 @@ export class HttpClient {
     return await this.#readJsonResponse<Returns>(res);
   }
   #makeReqContent(data: FormData | Record<string, unknown>): { body: BodyInit; headers: Record<string, string> } {
-
+    // FormData: do not set Content-Type — fetch adds multipart boundary; a bare
+    // "multipart/form-data" without boundary makes servers throw ERR_FORMDATA_PARSE_ERROR.
     if (data instanceof FormData) return { body: data, headers: {} };
     return { body: JSON.stringify(data), headers: { "Content-Type": "application/json" } };
   }