@decibeltrade/sdk 0.3.1 → 0.4.1

package/dist/read/referrals/referrals.reader.d.ts

@@ -0,0 +1,98 @@
+import { BaseReader, BaseRequestArgs } from "../base-reader";
+import { UserReferralsRequestArgs } from "./referrals.types";
+export declare class ReferralsReader extends BaseReader {
+    /**
+     * Validate a referral code (check existence and active status).
+     */
+    validateCode(code: string, { fetchOptions }?: BaseRequestArgs): Promise<{
+        referral_code: string;
+        is_valid: boolean;
+        is_active: boolean;
+    }>;
+    /**
+     * Get referral information for a specific account.
+     */
+    getAccountReferral(account: string, { fetchOptions }?: BaseRequestArgs): Promise<{
+        account: string;
+        referrer_account: string;
+        referral_code: string;
+        is_affiliate_referral: boolean;
+        referred_at_ms: number;
+        is_active: boolean;
+    }>;
+    /**
+     * Redeem a referral code for an account.
+     */
+    redeemCode(args: {
+        referralCode: string;
+        account: string;
+    }, { fetchOptions }?: BaseRequestArgs): Promise<{
+        referral_code: string;
+        account: string;
+    }>;
+    /**
+     * Get aggregate referral statistics for a referrer.
+     */
+    getReferrerStats(account: string, { fetchOptions }?: BaseRequestArgs): Promise<{
+        referrer_account: string;
+        total_referrals: number;
+        total_codes_created: number;
+        is_affiliate: boolean;
+        codes: string[];
+        volume_threshold_met: boolean;
+    }>;
+    /**
+     * Get paginated list of users referred by a referrer.
+     */
+    getUserReferrals({ referrerAccount, limit, offset, fetchOptions, }: UserReferralsRequestArgs): Promise<{
+        account: string;
+        referrer_account: string;
+        referral_code: string;
+        is_affiliate_referral: boolean;
+        referred_at_ms: number;
+    }[]>;
+    /**
+     * Get all referral codes owned by an account with per-code usage stats.
+     */
+    getAffiliateCodes(account: string, { fetchOptions }?: BaseRequestArgs): Promise<{
+        owner_account: string;
+        codes: {
+            referral_code: string;
+            owner_account: string;
+            max_usage: number;
+            usage_count: number;
+            is_active: boolean;
+            is_affiliate: boolean;
+            source: "unknown" | "admin" | "auto" | "predeposit";
+            created_at_ms: number;
+        }[];
+        volume_threshold_met: boolean;
+    }>;
+    /**
+     * Get affiliate earnings breakdown and referred users for an account.
+     */
+    getAffiliateEarnings(account: string, { fetchOptions }?: BaseRequestArgs): Promise<{
+        affiliate_account: string;
+        is_affiliate: boolean;
+        earnings: {
+            l1_amps: number;
+            l2_amps: number;
+            total_amps: number;
+            l1_count: number;
+            l2_count: number;
+        };
+        users: {
+            items: {
+                account: string;
+                level: "L1" | "L2";
+                referred_by: string | null;
+                total_amps: number;
+                affiliate_amps_earned: number;
+                total_volume: number;
+                active: boolean;
+            }[];
+            total_count: number;
+        };
+    }>;
+}
+//# sourceMappingURL=referrals.reader.d.ts.map

package/dist/read/referrals/referrals.reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referrals.reader.d.ts","sourceRoot":"","sources":["../../../src/read/referrals/referrals.reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAOL,wBAAwB,EAEzB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,eAAgB,SAAQ,UAAU;IAC7C;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,GAAE,eAAoB;;;;;IASvE;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,GAAE,eAAoB;;;;;;;;IAShF;;OAEG;IACG,UAAU,CACd,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAC/C,EAAE,YAAY,EAAE,GAAE,eAAoB;;;;IAWxC;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,GAAE,eAAoB;;;;;;;;IAS9E;;OAEG;IACG,gBAAgB,CAAC,EACrB,eAAe,EACf,KAAK,EACL,MAAM,EACN,YAAY,GACb,EAAE,wBAAwB;;;;;;;IAmB3B;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,GAAE,eAAoB;;;;;;;;;;;;;;IAS/E;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,GAAE,eAAoB;;;;;;;;;;;;;;;;;;;;;;;CAUnF"}

package/dist/read/referrals/referrals.reader.js

@@ -0,0 +1,92 @@
+import { BaseReader } from "../base-reader";
+import { AccountReferralSchema, AffiliateCodesResponseSchema, AffiliateEarningsResponseSchema, RedeemReferralResponseSchema, ReferralCodeValidationSchema, ReferrerStatsSchema, UserReferralsResponseSchema, } from "./referrals.types";
+export class ReferralsReader extends BaseReader {
+    /**
+     * Validate a referral code (check existence and active status).
+     */
+    async validateCode(code, { fetchOptions } = {}) {
+        const response = await this.getRequest({
+            schema: ReferralCodeValidationSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/referrals/code/${encodeURIComponent(code)}`,
+            options: fetchOptions,
+        });
+        return response.data;
+    }
+    /**
+     * Get referral information for a specific account.
+     */
+    async getAccountReferral(account, { fetchOptions } = {}) {
+        const response = await this.getRequest({
+            schema: AccountReferralSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/referrals/account/${account}`,
+            options: fetchOptions,
+        });
+        return response.data;
+    }
+    /**
+     * Redeem a referral code for an account.
+     */
+    async redeemCode(args, { fetchOptions } = {}) {
+        const response = await this.postRequest({
+            schema: RedeemReferralResponseSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/referrals/redeem`,
+            body: { referral_code: args.referralCode, account: args.account },
+            options: fetchOptions,
+        });
+        return response.data;
+    }
+    /**
+     * Get aggregate referral statistics for a referrer.
+     */
+    async getReferrerStats(account, { fetchOptions } = {}) {
+        const response = await this.getRequest({
+            schema: ReferrerStatsSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/referrals/stats/${account}`,
+            options: fetchOptions,
+        });
+        return response.data;
+    }
+    /**
+     * Get paginated list of users referred by a referrer.
+     */
+    async getUserReferrals({ referrerAccount, limit, offset, fetchOptions, }) {
+        const queryParams = new URLSearchParams({ referrer_account: referrerAccount });
+        if (limit !== undefined) {
+            queryParams.set("limit", limit.toString());
+        }
+        if (offset !== undefined) {
+            queryParams.set("offset", offset.toString());
+        }
+        const response = await this.getRequest({
+            schema: UserReferralsResponseSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/referrals/users`,
+            queryParams,
+            options: fetchOptions,
+        });
+        return response.data;
+    }
+    /**
+     * Get all referral codes owned by an account with per-code usage stats.
+     */
+    async getAffiliateCodes(account, { fetchOptions } = {}) {
+        const response = await this.getRequest({
+            schema: AffiliateCodesResponseSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/affiliates/codes/${account}`,
+            options: fetchOptions,
+        });
+        return response.data;
+    }
+    /**
+     * Get affiliate earnings breakdown and referred users for an account.
+     */
+    async getAffiliateEarnings(account, { fetchOptions } = {}) {
+        const queryParams = new URLSearchParams({ limit: "1000" });
+        const response = await this.getRequest({
+            schema: AffiliateEarningsResponseSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/affiliates/earnings/${account}`,
+            queryParams,
+            options: fetchOptions,
+        });
+        return response.data;
+    }
+}

package/dist/read/referrals/referrals.types.d.ts

@@ -0,0 +1,136 @@
+import { z } from "zod/v4";
+import { BaseRequestArgs } from "../base-reader";
+import { PageParams } from "../pagination.types";
+export interface UserReferralsRequestArgs extends BaseRequestArgs, PageParams {
+    referrerAccount: string;
+}
+export declare const ReferralCodeValidationSchema: z.ZodObject<{
+    referral_code: z.ZodString;
+    is_valid: z.ZodBoolean;
+    is_active: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const RedeemReferralResponseSchema: z.ZodObject<{
+    referral_code: z.ZodString;
+    account: z.ZodString;
+}, z.core.$strip>;
+export declare const AccountReferralSchema: z.ZodObject<{
+    account: z.ZodString;
+    referrer_account: z.ZodString;
+    referral_code: z.ZodString;
+    is_affiliate_referral: z.ZodBoolean;
+    referred_at_ms: z.ZodNumber;
+    is_active: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const ReferrerStatsSchema: z.ZodObject<{
+    referrer_account: z.ZodString;
+    total_referrals: z.ZodNumber;
+    total_codes_created: z.ZodNumber;
+    is_affiliate: z.ZodBoolean;
+    codes: z.ZodArray<z.ZodString>;
+    volume_threshold_met: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const UserReferralSchema: z.ZodObject<{
+    account: z.ZodString;
+    referrer_account: z.ZodString;
+    referral_code: z.ZodString;
+    is_affiliate_referral: z.ZodBoolean;
+    referred_at_ms: z.ZodNumber;
+}, z.core.$strip>;
+export declare const UserReferralsResponseSchema: z.ZodArray<z.ZodObject<{
+    account: z.ZodString;
+    referrer_account: z.ZodString;
+    referral_code: z.ZodString;
+    is_affiliate_referral: z.ZodBoolean;
+    referred_at_ms: z.ZodNumber;
+}, z.core.$strip>>;
+export declare const AffiliateCodeSchema: z.ZodObject<{
+    referral_code: z.ZodString;
+    owner_account: z.ZodString;
+    max_usage: z.ZodNumber;
+    usage_count: z.ZodNumber;
+    is_active: z.ZodBoolean;
+    is_affiliate: z.ZodBoolean;
+    source: z.ZodEnum<{
+        unknown: "unknown";
+        admin: "admin";
+        auto: "auto";
+        predeposit: "predeposit";
+    }>;
+    created_at_ms: z.ZodNumber;
+}, z.core.$strip>;
+export declare const AffiliateCodesResponseSchema: z.ZodObject<{
+    owner_account: z.ZodString;
+    codes: z.ZodArray<z.ZodObject<{
+        referral_code: z.ZodString;
+        owner_account: z.ZodString;
+        max_usage: z.ZodNumber;
+        usage_count: z.ZodNumber;
+        is_active: z.ZodBoolean;
+        is_affiliate: z.ZodBoolean;
+        source: z.ZodEnum<{
+            unknown: "unknown";
+            admin: "admin";
+            auto: "auto";
+            predeposit: "predeposit";
+        }>;
+        created_at_ms: z.ZodNumber;
+    }, z.core.$strip>>;
+    volume_threshold_met: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const AffiliateReferredUserSchema: z.ZodObject<{
+    account: z.ZodString;
+    level: z.ZodEnum<{
+        L1: "L1";
+        L2: "L2";
+    }>;
+    referred_by: z.ZodNullable<z.ZodString>;
+    total_amps: z.ZodNumber;
+    affiliate_amps_earned: z.ZodNumber;
+    total_volume: z.ZodNumber;
+    active: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const AffiliateEarningsBreakdownSchema: z.ZodObject<{
+    l1_amps: z.ZodNumber;
+    l2_amps: z.ZodNumber;
+    total_amps: z.ZodNumber;
+    l1_count: z.ZodNumber;
+    l2_count: z.ZodNumber;
+}, z.core.$strip>;
+export declare const AffiliateEarningsResponseSchema: z.ZodObject<{
+    affiliate_account: z.ZodString;
+    is_affiliate: z.ZodBoolean;
+    earnings: z.ZodObject<{
+        l1_amps: z.ZodNumber;
+        l2_amps: z.ZodNumber;
+        total_amps: z.ZodNumber;
+        l1_count: z.ZodNumber;
+        l2_count: z.ZodNumber;
+    }, z.core.$strip>;
+    users: z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            account: z.ZodString;
+            level: z.ZodEnum<{
+                L1: "L1";
+                L2: "L2";
+            }>;
+            referred_by: z.ZodNullable<z.ZodString>;
+            total_amps: z.ZodNumber;
+            affiliate_amps_earned: z.ZodNumber;
+            total_volume: z.ZodNumber;
+            active: z.ZodBoolean;
+        }, z.core.$strip>>;
+        total_count: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ReferralCodeValidation = z.infer<typeof ReferralCodeValidationSchema>;
+export type RedeemReferralResponse = z.infer<typeof RedeemReferralResponseSchema>;
+export type AccountReferral = z.infer<typeof AccountReferralSchema>;
+export type ReferrerStats = z.infer<typeof ReferrerStatsSchema>;
+export type UserReferral = z.infer<typeof UserReferralSchema>;
+export type UserReferralsResponse = z.infer<typeof UserReferralsResponseSchema>;
+export type AffiliateCode = z.infer<typeof AffiliateCodeSchema>;
+export type AffiliateCodesResponse = z.infer<typeof AffiliateCodesResponseSchema>;
+export type AffiliateReferredUser = z.infer<typeof AffiliateReferredUserSchema>;
+export type AffiliateEarningsBreakdown = z.infer<typeof AffiliateEarningsBreakdownSchema>;
+export type AffiliateEarningsResponse = z.infer<typeof AffiliateEarningsResponseSchema>;
+//# sourceMappingURL=referrals.types.d.ts.map

package/dist/read/referrals/referrals.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referrals.types.d.ts","sourceRoot":"","sources":["../../../src/read/referrals/referrals.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,WAAW,wBAAyB,SAAQ,eAAe,EAAE,UAAU;IAC3E,eAAe,EAAE,MAAM,CAAC;CACzB;AAGD,eAAO,MAAM,4BAA4B;;;;iBAIvC,CAAC;AAGH,eAAO,MAAM,4BAA4B;;;iBAGvC,CAAC;AAGH,eAAO,MAAM,qBAAqB;;;;;;;iBAOhC,CAAC;AAGH,eAAO,MAAM,mBAAmB;;;;;;;iBAO9B,CAAC;AAMH,eAAO,MAAM,kBAAkB;;;;;;iBAM7B,CAAC;AAGH,eAAO,MAAM,2BAA2B;;;;;;kBAA8B,CAAC;AAGvE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;iBAS9B,CAAC;AAGH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;iBAIvC,CAAC;AAGH,eAAO,MAAM,2BAA2B;;;;;;;;;;;iBAQtC,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;iBAM3C,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ1C,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC1F,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}

package/dist/read/referrals/referrals.types.js

@@ -0,0 +1,85 @@
+import { z } from "zod/v4";
+// GET /api/v1/referrals/code/{code}
+export const ReferralCodeValidationSchema = z.object({
+    referral_code: z.string(),
+    is_valid: z.boolean(),
+    is_active: z.boolean(),
+});
+// POST /api/v1/referrals/redeem
+export const RedeemReferralResponseSchema = z.object({
+    referral_code: z.string(),
+    account: z.string(),
+});
+// GET /api/v1/referrals/account/{account}
+export const AccountReferralSchema = z.object({
+    account: z.string(),
+    referrer_account: z.string(),
+    referral_code: z.string(),
+    is_affiliate_referral: z.boolean(),
+    referred_at_ms: z.number(),
+    is_active: z.boolean(),
+});
+// GET /api/v1/referrals/stats/{account}
+export const ReferrerStatsSchema = z.object({
+    referrer_account: z.string(),
+    total_referrals: z.number(),
+    total_codes_created: z.number(),
+    is_affiliate: z.boolean(),
+    codes: z.array(z.string()),
+    volume_threshold_met: z.boolean(),
+});
+// GET /api/v1/affiliates/codes/{account}
+const ReferralCodeSourceSchema = z.enum(["admin", "auto", "predeposit", "unknown"]);
+// GET /api/v1/referrals/users
+export const UserReferralSchema = z.object({
+    account: z.string(),
+    referrer_account: z.string(),
+    referral_code: z.string(),
+    is_affiliate_referral: z.boolean(),
+    referred_at_ms: z.number(),
+});
+// GET /api/v1/referrals/users
+export const UserReferralsResponseSchema = z.array(UserReferralSchema);
+// GET /api/v1/affiliates/codes/{account}
+export const AffiliateCodeSchema = z.object({
+    referral_code: z.string(),
+    owner_account: z.string(),
+    max_usage: z.number(),
+    usage_count: z.number(),
+    is_active: z.boolean(),
+    is_affiliate: z.boolean(),
+    source: ReferralCodeSourceSchema,
+    created_at_ms: z.number(),
+});
+// GET /api/v1/affiliates/codes/{account}
+export const AffiliateCodesResponseSchema = z.object({
+    owner_account: z.string(),
+    codes: z.array(AffiliateCodeSchema),
+    volume_threshold_met: z.boolean(),
+});
+// GET /api/v1/affiliates/earnings/{account}
+export const AffiliateReferredUserSchema = z.object({
+    account: z.string(),
+    level: z.enum(["L1", "L2"]),
+    referred_by: z.string().nullable(),
+    total_amps: z.number(),
+    affiliate_amps_earned: z.number(),
+    total_volume: z.number(),
+    active: z.boolean(),
+});
+export const AffiliateEarningsBreakdownSchema = z.object({
+    l1_amps: z.number(),
+    l2_amps: z.number(),
+    total_amps: z.number(),
+    l1_count: z.number(),
+    l2_count: z.number(),
+});
+export const AffiliateEarningsResponseSchema = z.object({
+    affiliate_account: z.string(),
+    is_affiliate: z.boolean(),
+    earnings: AffiliateEarningsBreakdownSchema,
+    users: z.object({
+        items: z.array(AffiliateReferredUserSchema),
+        total_count: z.number(),
+    }),
+});

package/dist/read/streaks/streaks.reader.d.ts

@@ -0,0 +1,19 @@
+import { BaseReader } from "../base-reader";
+import { AccountStreaksRequestArgs } from "./streaks.types";
+export declare class StreaksReader extends BaseReader {
+    /**
+     * Get streak data for an owner including qualifying dates and grace days
+     * @param ownerAddr The owner address to get streak data for
+     * @returns The streak data with qualifying dates
+     */
+    getByOwner({ ownerAddr, fetchOptions }: AccountStreaksRequestArgs): Promise<{
+        owner: string;
+        currentStreak: number;
+        streakIpoints: number;
+        streakAmpsEstimate: number;
+        graceDaysAvailable: number;
+        graceDaysUsed: number;
+        qualifyingDates: string[];
+    }>;
+}
+//# sourceMappingURL=streaks.reader.d.ts.map

package/dist/read/streaks/streaks.reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaks.reader.d.ts","sourceRoot":"","sources":["../../../src/read/streaks/streaks.reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,yBAAyB,EAAwB,MAAM,iBAAiB,CAAC;AAElF,qBAAa,aAAc,SAAQ,UAAU;IAC3C;;;;OAIG;IACG,UAAU,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,yBAAyB;;;;;;;;;CAYxE"}

package/dist/read/streaks/streaks.reader.js

@@ -0,0 +1,19 @@
+import { BaseReader } from "../base-reader";
+import { AccountStreaksSchema } from "./streaks.types";
+export class StreaksReader extends BaseReader {
+    /**
+     * Get streak data for an owner including qualifying dates and grace days
+     * @param ownerAddr The owner address to get streak data for
+     * @returns The streak data with qualifying dates
+     */
+    async getByOwner({ ownerAddr, fetchOptions }) {
+        const queryParams = new URLSearchParams({ owner: ownerAddr });
+        const response = await this.getRequest({
+            schema: AccountStreaksSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/streaks/account`,
+            queryParams,
+            options: fetchOptions,
+        });
+        return response.data;
+    }
+}

package/dist/read/streaks/streaks.types.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod/v4";
+import { BaseRequestArgs } from "../base-reader";
+export interface AccountStreaksRequestArgs extends BaseRequestArgs {
+    /** The owner address to get streak data for */
+    ownerAddr: string;
+}
+export declare const AccountStreaksSchema: z.ZodObject<{
+    owner: z.ZodString;
+    currentStreak: z.ZodNumber;
+    streakIpoints: z.ZodNumber;
+    streakAmpsEstimate: z.ZodNumber;
+    graceDaysAvailable: z.ZodNumber;
+    graceDaysUsed: z.ZodNumber;
+    qualifyingDates: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type AccountStreaks = z.infer<typeof AccountStreaksSchema>;
+//# sourceMappingURL=streaks.types.d.ts.map

package/dist/read/streaks/streaks.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaks.types.d.ts","sourceRoot":"","sources":["../../../src/read/streaks/streaks.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,yBAA0B,SAAQ,eAAe;IAChE,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,oBAAoB;;;;;;;;iBAQ/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/read/streaks/streaks.types.js

@@ -0,0 +1,10 @@
+import { z } from "zod/v4";
+export const AccountStreaksSchema = z.object({
+    owner: z.string(),
+    currentStreak: z.number(),
+    streakIpoints: z.number(),
+    streakAmpsEstimate: z.number(),
+    graceDaysAvailable: z.number(),
+    graceDaysUsed: z.number(),
+    qualifyingDates: z.array(z.string()),
+});

package/dist/read/tier/tier.reader.d.ts

@@ -0,0 +1,21 @@
+import { BaseReader } from "../base-reader";
+import { TierInfoRequestArgs } from "./tier.types";
+export declare class TierReader extends BaseReader {
+    /**
+     * Get tier info for an owner based on percentile-based thresholds
+     * @param ownerAddr The owner address to get tier info for
+     * @returns Tier info with progress toward each tier
+     */
+    getByOwner({ ownerAddr, fetchOptions }: TierInfoRequestArgs): Promise<{
+        owner: string;
+        total_amps: number;
+        rank: number | null;
+        current_tier: string | null;
+        tiers: {
+            name: string;
+            hz_threshold: number;
+            progress: number;
+        }[];
+    }>;
+}
+//# sourceMappingURL=tier.reader.d.ts.map

package/dist/read/tier/tier.reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier.reader.d.ts","sourceRoot":"","sources":["../../../src/read/tier/tier.reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAkB,MAAM,cAAc,CAAC;AAEnE,qBAAa,UAAW,SAAQ,UAAU;IACxC;;;;OAIG;IACG,UAAU,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,mBAAmB;;;;;;;;;;;CAYlE"}

package/dist/read/tier/tier.reader.js

@@ -0,0 +1,19 @@
+import { BaseReader } from "../base-reader";
+import { TierInfoSchema } from "./tier.types";
+export class TierReader extends BaseReader {
+    /**
+     * Get tier info for an owner based on percentile-based thresholds
+     * @param ownerAddr The owner address to get tier info for
+     * @returns Tier info with progress toward each tier
+     */
+    async getByOwner({ ownerAddr, fetchOptions }) {
+        const queryParams = new URLSearchParams({ owner: ownerAddr });
+        const response = await this.getRequest({
+            schema: TierInfoSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/points/tier`,
+            queryParams,
+            options: fetchOptions,
+        });
+        return response.data;
+    }
+}

package/dist/read/tier/tier.types.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod/v4";
+import { BaseRequestArgs } from "../base-reader";
+export interface TierInfoRequestArgs extends BaseRequestArgs {
+    /** The owner address to get tier info for */
+    ownerAddr: string;
+}
+export declare const TierThresholdSchema: z.ZodObject<{
+    name: z.ZodString;
+    hz_threshold: z.ZodNumber;
+    progress: z.ZodNumber;
+}, z.core.$strip>;
+export declare const TierInfoSchema: z.ZodObject<{
+    owner: z.ZodString;
+    total_amps: z.ZodNumber;
+    rank: z.ZodNullable<z.ZodNumber>;
+    current_tier: z.ZodNullable<z.ZodString>;
+    tiers: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        hz_threshold: z.ZodNumber;
+        progress: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type TierThreshold = z.infer<typeof TierThresholdSchema>;
+export type TierInfo = z.infer<typeof TierInfoSchema>;
+//# sourceMappingURL=tier.types.d.ts.map

package/dist/read/tier/tier.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier.types.d.ts","sourceRoot":"","sources":["../../../src/read/tier/tier.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;iBAMzB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/read/tier/tier.types.js

@@ -0,0 +1,13 @@
+import { z } from "zod/v4";
+export const TierThresholdSchema = z.object({
+    name: z.string(),
+    hz_threshold: z.number(),
+    progress: z.number(),
+});
+export const TierInfoSchema = z.object({
+    owner: z.string(),
+    total_amps: z.number(),
+    rank: z.number().nullable(),
+    current_tier: z.string().nullable(),
+    tiers: z.array(TierThresholdSchema),
+});

package/dist/read/trading-amps/trading-amps.reader.d.ts

@@ -0,0 +1,18 @@
+import { BaseReader } from "../base-reader";
+import { OwnerTradingAmpsRequestArgs } from "./trading-amps.types";
+export declare class TradingAmpsReader extends BaseReader {
+    /**
+     * Get aggregated trading Hz (Amps) for an owner across all their active subaccounts
+     * @param ownerAddr The owner address to get trading Hz for
+     * @returns The aggregated trading Hz with per-subaccount breakdown
+     */
+    getByOwner({ ownerAddr, season, days, fetchOptions }: OwnerTradingAmpsRequestArgs): Promise<{
+        owner: string;
+        total_amps: number;
+        breakdown: {
+            account: string;
+            total_amps: number;
+        }[] | null;
+    }>;
+}
+//# sourceMappingURL=trading-amps.reader.d.ts.map

package/dist/read/trading-amps/trading-amps.reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trading-amps.reader.d.ts","sourceRoot":"","sources":["../../../src/read/trading-amps/trading-amps.reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,2BAA2B,EAA0B,MAAM,sBAAsB,CAAC;AAE3F,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C;;;;OAIG;IACG,UAAU,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,2BAA2B;;;;;;;;CAcxF"}

package/dist/read/trading-amps/trading-amps.reader.js

@@ -0,0 +1,23 @@
+import { BaseReader } from "../base-reader";
+import { OwnerTradingAmpsSchema } from "./trading-amps.types";
+export class TradingAmpsReader extends BaseReader {
+    /**
+     * Get aggregated trading Hz (Amps) for an owner across all their active subaccounts
+     * @param ownerAddr The owner address to get trading Hz for
+     * @returns The aggregated trading Hz with per-subaccount breakdown
+     */
+    async getByOwner({ ownerAddr, season, days, fetchOptions }) {
+        const queryParams = new URLSearchParams({ owner: ownerAddr });
+        if (season)
+            queryParams.set("season", season);
+        if (days)
+            queryParams.set("days", days.toString());
+        const response = await this.getRequest({
+            schema: OwnerTradingAmpsSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/points/trading/amps`,
+            queryParams,
+            options: fetchOptions,
+        });
+        return response.data;
+    }
+}

package/dist/read/trading-amps/trading-amps.types.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod/v4";
+import { BaseRequestArgs } from "../base-reader";
+export interface OwnerTradingAmpsRequestArgs extends BaseRequestArgs {
+    /** The owner address to get aggregated trading Hz (Amps) for */
+    ownerAddr: string;
+    /** Optional season name to filter by (e.g. "season1"). Omit to aggregate across all seasons. */
+    season?: string;
+    /** Number of days to look back. 1 = today only, 7 = last week, etc. Omit for lifetime totals. */
+    days?: number;
+}
+export declare const SubaccountAmpsSchema: z.ZodObject<{
+    account: z.ZodString;
+    total_amps: z.ZodNumber;
+}, z.core.$strip>;
+export declare const OwnerTradingAmpsSchema: z.ZodObject<{
+    owner: z.ZodString;
+    total_amps: z.ZodNumber;
+    breakdown: z.ZodNullable<z.ZodArray<z.ZodObject<{
+        account: z.ZodString;
+        total_amps: z.ZodNumber;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type SubaccountAmps = z.infer<typeof SubaccountAmpsSchema>;
+export type OwnerTradingAmps = z.infer<typeof OwnerTradingAmpsSchema>;
+//# sourceMappingURL=trading-amps.types.d.ts.map