feeef 0.8.4 → 0.8.5

package/build/src/feeef/feeef.d.ts

@@ -4,6 +4,7 @@ import { ProductRepository } from './repositories/products.js';
 import { StoreRepository } from './repositories/stores.js';
 import { UserRepository } from './repositories/users.js';
 import { AppRepository } from './repositories/apps.js';
+import { OAuthRepository } from './repositories/oauth.js';
 import { DepositRepository } from './repositories/deposits.js';
 import { PromoRepository } from './repositories/promos.js';
 import { TransferRepository } from './repositories/transfers.js';
@@ -92,6 +93,10 @@ export declare class FeeeF {
      * The repository for managing developer-registered apps (OAuth clients).
      */
     apps: AppRepository;
+    /**
+     * The repository for OAuth2 authorize/token/revoke/introspect operations.
+     */
+    oauth: OAuthRepository;
     /**
      * The repository for managing orders.
      */

package/build/src/feeef/repositories/apps.d.ts

@@ -9,6 +9,8 @@ export interface AppEntity {
     /** Owner user id. Always present from API. */
     userId?: string;
     name: string;
+    /** Optional app logo URL for OAuth consent and dashboard UI. */
+    logoUrl?: string | null;
     clientId: string;
     redirectUris: string[];
     scopes: string[];
@@ -25,6 +27,8 @@ export interface AppEntity {
  */
 export interface AppCreateInput {
     name: string;
+    /** Optional app logo URL. */
+    logoUrl?: string;
     redirectUris: string[];
     scopes: string[];
     userId?: string;
@@ -34,6 +38,8 @@ export interface AppCreateInput {
  */
 export interface AppUpdateInput {
     name?: string;
+    /** Optional app logo URL; pass null to clear. */
+    logoUrl?: string | null;
     redirectUris?: string[];
     scopes?: string[];
     active?: boolean;
@@ -76,6 +82,14 @@ export declare class AppRepository extends ModelRepository<AppEntity, AppCreateI
     regenerateSecret(id: string): Promise<AppEntity>;
     /**
      * 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).
+     *
+     * If the user is not logged in yet, API `GET /oauth/authorize` returns:
+     * - `401 login_required`
+     * - `login_url` (accounts sign-in URL with `next=...`)
+     *
+     * The client should navigate to `login_url`, let the user sign in, and then
+     * continue by opening the original authorize URL again (or rely on `next`).
      *
      * @param params - Parameters for the authorize URL.
      * @param params.baseUrl - API base URL (e.g. https://api.feeef.org/api/v1).

package/build/src/feeef/repositories/oauth.d.ts

@@ -0,0 +1,77 @@
+import { AxiosInstance } from 'axios';
+/**
+ * OAuth token response from `POST /oauth/token`.
+ */
+export interface OAuthTokenResponse {
+    access_token: string;
+    token_type: string;
+    expires_in: number;
+    scope: string;
+}
+/**
+ * OAuth revoke response from `POST /oauth/revoke`.
+ */
+export interface OAuthRevokeResponse {
+    revoked: boolean;
+}
+/**
+ * OAuth introspection response from `POST /oauth/introspect`.
+ */
+export interface OAuthIntrospectResponse {
+    active: boolean;
+    scope?: string;
+    client_id?: string | null;
+    username?: string | null;
+    token_type?: string;
+    exp?: number | null;
+}
+/**
+ * Parameters for building the browser authorization URL.
+ */
+export interface OAuthAuthorizeUrlParams {
+    baseUrl: string;
+    clientId: string;
+    redirectUri: string;
+    scope?: string[];
+    state?: string;
+    codeChallenge?: string;
+    codeChallengeMethod?: 'S256' | 'plain' | string;
+}
+/**
+ * Parameters for exchanging authorization code to access token.
+ */
+export interface OAuthExchangeCodeParams {
+    code: string;
+    redirectUri: string;
+    clientId: string;
+    clientSecret: string;
+    codeVerifier?: string;
+}
+/**
+ * Repository for Feeef OAuth2 developer endpoints.
+ * This exposes typed wrappers for:
+ * - `/oauth/authorize` (URL helper)
+ * - `/oauth/token`
+ * - `/oauth/revoke`
+ * - `/oauth/introspect`
+ */
+export declare class OAuthRepository {
+    client: AxiosInstance;
+    constructor(client: AxiosInstance);
+    /**
+     * Builds the authorize URL for browser redirect.
+     */
+    static buildAuthorizeUrl(params: OAuthAuthorizeUrlParams): string;
+    /**
+     * Exchanges an authorization code for an access token.
+     */
+    exchangeAuthorizationCode(params: OAuthExchangeCodeParams): Promise<OAuthTokenResponse>;
+    /**
+     * Revokes an OAuth token.
+     */
+    revokeToken(token: string, tokenTypeHint?: string): Promise<OAuthRevokeResponse>;
+    /**
+     * Introspects an OAuth token.
+     */
+    introspectToken(token: string): Promise<OAuthIntrospectResponse>;
+}

package/build/src/feeef/repositories/orders.d.ts

@@ -78,7 +78,10 @@ export interface OrderListOptions {
     page?: number;
     offset?: number;
     limit?: number;
+    /** Single store (legacy). Ignored when storeIds is non-empty. */
     storeId?: string;
+    /** Multiple stores for unified order list. Takes precedence over storeId when non-empty. */
+    storeIds?: string[];
     status?: OrderStatus | OrderStatus[];
     deliveryStatus?: DeliveryStatus;
     paymentStatus?: PaymentStatus;

package/build/src/feeef/repositories/promos.d.ts

@@ -62,7 +62,14 @@ export declare class PromoRepository {
         page?: number;
         limit?: number;
         validNow?: boolean;
+        filterator?: string;
     }): Promise<PromoListResponse>;
+    /**
+     * Fetches a single promo by id.
+     */
+    find(params: {
+        id: string;
+    }): Promise<PromoEntity>;
     /**
      * Validates a promo code. Returns validation result with discount info or reason.
      */

package/build/src/index.d.ts

@@ -18,6 +18,7 @@ export * from './core/entities/currency.js';
 export * from './core/entities/feedback.js';
 export * from './feeef/repositories/repository.js';
 export * from './feeef/repositories/apps.js';
+export * from './feeef/repositories/oauth.js';
 export * from './feeef/repositories/deposits.js';
 export * from './feeef/repositories/promos.js';
 export * from './feeef/repositories/transfers.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "feeef",
   "description": "feeef sdk for javascript",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "main": "build/index.js",
   "type": "module",
   "files": [