@shaxpir/duiduidui-models 1.34.0 → 1.35.0

package/dist/models/Billing.d.ts

@@ -4,6 +4,31 @@ import { ShareSync } from '../repo';
 import { Content, ContentBody, ContentId, ContentMeta } from "./Content";
 export type SubscriptionStatus = 'active' | 'trialing' | 'grace_period' | 'expired' | 'inactive';
 export type SubscriptionSource = 'app_store' | 'play_store' | 'stripe' | 'promo' | 'lifetime_free';
+export type TransactionType = 'purchase' | 'renewal' | 'refund' | 'revocation' | 'cancellation' | 'grace_period' | 'expiration' | 'promo_grant' | 'admin_grant' | 'price_change';
+export type TransactionSource = 'app_store' | 'play_store' | 'stripe' | 'promo' | 'admin';
+export interface Transaction {
+    id: string;
+    source: TransactionSource;
+    type: TransactionType;
+    timestamp: CompactDateTime;
+    amount: number | null;
+    currency: string | null;
+    product_id: string | null;
+    app_store_transaction_id: string | null;
+    app_store_original_transaction_id: string | null;
+    play_store_order_id: string | null;
+    play_store_purchase_token: string | null;
+    stripe_invoice_id: string | null;
+    stripe_payment_intent_id: string | null;
+    note: string | null;
+}
+export interface FeatureGrant {
+    source: 'promo' | 'subscription' | 'admin';
+    granted_at: CompactDateTime;
+    expires_at: CompactDateTime | null;
+    code?: string;
+    note?: string;
+}
 export interface BillingPayload {
     subscription_status: SubscriptionStatus;
     subscription_source: SubscriptionSource | null;
@@ -16,6 +41,9 @@ export interface BillingPayload {
     stripe_customer_id: string | null;
     stripe_subscription_id: string | null;
     grant_note: string | null;
+    feature_grants: Record<string, FeatureGrant>;
+    redeemed_codes: string[];
+    transactions: Transaction[];
 }
 export interface BillingBody extends ContentBody {
     meta: ContentMeta;
@@ -30,7 +58,14 @@ export declare class Billing extends Content {
     get subscriptionStatus(): SubscriptionStatus;
     get subscriptionSource(): SubscriptionSource | null;
     get expiresAt(): CompactDateTime | null;
+    get featureGrants(): Record<string, FeatureGrant>;
+    get redeemedCodes(): string[];
+    get transactions(): Transaction[];
     isActive(): boolean;
     isTrialing(): boolean;
     isLifetimeFree(): boolean;
+    /**
+     * Check whether the user has an active (non-expired) grant for the given feature flag.
+     */
+    hasFeature(flag: string): boolean;
 }

package/dist/models/Billing.js

@@ -21,7 +21,10 @@ class Billing extends Content_1.Content {
             play_store_purchase_token: null,
             stripe_customer_id: null,
             stripe_subscription_id: null,
-            grant_note: null
+            grant_note: null,
+            feature_grants: {},
+            redeemed_codes: [],
+            transactions: []
         };
     }
     static create(userId, payload, createdAt) {
@@ -57,6 +60,15 @@ class Billing extends Content_1.Content {
     get expiresAt() {
         return this.payload.expires_at;
     }
+    get featureGrants() {
+        return this.payload.feature_grants ?? {};
+    }
+    get redeemedCodes() {
+        return this.payload.redeemed_codes ?? [];
+    }
+    get transactions() {
+        return this.payload.transactions ?? [];
+    }
     isActive() {
         const status = this.subscriptionStatus;
         return status === 'active' || status === 'trialing' || status === 'grace_period';
@@ -67,5 +79,18 @@ class Billing extends Content_1.Content {
     isLifetimeFree() {
         return this.subscriptionSource === 'lifetime_free';
     }
+    /**
+     * Check whether the user has an active (non-expired) grant for the given feature flag.
+     */
+    hasFeature(flag) {
+        const grant = this.featureGrants[flag];
+        if (!grant)
+            return false;
+        const expiresAt = grant.expires_at;
+        if (!expiresAt)
+            return true;
+        const now = shaxpir_common_1.ClockService.getClock().utc();
+        return shaxpir_common_1.Time.isDateTimeAfter(expiresAt, now);
+    }
 }
 exports.Billing = Billing;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shaxpir/duiduidui-models",
-  "version": "1.34.0",
+  "version": "1.35.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/shaxpir/duiduidui-models"