@marinade.finance/ts-subscription-client 1.0.1 → 1.0.2-beta.1

package/client.ts

@@ -8,10 +8,13 @@ import {
   type ListSubscriptionsQuery,
   type ListSubscriptionsAuth,
   type Subscription,
+  type ListNotificationsQuery,
+  type Notification,
   NetworkError,
 } from './types'
 
 const PATH_SUBSCRIPTIONS = '/subscriptions'
+const PATH_NOTIFICATIONS = '/notifications'
 
 export class SubscriptionClient {
   private readonly base_url: string
@@ -79,6 +82,34 @@ export class SubscriptionClient {
     })
   }
 
+  async listNotifications(
+    query: ListNotificationsQuery,
+  ): Promise<Notification[]> {
+    const params = new URLSearchParams()
+    params.set('user_id', query.user_id)
+    if (query.notification_type) {
+      params.set('notification_type', query.notification_type)
+    }
+    if (query.priority) {
+      params.set('priority', query.priority)
+    }
+    if (query.inner_type) {
+      params.set('inner_type', query.inner_type)
+    }
+    if (query.limit !== undefined) {
+      params.set('limit', query.limit.toString())
+    }
+    if (query.offset !== undefined) {
+      params.set('offset', query.offset.toString())
+    }
+    const path = `${PATH_NOTIFICATIONS}?${params.toString()}`
+
+    this.logger?.debug(`GET ${path}`)
+    return this.fetch<Notification[]>(path, {
+      method: 'GET',
+    })
+  }
+
   private async fetch<T>(path: string, init: RequestInit): Promise<T> {
     const url = `${this.base_url}${path}`
     const method = init.method ?? 'GET'

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { type SubscriptionClientConfig, type SubscribeRequest, type SubscribeResponse, type UnsubscribeRequest, type UnsubscribeResponse, type ListSubscriptionsQuery, type ListSubscriptionsAuth, type Subscription } from './types';
+import { type SubscriptionClientConfig, type SubscribeRequest, type SubscribeResponse, type UnsubscribeRequest, type UnsubscribeResponse, type ListSubscriptionsQuery, type ListSubscriptionsAuth, type Subscription, type ListNotificationsQuery, type Notification } from './types';
 export declare class SubscriptionClient {
     private readonly base_url;
     private readonly timeout_ms;
@@ -7,5 +7,6 @@ export declare class SubscriptionClient {
     subscribe(request: SubscribeRequest): Promise<SubscribeResponse>;
     unsubscribe(request: UnsubscribeRequest): Promise<UnsubscribeResponse>;
     listSubscriptions(query: ListSubscriptionsQuery, auth: ListSubscriptionsAuth): Promise<Subscription[]>;
+    listNotifications(query: ListNotificationsQuery): Promise<Notification[]>;
     private fetch;
 }

package/dist/client.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SubscriptionClient = void 0;
 const types_1 = require("./types");
 const PATH_SUBSCRIPTIONS = '/subscriptions';
+const PATH_NOTIFICATIONS = '/notifications';
 class SubscriptionClient {
     constructor(config) {
         this.base_url = config.base_url;
@@ -51,6 +52,30 @@ class SubscriptionClient {
             },
         });
     }
+    async listNotifications(query) {
+        const params = new URLSearchParams();
+        params.set('user_id', query.user_id);
+        if (query.notification_type) {
+            params.set('notification_type', query.notification_type);
+        }
+        if (query.priority) {
+            params.set('priority', query.priority);
+        }
+        if (query.inner_type) {
+            params.set('inner_type', query.inner_type);
+        }
+        if (query.limit !== undefined) {
+            params.set('limit', query.limit.toString());
+        }
+        if (query.offset !== undefined) {
+            params.set('offset', query.offset.toString());
+        }
+        const path = `${PATH_NOTIFICATIONS}?${params.toString()}`;
+        this.logger?.debug(`GET ${path}`);
+        return this.fetch(path, {
+            method: 'GET',
+        });
+    }
     async fetch(path, init) {
         const url = `${this.base_url}${path}`;
         const method = init.method ?? 'GET';

package/dist/index.d.ts

@@ -3,6 +3,6 @@ import type { SubscriptionClientConfig } from './types';
 export { SubscriptionClient };
 export { subscribeMessage, unsubscribeMessage, listSubscriptionsMessage, } from './message';
 export { NetworkError } from './types';
-export type { Logger, SubscriptionClientConfig, SubscribeRequest, SubscribeResponse, UnsubscribeRequest, UnsubscribeResponse, ListSubscriptionsQuery, ListSubscriptionsAuth, Subscription, } from './types';
+export type { Logger, SubscriptionClientConfig, SubscribeRequest, SubscribeResponse, UnsubscribeRequest, UnsubscribeResponse, ListSubscriptionsQuery, ListSubscriptionsAuth, Subscription, ListNotificationsQuery, Notification, } from './types';
 export declare const NOTIFICATION_TYPE_SAM_AUCTION = "sam_auction";
 export declare function createSubscriptionClient(config: SubscriptionClientConfig): SubscriptionClient;

package/dist/types.d.ts

@@ -62,6 +62,28 @@ export interface Subscription {
     created_at: string;
     telegram_status?: 'pending' | 'active' | 'inactive' | 'unsubscribed' | 'blocked';
 }
+/** GET /notifications query (public, no auth required) */
+export interface ListNotificationsQuery {
+    user_id: string;
+    notification_type?: string;
+    priority?: string;
+    inner_type?: string;
+    limit?: number;
+    offset?: number;
+}
+/** GET /notifications response item */
+export interface Notification {
+    id: number;
+    notification_type: string;
+    inner_type: string;
+    user_id: string;
+    priority: string;
+    message: string;
+    data: Record<string, unknown>;
+    notification_id: string | null;
+    relevance_until: string;
+    created_at: string;
+}
 export declare class NetworkError extends Error {
     readonly status?: number | undefined;
     readonly response?: unknown | undefined;

package/index.ts

@@ -19,6 +19,8 @@ export type {
   ListSubscriptionsQuery,
   ListSubscriptionsAuth,
   Subscription,
+  ListNotificationsQuery,
+  Notification,
 } from './types'
 
 export const NOTIFICATION_TYPE_SAM_AUCTION = 'sam_auction'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marinade.finance/ts-subscription-client",
-  "version": "1.0.1",
+  "version": "1.0.2-beta.1",
   "private": false,
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/types.ts

@@ -83,6 +83,30 @@ export interface Subscription {
     | 'blocked'
 }
 
+/** GET /notifications query (public, no auth required) */
+export interface ListNotificationsQuery {
+  user_id: string
+  notification_type?: string
+  priority?: string
+  inner_type?: string
+  limit?: number
+  offset?: number
+}
+
+/** GET /notifications response item */
+export interface Notification {
+  id: number
+  notification_type: string
+  inner_type: string
+  user_id: string
+  priority: string
+  message: string
+  data: Record<string, unknown>
+  notification_id: string | null
+  relevance_until: string
+  created_at: string
+}
+
 export class NetworkError extends Error {
   constructor(
     message: string,