dgc-core 2.0.4 → 2.0.7

package/dist/giveaways/schemas.d.ts

@@ -1,7 +1,7 @@
 import { GiveawayCategory, GiveawaySelectionMethod } from '../enums/giveaway';
 import { z } from 'zod';
 export declare const entryIdSchema: z.ZodString;
-export declare const draftSchema: z.ZodObject<{
+export declare const draftSchema: z.ZodPipe<z.ZodObject<{
     images: z.ZodDefault<z.ZodArray<z.ZodString>>;
     title: z.ZodString;
     description: z.ZodString;
@@ -37,8 +37,80 @@ export declare const draftSchema: z.ZodObject<{
             message: z.ZodString;
         }, z.core.$strip>;
     }, z.core.$strip>>;
-}, z.core.$strip>;
-export declare const giveawaySchema: z.ZodObject<{
+}, z.core.$strip>, z.ZodTransform<{
+    countries: string[];
+    images: string[];
+    title: string;
+    description: string;
+    image: string;
+    startsAt: string;
+    closesAt: string;
+    rules: string;
+    category: GiveawayCategory;
+    creditAmount: number;
+    claimWindowDays: number;
+    deliveryInformation: string;
+    prizes: {
+        name: string;
+        quantity: 1;
+        value: number;
+        _id?: string | undefined;
+    }[];
+    launch: {
+        enabled: boolean;
+        title: string;
+        message: string;
+    };
+    reminders: {
+        closing: {
+            enabled: boolean;
+            title: string;
+            message: string;
+        };
+        results: {
+            enabled: boolean;
+            title: string;
+            message: string;
+        };
+    };
+}, {
+    images: string[];
+    title: string;
+    description: string;
+    image: string;
+    startsAt: string;
+    closesAt: string;
+    countries: string[];
+    rules: string;
+    category: GiveawayCategory;
+    creditAmount: number;
+    claimWindowDays: number;
+    deliveryInformation: string;
+    prizes: {
+        name: string;
+        quantity: 1;
+        value: number;
+        _id?: string | undefined;
+    }[];
+    launch: {
+        enabled: boolean;
+        title: string;
+        message: string;
+    };
+    reminders: {
+        closing: {
+            enabled: boolean;
+            title: string;
+            message: string;
+        };
+        results: {
+            enabled: boolean;
+            title: string;
+            message: string;
+        };
+    };
+}>>;
+export declare const giveawaySchema: z.ZodPipe<z.ZodObject<{
     description: z.ZodString;
     image: z.ZodString;
     rules: z.ZodString;
@@ -74,14 +146,85 @@ export declare const giveawaySchema: z.ZodObject<{
             message: z.ZodString;
         }, z.core.$strip>;
     }, z.core.$strip>>;
-}, z.core.$strip>;
+}, z.core.$strip>, z.ZodTransform<{
+    countries: string[];
+    description: string;
+    image: string;
+    rules: string;
+    images: string[];
+    title: string;
+    startsAt: string;
+    closesAt: string;
+    category: GiveawayCategory;
+    creditAmount: number;
+    claimWindowDays: number;
+    deliveryInformation: string;
+    prizes: {
+        name: string;
+        quantity: 1;
+        value: number;
+        _id?: string | undefined;
+    }[];
+    launch: {
+        enabled: boolean;
+        title: string;
+        message: string;
+    };
+    reminders: {
+        closing: {
+            enabled: boolean;
+            title: string;
+            message: string;
+        };
+        results: {
+            enabled: boolean;
+            title: string;
+            message: string;
+        };
+    };
+}, {
+    description: string;
+    image: string;
+    rules: string;
+    images: string[];
+    title: string;
+    startsAt: string;
+    closesAt: string;
+    countries: string[];
+    category: GiveawayCategory;
+    creditAmount: number;
+    claimWindowDays: number;
+    deliveryInformation: string;
+    prizes: {
+        name: string;
+        quantity: 1;
+        value: number;
+        _id?: string | undefined;
+    }[];
+    launch: {
+        enabled: boolean;
+        title: string;
+        message: string;
+    };
+    reminders: {
+        closing: {
+            enabled: boolean;
+            title: string;
+            message: string;
+        };
+        results: {
+            enabled: boolean;
+            title: string;
+            message: string;
+        };
+    };
+}>>;
 export declare const entrySchema: z.ZodObject<{
-    country: z.ZodOptional<z.ZodString>;
     rulesAccepted: z.ZodLiteral<true>;
     marketingConsent: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const physicalClaimSchema: z.ZodObject<{
-    fullName: z.ZodString;
+    fullName: z.ZodOptional<z.ZodString>;
     address: z.ZodObject<{
         line1: z.ZodString;
         line2: z.ZodDefault<z.ZodString>;
@@ -109,7 +252,7 @@ export declare const selectionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     reason: z.ZodString;
     revision: z.ZodNumber;
 }, z.core.$strip>], "method">;
-export declare const presetSchema: z.ZodObject<{
+export declare const presetSchema: z.ZodPipe<z.ZodObject<{
     name: z.ZodString;
     title: z.ZodString;
     description: z.ZodString;
@@ -120,4 +263,26 @@ export declare const presetSchema: z.ZodObject<{
     countries: z.ZodArray<z.ZodString>;
     rules: z.ZodString;
     deliveryInformation: z.ZodDefault<z.ZodString>;
-}, z.core.$strip>;
+}, z.core.$strip>, z.ZodTransform<{
+    countries: string[];
+    name: string;
+    title: string;
+    description: string;
+    image: string;
+    images: string[];
+    category: GiveawayCategory;
+    creditAmount: number;
+    rules: string;
+    deliveryInformation: string;
+}, {
+    name: string;
+    title: string;
+    description: string;
+    image: string;
+    images: string[];
+    category: GiveawayCategory;
+    creditAmount: number;
+    countries: string[];
+    rules: string;
+    deliveryInformation: string;
+}>>;

package/dist/giveaways/schemas.js

@@ -67,7 +67,8 @@ exports.draftSchema = zod_1.z
     .refine(v => new Date(v.closesAt) > new Date(v.startsAt), {
     message: 'Closing time must be after start time',
     path: ['closesAt']
-});
+})
+    .transform(v => ({ ...v, countries: v.category === giveaway_1.GiveawayCategory.Credits ? [] : v.countries }));
 exports.giveawaySchema = zod_1.z
     .object({
     ...fields,
@@ -86,14 +87,14 @@ exports.giveawaySchema = zod_1.z
     for (const [name, value] of Object.entries({ launch: v.launch, ...v.reminders }))
         if (value.enabled && (!value.title || !value.message))
             issue([name], 'Add a push title and message');
-});
+})
+    .transform(v => ({ ...v, countries: v.category === giveaway_1.GiveawayCategory.Credits ? [] : v.countries }));
 exports.entrySchema = zod_1.z.object({
-    country: country.optional(),
     rulesAccepted: zod_1.z.literal(true, { error: 'You must agree to the giveaway rules' }),
     marketingConsent: zod_1.z.boolean().default(false)
 });
 exports.physicalClaimSchema = zod_1.z.object({
-    fullName: zod_1.z.string().trim().min(2).max(120),
+    fullName: zod_1.z.string().trim().min(2).max(120).optional(),
     address: zod_1.z.object({
         line1: zod_1.z.string().trim().min(2).max(200),
         line2: zod_1.z.string().trim().max(200).default(''),
@@ -139,4 +140,5 @@ exports.presetSchema = zod_1.z
     .refine(v => v.category !== giveaway_1.GiveawayCategory.Credits || v.creditAmount > 0, {
     message: 'Configure the instant credit reward amount',
     path: ['creditAmount']
-});
+})
+    .transform(v => ({ ...v, countries: v.category === giveaway_1.GiveawayCategory.Credits ? [] : v.countries }));

package/dist/index.d.ts

@@ -20,3 +20,5 @@ export * from './validator';
 export * from './id';
 export * from './http-error';
 export * from './giveaways';
+export * from './constants/revenuecat';
+export * from './revenuecat';

package/dist/index.js

@@ -36,3 +36,5 @@ __exportStar(require("./validator"), exports);
 __exportStar(require("./id"), exports);
 __exportStar(require("./http-error"), exports);
 __exportStar(require("./giveaways"), exports);
+__exportStar(require("./constants/revenuecat"), exports);
+__exportStar(require("./revenuecat"), exports);

package/dist/revenuecat.d.ts

@@ -0,0 +1,16 @@
+import { HttpError } from './http-error';
+import type { GiveawayCreditEligibilityEvidence, RevenueCatClient, RevenueCatEntitlementIds } from './types/revenuecat';
+export type RevenueCatClientOptions = {
+    apiKey: string;
+    projectId: string;
+    timeoutMs?: number;
+    totalTimeoutMs?: number;
+    maxPages?: number;
+};
+/** Deliberately excludes the original HTTP error, which can contain the API key. */
+export declare class RevenueCatLookupError extends HttpError {
+    constructor();
+}
+export declare function createRevenueCatClient(options: RevenueCatClientOptions): RevenueCatClient;
+/** Resolve any eligible entitlement from one customer lookup; never infer Free from API failures. */
+export declare function verifyCreditGiveawayEntitlement(userId: string, client: RevenueCatClient, entitlementIds: RevenueCatEntitlementIds): Promise<GiveawayCreditEligibilityEvidence | null>;

package/dist/revenuecat.js

@@ -0,0 +1,206 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RevenueCatLookupError = void 0;
+exports.createRevenueCatClient = createRevenueCatClient;
+exports.verifyCreditGiveawayEntitlement = verifyCreditGiveawayEntitlement;
+const axios_1 = __importDefault(require("axios"));
+const revenuecat_1 = require("./constants/revenuecat");
+const user_1 = require("./enums/user");
+const http_error_1 = require("./http-error");
+/** Deliberately excludes the original HTTP error, which can contain the API key. */
+class RevenueCatLookupError extends http_error_1.HttpError {
+    constructor() {
+        super('Unable to verify RevenueCat entitlement access. Please try again.', 503);
+        this.name = 'RevenueCatLookupError';
+    }
+}
+exports.RevenueCatLookupError = RevenueCatLookupError;
+function positiveInteger(value, maximum) {
+    return Number.isInteger(value) && value > 0 && value <= maximum;
+}
+function validUserId(value) {
+    return (typeof value === 'string' &&
+        value.length > 0 &&
+        value.length <= 128 &&
+        value.trim() === value &&
+        !/[.#$[\]/]/.test(value) &&
+        !Array.from(value).some(character => {
+            const code = character.charCodeAt(0);
+            return code < 32 || code === 127;
+        }));
+}
+function parsePage(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new RevenueCatLookupError();
+    const page = value;
+    if (!Array.isArray(page.items) ||
+        (page.next_page != null && (typeof page.next_page !== 'string' || !page.next_page)))
+        throw new RevenueCatLookupError();
+    const items = page.items.map((raw) => {
+        if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+            throw new RevenueCatLookupError();
+        const entitlement = raw;
+        if (typeof entitlement.entitlement_id !== 'string' ||
+            !/^entl[a-zA-Z0-9]+$/.test(entitlement.entitlement_id) ||
+            (entitlement.expires_at !== null &&
+                (typeof entitlement.expires_at !== 'number' ||
+                    !Number.isSafeInteger(entitlement.expires_at) ||
+                    entitlement.expires_at < 0)))
+            throw new RevenueCatLookupError();
+        return {
+            entitlementId: entitlement.entitlement_id,
+            expiresAt: entitlement.expires_at
+        };
+    });
+    return { items, nextPage: page.next_page ?? null };
+}
+function retryAfterMs(value) {
+    if (typeof value === 'number')
+        return Number.isFinite(value) && value >= 0 ? value * 1000 : null;
+    if (typeof value !== 'string' || !value.trim())
+        return null;
+    const text = value.trim();
+    if (/^\d+$/.test(text)) {
+        const seconds = Number(text);
+        return Number.isFinite(seconds) ? seconds * 1000 : null;
+    }
+    const date = Date.parse(text);
+    return Number.isFinite(date) ? Math.max(0, date - Date.now()) : null;
+}
+/** Inspect only retry metadata; never retain or log the original transport error. */
+function requestRetryDelay(error, attempt) {
+    if (!error || typeof error !== 'object')
+        return null;
+    const failure = error;
+    const response = failure.response && typeof failure.response === 'object'
+        ? failure.response
+        : undefined;
+    if (response) {
+        if (typeof response.status !== 'number' || ![429, 500, 502, 503, 504].includes(response.status))
+            return null;
+    }
+    else if (typeof failure.code !== 'string' ||
+        ![
+            'ECONNRESET',
+            'ETIMEDOUT',
+            'ECONNABORTED',
+            'EAI_AGAIN',
+            'ENOTFOUND',
+            'ERR_NETWORK',
+            'EPIPE',
+            'ECONNREFUSED'
+        ].includes(failure.code))
+        return null;
+    let headerDelay = null;
+    if (response?.headers && typeof response.headers === 'object') {
+        const headers = response.headers;
+        headerDelay = retryAfterMs(typeof headers.get === 'function'
+            ? headers.get('retry-after')
+            : (headers['retry-after'] ?? headers['Retry-After']));
+    }
+    const body = response?.data && typeof response.data === 'object'
+        ? response.data
+        : undefined;
+    const bodyDelay = typeof body?.backoff_ms === 'number' && Number.isFinite(body.backoff_ms) && body.backoff_ms >= 0
+        ? body.backoff_ms
+        : 0;
+    return Math.max(100 * 2 ** attempt, headerDelay ?? 0, bodyDelay);
+}
+async function requestPage(url, apiKey, timeoutMs, deadline) {
+    for (let attempt = 0; attempt < 3; attempt++) {
+        const remainingMs = deadline - Date.now();
+        if (remainingMs <= 0)
+            throw new RevenueCatLookupError();
+        try {
+            return await axios_1.default.get(url.href, {
+                headers: { Authorization: `Bearer ${apiKey}` },
+                timeout: Math.min(timeoutMs, remainingMs),
+                signal: AbortSignal.timeout(remainingMs),
+                maxRedirects: 0,
+                maxContentLength: 1024 * 1024
+            });
+        }
+        catch (error) {
+            const delay = attempt < 2 ? requestRetryDelay(error, attempt) : null;
+            if (delay === null || delay >= deadline - Date.now())
+                throw new RevenueCatLookupError();
+            await new Promise(resolve => setTimeout(resolve, delay));
+        }
+    }
+    throw new RevenueCatLookupError();
+}
+function createRevenueCatClient(options) {
+    const apiKey = options.apiKey?.trim();
+    const projectId = options.projectId?.trim();
+    const timeoutMs = options.timeoutMs ?? 15000;
+    const totalTimeoutMs = options.totalTimeoutMs ?? 15000;
+    const maxPages = options.maxPages ?? 20;
+    if (!apiKey || /[\r\n]/.test(apiKey))
+        throw new Error('Configure the RevenueCat API key');
+    if (!projectId || projectId.length > 255 || !/^[a-zA-Z0-9_-]+$/.test(projectId))
+        throw new Error('Configure a valid RevenueCat project ID');
+    if (!positiveInteger(timeoutMs, 60000) ||
+        !positiveInteger(totalTimeoutMs, 120000) ||
+        !positiveInteger(maxPages, 100))
+        throw new Error('Configure valid RevenueCat request limits');
+    return {
+        async getActiveEntitlements(userId) {
+            if (!validUserId(userId))
+                throw new http_error_1.HttpError('Invalid DGC user ID', 400);
+            const endpoint = new URL(`${revenuecat_1.REVENUECAT_API_V2}/projects/${encodeURIComponent(projectId)}/customers/${encodeURIComponent(userId)}/active_entitlements`);
+            endpoint.searchParams.set('limit', '100');
+            const deadline = Date.now() + totalTimeoutMs;
+            const visited = new Set();
+            const entitlements = [];
+            let url = endpoint;
+            try {
+                while (url) {
+                    const remainingMs = deadline - Date.now();
+                    if (remainingMs <= 0 ||
+                        visited.size >= maxPages ||
+                        url.origin !== endpoint.origin ||
+                        url.pathname !== endpoint.pathname ||
+                        url.username ||
+                        url.password ||
+                        url.hash ||
+                        visited.has(url.href))
+                        throw new RevenueCatLookupError();
+                    visited.add(url.href);
+                    const response = await requestPage(url, apiKey, timeoutMs, deadline);
+                    const page = parsePage(response.data);
+                    entitlements.push(...page.items);
+                    url = page.nextPage ? new URL(page.nextPage, endpoint) : null;
+                }
+                const now = Date.now();
+                if (now >= deadline)
+                    throw new RevenueCatLookupError();
+                return entitlements.filter(item => item.expiresAt === null || item.expiresAt > now);
+            }
+            catch {
+                // Do not attach request/config/cause or log the customer payload.
+                throw new RevenueCatLookupError();
+            }
+        }
+    };
+}
+/** Resolve any eligible entitlement from one customer lookup; never infer Free from API failures. */
+async function verifyCreditGiveawayEntitlement(userId, client, entitlementIds) {
+    const ids = (0, revenuecat_1.createRevenueCatEntitlementIds)(entitlementIds);
+    const active = await client.getActiveEntitlements(userId);
+    const checkedAt = new Date().toISOString();
+    const now = Date.parse(checkedAt);
+    const tiers = [
+        [user_1.UserCollectorType.Elite, ids.elite],
+        [user_1.UserCollectorType.Collector, ids.collector],
+        [user_1.UserCollectorType.Rookie, ids.rookie]
+    ];
+    for (const [collectorType, entitlementId] of tiers) {
+        const match = active.find(item => item.entitlementId === entitlementId && (item.expiresAt === null || item.expiresAt > now));
+        if (match)
+            return { userId, checkedAt, collectorType, ...match };
+    }
+    return null;
+}

package/dist/types/giveaway.d.ts

@@ -1,6 +1,7 @@
 import type { GiveawayStatus, GiveawayCategory, GiveawaySelectionMethod, GiveawayWinnerStatus, GiveawayNotificationKind, GiveawayNotificationAudience, GiveawayNotificationStatus, GiveawayTicketResult, GiveawayAction, GiveawayNotificationChannel } from '../enums/giveaway';
 import type { FbUser } from './user';
 import type { UserCollectorType } from '../enums/user';
+import type { GiveawayCreditEligibilityEvidence } from './revenuecat';
 /** API identities are strings. MongoDB ObjectIds serialize as 24 lowercase hexadecimal characters. */
 export type GiveawayObjectId = string;
 /** New tickets use DGC- followed by twelve uppercase letters or digits. Existing numeric IDs remain readable. */
@@ -16,6 +17,7 @@ export type GiveawaySelection = {
     reason: string;
     selectedBy: string;
     selectedAt: string;
+    creditEligibility?: GiveawayCreditEligibilityEvidence;
 };
 export type GiveawayPrize = {
     _id: GiveawayObjectId;
@@ -72,10 +74,13 @@ export type GiveawayEntry = {
     userId: string;
     name: string;
     email: string;
-    /** Historical entry addresses are retained; new entries collect delivery only at claim. */
+    /** Product delivery details are recorded only after the winner claims. */
     address?: GiveawayDeliveryAddress;
+    deliveryName?: string;
+    contactNumber?: string;
+    /** Retained only for historical entry records; new entries collect country at claim. */
     country?: string;
-    /** Null only for legacy entries whose exact collector tier was not recorded. */
+    /** Null when the account tier is missing or unsupported; product entries remain eligible. */
     _collectorType: UserCollectorType | null;
     enteredAt: string;
     rulesAcceptedAt: string;
@@ -93,6 +98,7 @@ export type GiveawayWinner = {
     status: GiveawayWinnerStatus;
     userId?: string;
     selection?: GiveawaySelection;
+    creditEligibility?: GiveawayCreditEligibilityEvidence;
     category: GiveawayCategory;
     creditAmount?: number;
     claimDeadline?: string;
@@ -124,6 +130,14 @@ export type GiveawayNotificationJob = {
     /** Stable event key supports replacements without resending a prior event. */
     eventKey?: string;
     audience?: GiveawayNotificationAudience;
+    /** Snapshots keep targeting and expiry stable throughout a broadcast. */
+    category?: GiveawayCategory;
+    expiresAt?: string;
+    dispatchAfter?: string;
+    dispatchGeneration?: number;
+    recipientsQueued?: number;
+    recipientsSkipped?: number;
+    dispatchCompletedAt?: string;
     status: GiveawayNotificationStatus;
     attempts: number;
     error?: string;
@@ -170,6 +184,12 @@ export type GiveawayWinnerRecord = GiveawayWinner & {
 };
 export type GiveawayNotificationRecord = Omit<GiveawayNotificationJob, 'claimToken'> & {
     giveawayTitle: string;
+    /** Queue acceptance counts, not confirmation of device delivery. */
+    deliveryCounts?: {
+        queued: number;
+        skipped: number;
+        pending: number;
+    };
 };
 export type GiveawayOverviewData = {
     days: {
@@ -179,14 +199,20 @@ export type GiveawayOverviewData = {
     liveGiveaways: GiveawaySummary[];
     needsSelection: Giveaway[];
 };
-export type GiveawayUserProfile = Pick<FbUser, 'email' | 'firstName' | 'lastName' | '_collectorType'> & {
+export type GiveawayUserProfile = Pick<FbUser, 'email' | 'firstName' | 'lastName'> & {
     userId: string;
+    _collectorType?: UserCollectorType | null;
 };
 export type GiveawayPhysicalClaim = {
     fullName: string;
     address: GiveawayDeliveryAddress;
     contactNumber: string;
 };
+export type GiveawayPhysicalClaimInput = {
+    fullName?: string;
+    address: Omit<GiveawayDeliveryAddress, 'line2' | 'region'> & Partial<Pick<GiveawayDeliveryAddress, 'line2' | 'region'>>;
+    contactNumber: string;
+};
 export type GiveawayTicket = {
     entry: Pick<GiveawayEntry, '_id' | 'giveawayId' | 'enteredAt' | 'rulesSnapshot'> & {
         tickets: 1;
@@ -197,6 +223,10 @@ export type GiveawayTicket = {
 };
 export type GiveawayClaim = Pick<GiveawayWinner, '_id' | 'giveawayId' | 'entryId' | 'creditAmount' | 'category' | 'status' | 'claimDeadline' | 'claimedAt' | 'claim' | 'courier' | 'tracking' | 'dispatchedAt' | 'creditedAt'> & {
     claimExpired: boolean;
+    /** Product delivery name defaults to the entrant name and may be edited. */
+    defaults?: {
+        fullName: string;
+    };
 };
 export type GiveawayPreset = {
     _id: GiveawayObjectId;
@@ -245,7 +275,6 @@ export type GiveawayTransitionInput = {
     revision: number;
 };
 export type GiveawayEntryInput = {
-    country?: string;
     rulesAccepted: true;
     marketingConsent?: boolean;
 };
@@ -268,6 +297,8 @@ export type GiveawayWinnerPreview = {
 };
 /** Public app response; excludes admin settings, prize values and personal data. */
 export type GiveawayPublic = Pick<Giveaway, '_id' | 'title' | 'description' | 'image' | 'status' | 'startsAt' | 'closesAt' | 'countries' | 'rules' | 'category' | 'creditAmount' | 'deliveryInformation'> & {
+    /** Null permits all authenticated accounts regardless of their stored tier. */
+    eligibleCollectorTypes: UserCollectorType[] | null;
     entryCount: number;
     images: string[];
     prizes: Pick<GiveawayPrize, 'name' | 'quantity'>[];

package/dist/types/index.d.ts

@@ -19,3 +19,5 @@ export * from './user';
 export * from './x-credit';
 export * from './giveaway';
 export * from '../enums/giveaway';
+export * from './revenuecat';
+export * from '../constants/revenuecat';

package/dist/types/index.js

@@ -35,3 +35,5 @@ __exportStar(require("./user"), exports);
 __exportStar(require("./x-credit"), exports);
 __exportStar(require("./giveaway"), exports);
 __exportStar(require("../enums/giveaway"), exports);
+__exportStar(require("./revenuecat"), exports);
+__exportStar(require("../constants/revenuecat"), exports);

package/dist/types/revenuecat.d.ts

@@ -0,0 +1,19 @@
+import type { UserCollectorType } from '../enums/user';
+export type RevenueCatActiveEntitlement = {
+    entitlementId: string;
+    /** RevenueCat uses milliseconds since epoch; null is non-expiring access. */
+    expiresAt: number | null;
+};
+export type RevenueCatEntitlementIds = Readonly<{
+    rookie: string;
+    collector: string;
+    elite: string;
+}>;
+export type RevenueCatClient = {
+    getActiveEntitlements(userId: string): Promise<RevenueCatActiveEntitlement[]>;
+};
+export type GiveawayCreditEligibilityEvidence = RevenueCatActiveEntitlement & {
+    userId: string;
+    checkedAt: string;
+    collectorType: UserCollectorType.Rookie | UserCollectorType.Collector | UserCollectorType.Elite;
+};

package/dist/types/revenuecat.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dgc-core",
-  "version": "2.0.4",
+  "version": "2.0.7",
   "description": "Shared DGC contracts, business rules and server utilities",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",