@fabriktor/client 0.0.22 → 0.0.24

package/dist/src/core/http.d.ts

@@ -1,5 +1,6 @@
 import { HTTPMethodDelete, HTTPMethodGet, HTTPMethodPatch, HTTPMethodPost } from "@fabriktor/schema";
 import type { OperationResult } from "@fabriktor/schema";
+import type { IdempotencyStore } from "./idempotency.js";
 export type Method = typeof HTTPMethodGet | typeof HTTPMethodPost | typeof HTTPMethodPatch | typeof HTTPMethodDelete;
 export type Op<T> = Omit<OperationResult, "value"> & {
     value?: T;
@@ -19,12 +20,14 @@ export interface HTTPDoer {
 }
 export type HTTPClientOptions = {
     fetcher: Fetcher;
+    idempotency: IdempotencyStore;
 };
 export declare class WebFetcher implements Fetcher {
     fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
 }
 export declare class HTTPClient implements HTTPDoer {
     private fetcher;
+    private idempotency;
     constructor(opts: HTTPClientOptions);
     do<T, R>(opts: HTTPOptions<T>): Promise<R>;
 }

package/dist/src/core/http.js

@@ -5,6 +5,7 @@
 // a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
 import { MimeJSON, } from "@fabriktor/schema";
 import { errFromHTTP, errHTTPRequestFailed, errHTTPResponseInvalid, } from "./err.js";
+import { applyIdempotencyHeader, DefaultIdempotencyStore, } from "./idempotency.js";
 const headerAuthorization = "authorization";
 const headerContentType = "content-type";
 const prefixBearer = "Bearer";
@@ -18,21 +19,33 @@ function noContent(res) {
 }
 export class HTTPClient {
     fetcher;
+    idempotency;
     constructor(opts) {
         this.fetcher = opts.fetcher;
+        this.idempotency = opts.idempotency;
     }
     async do(opts) {
+        const h = headers(opts);
+        const idempotencyToken = applyIdempotencyHeader({
+            headers: h,
+            store: this.idempotency,
+            method: opts.method,
+            path: opts.path,
+        });
         let res;
         try {
             res = await this.fetcher.fetch(url(opts.base_url, opts.path), {
                 method: opts.method,
-                headers: headers(opts),
+                headers: h,
                 body: body(opts.body),
             });
         }
         catch (err) {
             throw errHTTPRequestFailed(err);
         }
+        if (res.ok && idempotencyToken !== undefined) {
+            this.idempotency.reset(opts.method, opts.path);
+        }
         if (!res.ok) {
             return await fail(res);
         }
@@ -50,6 +63,7 @@ export class HTTPClient {
 export function newHTTPClient(opts) {
     return new HTTPClient({
         fetcher: opts?.fetcher ?? new WebFetcher(),
+        idempotency: opts?.idempotency ?? new DefaultIdempotencyStore(),
     });
 }
 function url(base, path) {

package/dist/src/core/idempotency.d.ts

@@ -0,0 +1,17 @@
+export declare const idempotentMethods: Set<string>;
+export type IdempotencyStore = {
+    get(method: string, path: string): string;
+    reset(method: string, path: string): void;
+};
+export declare class DefaultIdempotencyStore implements IdempotencyStore {
+    private tokens;
+    get(method: string, path: string): string;
+    reset(method: string, path: string): void;
+}
+export declare function shouldUseIdempotency(method: string): boolean;
+export declare function applyIdempotencyHeader(opts: {
+    headers: Headers;
+    store: IdempotencyStore;
+    method: string;
+    path: string;
+}): string | undefined;

package/dist/src/core/idempotency.js

@@ -0,0 +1,40 @@
+// Copyright (C) Fabriktor, Inc. 2025-present.
+//
+// Licensed under the Apache License, Version 2.0 (the "License"); you may
+// not use this file except in compliance with the License. You may obtain
+// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+import { HeaderIdempotency, HTTPMethodPost, HTTPMethodPatch, } from "@fabriktor/schema";
+export const idempotentMethods = new Set([HTTPMethodPost, HTTPMethodPatch]);
+function newToken() {
+    return crypto.randomUUID();
+}
+function key(method, path) {
+    return `${method.toUpperCase()} ${path}`;
+}
+export class DefaultIdempotencyStore {
+    tokens = new Map();
+    get(method, path) {
+        const k = key(method, path);
+        const current = this.tokens.get(k);
+        if (current) {
+            return current;
+        }
+        const next = newToken();
+        this.tokens.set(k, next);
+        return next;
+    }
+    reset(method, path) {
+        this.tokens.delete(key(method, path));
+    }
+}
+export function shouldUseIdempotency(method) {
+    return idempotentMethods.has(method.toUpperCase());
+}
+export function applyIdempotencyHeader(opts) {
+    if (!shouldUseIdempotency(opts.method)) {
+        return undefined;
+    }
+    const token = opts.store.get(opts.method, opts.path);
+    opts.headers.set(HeaderIdempotency, token);
+    return token;
+}

package/dist/src/index.d.ts

@@ -3,6 +3,7 @@ export * from "./core/col.js";
 export * from "./core/crud.js";
 export * from "./core/err.js";
 export * from "./core/http.js";
+export * from "./core/idempotency.js";
 export * from "./core/path.js";
 export * from "./preferences/preferences.js";
 export * from "./users/tmp_phones.js";

package/dist/src/index.js

@@ -3,6 +3,7 @@ export * from "./core/col.js";
 export * from "./core/crud.js";
 export * from "./core/err.js";
 export * from "./core/http.js";
+export * from "./core/idempotency.js";
 export * from "./core/path.js";
 export * from "./preferences/preferences.js";
 export * from "./users/tmp_phones.js";

package/dist/src/users/users.d.ts

@@ -1,4 +1,4 @@
-import type { InUser, OperationResult, PLUsersContactList, PLUsersForgotPassword, PLUsersResolveUsername, PLUsersSignInLink, UpsertResult, User } from "@fabriktor/schema";
+import type { InUser, OperationResult, PLUsersContactList, PLUsersForgotPassword, PLUsersResolveUsername, PLUsersVerifyEmail, PLUsersSignInLink, UpsertResult, User } from "@fabriktor/schema";
 import type { TokenProvider } from "../core/auth.js";
 import type { HTTPDoer, Op } from "../core/http.js";
 export type BootstrapOptions = {
@@ -7,6 +7,7 @@ export type BootstrapOptions = {
 export type ResolveUsernameOptions = PLUsersResolveUsername;
 export type ForgotPasswordOptions = PLUsersForgotPassword;
 export type SendSignInLinkOptions = PLUsersSignInLink;
+export type SendEmailVerificationOptions = PLUsersVerifyEmail;
 export type MatchOptions = PLUsersContactList;
 export type SearchOptions = {
     q: string;
@@ -18,7 +19,7 @@ export type GetByUIDOptions = {
 export interface UsersOperator {
     bootstrap(opts: BootstrapOptions): Promise<Op<UpsertResult>>;
     sync(): Promise<OperationResult>;
-    sendEmailVerification(): Promise<void>;
+    sendEmailVerification(opts: SendEmailVerificationOptions): Promise<void>;
     forgotPassword(opts: ForgotPasswordOptions): Promise<void>;
     sendSignInLink(opts: SendSignInLinkOptions): Promise<void>;
     resolveUsername(opts: ResolveUsernameOptions): Promise<Op<string>>;
@@ -38,7 +39,7 @@ export declare class UsersClient implements UsersOperator {
     constructor(opts: UsersClientOptions);
     bootstrap(opts: BootstrapOptions): Promise<Op<UpsertResult>>;
     sync(): Promise<OperationResult>;
-    sendEmailVerification(): Promise<void>;
+    sendEmailVerification(opts: SendEmailVerificationOptions): Promise<void>;
     forgotPassword(opts: ForgotPasswordOptions): Promise<void>;
     sendSignInLink(opts: SendSignInLinkOptions): Promise<void>;
     resolveUsername(opts: ResolveUsernameOptions): Promise<Op<string>>;

package/dist/src/users/users.js

@@ -34,13 +34,16 @@ export class UsersClient {
             token,
         });
     }
-    async sendEmailVerification() {
+    async sendEmailVerification(opts) {
         const token = await requiredToken(this.get_token);
         return await this.http.do({
             base_url: this.base_url,
             path: userPath(PathUsersSendEmailVerification),
             method: HTTPMethodPost,
             token,
+            body: {
+                language: opts.language,
+            },
         });
     }
     async forgotPassword(opts) {
@@ -63,34 +66,15 @@ export class UsersClient {
             },
         });
     }
-    // public async resolveUsername(
-    //   opts: ResolveUsernameOptions,
-    // ): Promise<Op<string>> {
-    //   return await this.http.do<PLUsersResolveUsername, Op<string>>({
-    //     base_url: this.base_url,
-    //     path: userPath(PathUsersResolveUsername),
-    //     method: HTTPMethodPost,
-    //     body: {
-    //       username: opts.username,
-    //     },
-    //   });
-    // }
     async resolveUsername(opts) {
-        const body = {
-            username: opts.username,
-        };
-        console.log("[client/users.resolveUsername] request", {
-            path: userPath(PathUsersResolveUsername),
-            body,
-        });
-        const out = await this.http.do({
+        return await this.http.do({
             base_url: this.base_url,
             path: userPath(PathUsersResolveUsername),
             method: HTTPMethodPost,
-            body,
+            body: {
+                username: opts.username,
+            },
         });
-        console.log("[client/users.resolveUsername] response", out);
-        return out;
     }
     async match(opts) {
         const token = await requiredToken(this.get_token);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fabriktor/client",
-  "version": "0.0.22",
+  "version": "0.0.24",
   "description": "![Fabriktor Logo](./img/fabriktor-character.gif)",
   "type": "module",
   "exports": {
@@ -17,6 +17,6 @@
     "typescript": "^6.0.3"
   },
   "dependencies": {
-    "@fabriktor/schema": "^0.0.15"
+    "@fabriktor/schema": "^0.0.18"
   }
 }