feeef 0.8.2 → 0.8.3

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

@@ -3,6 +3,7 @@ import { OrderRepository } from './repositories/orders.js';
 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 { DepositRepository } from './repositories/deposits.js';
 import { TransferRepository } from './repositories/transfers.js';
 import { CategoryRepository } from './repositories/categories.js';
@@ -86,6 +87,10 @@ export declare class FeeeF {
      * The repository for managing users.
      */
     users: UserRepository;
+    /**
+     * The repository for managing developer-registered apps (OAuth clients).
+     */
+    apps: AppRepository;
     /**
      * The repository for managing orders.
      */

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

@@ -0,0 +1,78 @@
+import { AxiosInstance } from 'axios';
+import { ModelRepository } from './repository.js';
+/**
+ * Developer-registered app (OAuth client) returned by the apps API.
+ * clientSecret is present only on create and regenerateSecret responses.
+ */
+export interface AppEntity {
+    id: string;
+    name: string;
+    clientId: string;
+    redirectUris: string[];
+    scopes: string[];
+    active: boolean;
+    lastUsedAt: string | null;
+    createdAt: string;
+    updatedAt: string | null;
+    /** Present only when returned from create or regenerateSecret. Store securely. */
+    clientSecret?: string;
+}
+/**
+ * Input for creating a new app.
+ */
+export interface AppCreateInput {
+    name: string;
+    redirectUris: string[];
+    scopes: string[];
+}
+/**
+ * Input for updating an existing app.
+ */
+export interface AppUpdateInput {
+    name?: string;
+    redirectUris?: string[];
+    scopes?: string[];
+    active?: boolean;
+}
+/**
+ * Repository for developer-registered apps (CRUD and regenerate secret).
+ * Requires an authenticated user (Bearer token).
+ *
+ * Terminology: "app" / "apps" is used consistently for the resource;
+ * OAuth is used only for the flow (authorize, token endpoints).
+ */
+export declare class AppRepository extends ModelRepository<AppEntity, AppCreateInput, AppUpdateInput> {
+    constructor(client: AxiosInstance);
+    /**
+     * Regenerates the client secret for the app. Returns the app with
+     * clientSecret set once; store it securely.
+     *
+     * @param id - The app id.
+     * @returns The app including clientSecret.
+     */
+    regenerateSecret(id: string): Promise<AppEntity>;
+    /**
+     * Builds the OAuth authorize URL to which the user should be redirected.
+     *
+     * @param params - Parameters for the authorize URL.
+     * @param params.baseUrl - API base URL (e.g. https://api.feeef.org/api/v1).
+     * @param params.clientId - The app client id.
+     * @param params.redirectUri - Redirect URI registered for the app.
+     * @param params.responseType - Must be 'code' for authorization code flow.
+     * @param params.scope - Optional list of scopes (space-separated in URL).
+     * @param params.state - Optional state for CSRF protection.
+     * @param params.codeChallenge - Optional PKCE code challenge.
+     * @param params.codeChallengeMethod - Optional 'S256' or 'plain'.
+     * @returns The full authorize URL.
+     */
+    static buildAuthorizeUrl(params: {
+        baseUrl: string;
+        clientId: string;
+        redirectUri: string;
+        responseType: string;
+        scope?: string[];
+        state?: string;
+        codeChallenge?: string;
+        codeChallengeMethod?: string;
+    }): string;
+}

package/build/src/index.d.ts

@@ -17,6 +17,7 @@ export * from './core/entities/city.js';
 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/deposits.js';
 export * from './feeef/repositories/transfers.js';
 export * from './feeef/repositories/shipping_prices.js';
@@ -33,6 +34,7 @@ export * from './feeef/repositories/countries.js';
 export * from './feeef/repositories/states.js';
 export * from './feeef/repositories/cities.js';
 export * from './feeef/repositories/currencies.js';
+export type { AppEntity, AppCreateInput, AppUpdateInput } from './feeef/repositories/apps.js';
 export type { TransferEntity, TransferCreateInput, TransferUpdateInput, TransferType, TransferListOptions, } from './feeef/repositories/transfers.js';
 export type { DepositEntity, DepositCreateInput, DepositUpdateInput, DepositStatus, DepositListOptions, PayPalOrderResponse, PayPalCaptureResponse, } from './feeef/repositories/deposits.js';
 export * from './core/embadded/address.js';

package/package.json

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