feeef 0.8.5 → 0.8.10

package/README.md

@@ -2,6 +2,14 @@
 
 `feeefjs` is a TypeScript library for managing feeef e-commerce platforms for self-hosted stores. It provides a wrapper for feeef rest api such like send order..., also have frontend srvices like the `CartService` class for managing cart items, shipping methods, and calculating totals. The library also includes a `NotifiableService` base class for handling listeners that react to changes in the service state.
 
+## Developer OAuth (third-party apps)
+
+Use `OAuthRepository.buildAuthorizeUrl` (point `baseUrl` at the **accounts** host, e.g. `https://accounts.feeef.org`) and `FeeeF` client `oauth.exchangeAuthorizationCode` / `revokeToken` / `introspectToken` against the **API** base (`.../v1`). Full flow, scopes, and troubleshooting: Feeef backend **`docs/OAUTH2_DEVELOPER.md`** (in the Adonis API repo).
+
+## Realtime (AdonisJS Transmit)
+
+Server-Sent Events use the same **API origin** as the REST client, but **without** the `/v1` or `/api/v1` prefix (e.g. `https://api.feeef.org/__transmit/events`). Use `createFeeefTransmit({ apiBaseUrl, getAccessToken })` so subscribe/unsubscribe POSTs get a proper `Authorization: Bearer …` header. The underlying client is the official [`@adonisjs/transmit-client`](https://www.npmjs.com/package/@adonisjs/transmit-client) (`Transmit`, `Subscription` are re-exported).
+
 ---
 
 # CartService & NotifiableService

package/build/index.js

@@ -661,6 +661,27 @@ var UserRepository = class extends ModelRepository {
     const res = await this.client.get(`/${this.resource}/auth/tokens`);
     return res.data;
   }
+  /**
+   * Revokes an access token (session) by opaque identifier from {@link tokens}.
+   */
+  async revokeAccessToken(identifier) {
+    if (!identifier || identifier === "undefined") {
+      throw new Error("Missing access token identifier");
+    }
+    await this.client.delete(`/${this.resource}/auth/tokens/${encodeURIComponent(identifier)}`);
+  }
+  /** Revokes every access token for the current user (sign out everywhere). */
+  async revokeAllAccessTokens() {
+    const res = await this.client.post(`/${this.resource}/auth/tokens/revoke-all`);
+    return res.data;
+  }
+  /**
+   * Lists OAuth apps that have per-user stored data for the current user (`app_user` rows).
+   */
+  async connectedApps() {
+    const res = await this.client.get(`/${this.resource}/auth/connected-apps`);
+    return res.data;
+  }
   /**
    * Signs in with Google OAuth.
    * @param options - The OAuth code and optional FCM token.
@@ -848,6 +869,9 @@ var AppRepository = class extends ModelRepository {
    * Builds the OAuth authorize URL to which the user should be redirected.
    * This is the first step of the authorization-code flow (similar UX to Google OAuth).
    *
+   * Production: opening this URL on the **API** host (`api.*`) issues a redirect to the same path on
+   * **accounts.*** so the consent screen appears on the trusted accounts domain; query params are preserved.
+   *
    * If the user is not logged in yet, API `GET /oauth/authorize` returns:
    * - `401 login_required`
    * - `login_url` (accounts sign-in URL with `next=...`)
@@ -880,6 +904,47 @@ var AppRepository = class extends ModelRepository {
     }
     return url.toString();
   }
+  /**
+   * Public `apps.public_data` (no auth). Pass [config] to skip Authorization if your axios instance adds it globally.
+   */
+  async getPublicData(id, config) {
+    const res = await this.client.get(`/${this.resource}/${id}/public-data`, config);
+    return res.data;
+  }
+  async getPrivateData(id) {
+    const res = await this.client.get(`/${this.resource}/${id}/private-data`);
+    return res.data;
+  }
+  async putPublicData(id, publicNamespaces) {
+    const res = await this.client.put(`/${this.resource}/${id}/public-data`, {
+      public: publicNamespaces
+    });
+    return res.data;
+  }
+  async putPrivateData(id, privateNamespaces) {
+    const res = await this.client.put(`/${this.resource}/${id}/private-data`, {
+      private: privateNamespaces
+    });
+    return res.data;
+  }
+  async getUserDataMe(id) {
+    const res = await this.client.get(`/${this.resource}/${id}/user-data/me`);
+    return res.data;
+  }
+  async putUserDataMe(id, publicNamespaces) {
+    const res = await this.client.put(`/${this.resource}/${id}/user-data/me`, {
+      public: publicNamespaces
+    });
+    return res.data;
+  }
+  async getUserDataForUser(appId, userId) {
+    const res = await this.client.get(`/${this.resource}/${appId}/user-data/users/${userId}`);
+    return res.data;
+  }
+  async putUserDataForUser(appId, userId, body) {
+    const res = await this.client.put(`/${this.resource}/${appId}/user-data/users/${userId}`, body);
+    return res.data;
+  }
 };
 
 // src/feeef/repositories/oauth.ts
@@ -4056,6 +4121,77 @@ var EmbaddedContactType = /* @__PURE__ */ ((EmbaddedContactType2) => {
   return EmbaddedContactType2;
 })(EmbaddedContactType || {});
 
+// src/realtime/transmit.ts
+import { Transmit } from "@adonisjs/transmit-client";
+import { Subscription, Transmit as Transmit2 } from "@adonisjs/transmit-client";
+function transmitRootFromApiBaseUrl(apiBaseUrl) {
+  let u = apiBaseUrl.trim().replace(/\/+$/, "");
+  if (u.endsWith("/api/v1")) {
+    u = u.slice(0, -"/api/v1".length);
+  } else if (u.endsWith("/v1")) {
+    u = u.slice(0, -"/v1".length);
+  }
+  return u;
+}
+function retrieveXsrfTokenFromCookie() {
+  const cookie = globalThis.document?.cookie;
+  if (!cookie) return null;
+  const match = cookie.match(new RegExp("(^|;\\s*)(XSRF-TOKEN)=([^;]*)"));
+  return match ? decodeURIComponent(match[3]) : null;
+}
+var FeeefTransmitHttpClient = class {
+  constructor(options, getAuthorizationHeader) {
+    this.options = options;
+    this.getAuthorizationHeader = getAuthorizationHeader;
+  }
+  send(request) {
+    return fetch(request);
+  }
+  createRequest(path, body) {
+    const headers = {
+      "Content-Type": "application/json",
+      "X-XSRF-TOKEN": retrieveXsrfTokenFromCookie() ?? ""
+    };
+    const auth = this.getAuthorizationHeader();
+    if (auth) {
+      headers.Authorization = auth.startsWith("Bearer ") ? auth : `Bearer ${auth}`;
+    }
+    return new Request(`${this.options.baseUrl}${path}`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({ uid: this.options.uid, ...body }),
+      credentials: "include"
+    });
+  }
+};
+function createFeeefTransmit(options) {
+  const baseUrl = transmitRootFromApiBaseUrl(options.apiBaseUrl);
+  const getToken = options.getAccessToken ?? (() => void 0);
+  return new Transmit({
+    ...options.transmit,
+    baseUrl,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Transmit’s HttpClient is not exported; FeeefTransmitHttpClient matches its shape.
+    httpClientFactory: (url, uid) => new FeeefTransmitHttpClient({ baseUrl: url, uid }, () => {
+      const t = getToken();
+      if (t === null || t === void 0 || t === "") return void 0;
+      const s = String(t).trim();
+      return s.startsWith("Bearer ") ? s : `Bearer ${s}`;
+    })
+  });
+}
+function createFeeefTransmitFromAxios(client, options) {
+  const apiBaseUrl = client.defaults.baseURL ?? "";
+  return createFeeefTransmit({
+    ...options,
+    apiBaseUrl,
+    getAccessToken: () => {
+      const raw = client.defaults.headers.common?.Authorization;
+      if (typeof raw !== "string") return void 0;
+      return raw.replace(/^Bearer\s+/i, "").trim() || void 0;
+    }
+  });
+}
+
 // src/utils.ts
 var convertDartColorToCssNumber = (dartColor) => {
   const alpha = dartColor >> 24 & 255;
@@ -4158,6 +4294,7 @@ export {
   FeedbackRepository,
   FeedbackStatus,
   FeeeF,
+  FeeefTransmitHttpClient,
   GoogleSheetIntegrationApi,
   ImageGenerationsRepository,
   ImagePromptTemplatesRepository,
@@ -4192,8 +4329,10 @@ export {
   StoreRepository,
   StoreSubscriptionStatus,
   StoreSubscriptionType,
+  Subscription,
   TiktokPixelEvent,
   TransferRepository,
+  Transmit2 as Transmit,
   UserRepository,
   VariantOptionType,
   WebhookEvent,
@@ -4202,6 +4341,8 @@ export {
   ZimouDeliveryIntegrationApi,
   convertDartColorToCssNumber,
   convertOrderEntityToOrderTrackEntity,
+  createFeeefTransmit,
+  createFeeefTransmitFromAxios,
   createImageGenerationFormData,
   cssColorToHslString,
   dartColorToCssColor,
@@ -4237,6 +4378,7 @@ export {
   serializeAttachmentPayloads,
   serializeImagePromptTemplateCreate,
   serializeImagePromptTemplateUpdate,
+  transmitRootFromApiBaseUrl,
   tryFixPhoneNumber,
   validatePhoneNumber
 };