@aephia/atlas-kit 0.0.0

package/dist/loyalty/index.d.ts

@@ -0,0 +1,195 @@
+import { type Address, type DiscoveryRequest, type EntityRef, type ReadOptions, type SageContext } from '../client/index.js';
+import { type LoyaltyAtlasBankAccountData, type LoyaltyContributionAccountData, type LoyaltyEpochAccountData } from '../internal/c4/loyalty.js';
+/** Options accepted by targeted loyalty reverse discovery.
+ * @example
+ * ```ts
+ * const options: LoyaltyDiscoveryOptions = { commitment: 'confirmed' };
+ * ```
+ */
+export type LoyaltyDiscoveryOptions = Omit<DiscoveryRequest, 'filters' | 'strategy'>;
+/** Immutable faction loyalty epoch with exact LP/ATLAS values.
+ * @example
+ * ```ts
+ * declare const epoch: LoyaltyEpochSnapshot;
+ * console.log(epoch.faction.address, epoch.totalLpRaw);
+ * ```
+ */
+export interface LoyaltyEpochSnapshot extends Omit<LoyaltyEpochAccountData, 'game' | 'factionId'> {
+    readonly kind: 'loyaltyEpoch';
+    readonly address: Address;
+    readonly game: EntityRef<'game'>;
+    readonly factionId: number;
+    readonly faction: EntityRef<'faction'>;
+    readonly rewardConfig: EntityRef<'atlasRewardConfig'>;
+    toJSON(): unknown;
+}
+/** Immutable Profile contribution for one faction epoch.
+ * @example
+ * ```ts
+ * declare const contribution: LoyaltyContributionSnapshot;
+ * console.log(contribution.profile.address, contribution.lpRaw);
+ * ```
+ */
+export interface LoyaltyContributionSnapshot extends Omit<LoyaltyContributionAccountData, 'game' | 'profile' | 'factionId' | 'settledAtUnixSeconds'> {
+    readonly kind: 'loyaltyContribution';
+    readonly address: Address;
+    readonly game: EntityRef<'game'>;
+    readonly profile: EntityRef<'profile'>;
+    readonly factionId: number;
+    readonly faction: EntityRef<'faction'>;
+    readonly epoch: EntityRef<'loyaltyEpoch'>;
+    readonly settledAtUnixSeconds: bigint | undefined;
+    toJSON(): unknown;
+}
+/** Immutable accumulated ATLAS bank for one Profile and faction.
+ * @example
+ * ```ts
+ * declare const bank: LoyaltyAtlasBankSnapshot;
+ * console.log(bank.claimableAtlasRaw, bank.expiresAtUnixSeconds);
+ * ```
+ */
+export interface LoyaltyAtlasBankSnapshot extends Omit<LoyaltyAtlasBankAccountData, 'game' | 'profile' | 'factionId'> {
+    readonly kind: 'loyaltyAtlasBank';
+    readonly address: Address;
+    readonly game: EntityRef<'game'>;
+    readonly profile: EntityRef<'profile'>;
+    readonly factionId: number;
+    readonly faction: EntityRef<'faction'>;
+    toJSON(): unknown;
+}
+/** Time-projected lifecycle of one loyalty epoch.
+ * @example
+ * ```ts
+ * const state: LoyaltyEpochState = { kind: 'scheduled' };
+ * ```
+ */
+export type LoyaltyEpochState = {
+    readonly kind: 'scheduled';
+} | {
+    readonly kind: 'open';
+    readonly remainingSeconds: bigint;
+} | {
+    readonly kind: 'settling';
+    readonly remainingSeconds: bigint;
+} | {
+    readonly kind: 'expired';
+} | {
+    readonly kind: 'swept';
+};
+/** Settlement state of one loyalty contribution.
+ * @example
+ * ```ts
+ * const state: LoyaltyContributionState = { kind: 'unsettled' };
+ * ```
+ */
+export type LoyaltyContributionState = {
+    readonly kind: 'unsettled';
+} | {
+    readonly kind: 'settled';
+    readonly settledAtUnixSeconds: bigint;
+} | {
+    readonly kind: 'expired';
+};
+/** Claimability state of one loyalty ATLAS bank.
+ * @example
+ * ```ts
+ * const state: LoyaltyAtlasBankState = { kind: 'empty' };
+ * ```
+ */
+export type LoyaltyAtlasBankState = {
+    readonly kind: 'empty';
+} | {
+    readonly kind: 'claimable';
+    readonly claimableAtlasRaw: bigint;
+} | {
+    readonly kind: 'expired';
+    readonly claimableAtlasRaw: bigint;
+};
+/** Derives and reads one required faction loyalty epoch.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * const epoch = await getLoyaltyEpoch(ctx, 1, 20_665n);
+ * ```
+ */
+export declare function getLoyaltyEpoch(context: SageContext, factionId: number, epochIndex: bigint, options?: ReadOptions): Promise<LoyaltyEpochSnapshot>;
+/** Derives and reads one required Profile contribution.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const profile: Address;
+ * const contribution = await getLoyaltyContribution(ctx, profile, 1, 20_668n);
+ * ```
+ */
+export declare function getLoyaltyContribution(context: SageContext, profile: Address, factionId: number, epochIndex: bigint, options?: ReadOptions): Promise<LoyaltyContributionSnapshot>;
+/** Derives and reads an optional Profile loyalty ATLAS bank.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const profile: Address;
+ * const bank = await maybeGetLoyaltyAtlasBank(ctx, profile, 3);
+ * ```
+ */
+export declare function maybeGetLoyaltyAtlasBank(context: SageContext, profile: Address, factionId: number, options?: ReadOptions): Promise<LoyaltyAtlasBankSnapshot | undefined>;
+/** Derives and reads a required Profile loyalty ATLAS bank.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const profile: Address;
+ * const bank = await getLoyaltyAtlasBank(ctx, profile, 3);
+ * ```
+ */
+export declare function getLoyaltyAtlasBank(context: SageContext, profile: Address, factionId: number, options?: ReadOptions): Promise<LoyaltyAtlasBankSnapshot>;
+/** Discovers validated loyalty epochs for one faction.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * const epochs = await getLoyaltyEpochsByFaction(ctx, 1);
+ * ```
+ */
+export declare function getLoyaltyEpochsByFaction(context: SageContext, factionId: number, options?: LoyaltyDiscoveryOptions): Promise<readonly LoyaltyEpochSnapshot[]>;
+/** Discovers validated loyalty contributions for one Profile.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const profile: Address;
+ * const contributions = await getLoyaltyContributionsByProfile(ctx, profile);
+ * ```
+ */
+export declare function getLoyaltyContributionsByProfile(context: SageContext, profile: Address, options?: LoyaltyDiscoveryOptions): Promise<readonly LoyaltyContributionSnapshot[]>;
+/** Discovers validated loyalty ATLAS banks for one Profile.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const profile: Address;
+ * const banks = await getLoyaltyAtlasBanksByProfile(ctx, profile);
+ * ```
+ */
+export declare function getLoyaltyAtlasBanksByProfile(context: SageContext, profile: Address, options?: LoyaltyDiscoveryOptions): Promise<readonly LoyaltyAtlasBankSnapshot[]>;
+/** Projects a loyalty epoch at an explicit Unix timestamp.
+ * @example
+ * ```ts
+ * declare const epoch: LoyaltyEpochSnapshot;
+ * const state = deriveLoyaltyEpochState(epoch, epoch.startsAtUnixSeconds);
+ * ```
+ */
+export declare function deriveLoyaltyEpochState(epoch: Pick<LoyaltyEpochSnapshot, 'status' | 'startsAtUnixSeconds' | 'endsAtUnixSeconds' | 'settlementDeadlineUnixSeconds'>, atUnixSeconds: bigint): LoyaltyEpochState;
+/** Projects settlement or expiry for one contribution and matching epoch.
+ * Unsettled contributions are expired as soon as their epoch is swept.
+ * @example
+ * ```ts
+ * declare const contribution: LoyaltyContributionSnapshot;
+ * declare const epoch: LoyaltyEpochSnapshot;
+ * const state = deriveLoyaltyContributionState(contribution, epoch, 1_700_000_000n);
+ * ```
+ */
+export declare function deriveLoyaltyContributionState(contribution: Pick<LoyaltyContributionSnapshot, 'settled' | 'settledAtUnixSeconds' | 'epoch' | 'factionId' | 'game'>, epoch: Pick<LoyaltyEpochSnapshot, 'address' | 'factionId' | 'game' | 'status' | 'endsAtUnixSeconds' | 'settlementDeadlineUnixSeconds'>, atUnixSeconds: bigint): LoyaltyContributionState;
+/** Projects whether an accumulated ATLAS bank is empty, claimable, or expired.
+ * @example
+ * ```ts
+ * declare const bank: LoyaltyAtlasBankSnapshot;
+ * const state = deriveLoyaltyAtlasBankState(bank, 1_700_000_000n);
+ * ```
+ */
+export declare function deriveLoyaltyAtlasBankState(bank: Pick<LoyaltyAtlasBankSnapshot, 'claimableAtlasRaw' | 'expiresAtUnixSeconds'>, atUnixSeconds: bigint): LoyaltyAtlasBankState;
+//# sourceMappingURL=index.d.ts.map

package/dist/loyalty/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/loyalty/index.ts"],"names":[],"mappings":"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"}

package/dist/loyalty/index.js

@@ -0,0 +1,289 @@
+import { AccountDecodeError, entityRef, } from '../client/index.js';
+import { deriveLoyaltyAtlasBankAddress, deriveLoyaltyContributionAddress, deriveLoyaltyEpochAddress, deriveLoyaltyFactionAddress, deriveLoyaltyRewardConfigAddress, discoverLoyaltyAtlasBanksByProfile, discoverLoyaltyContributionsByProfile, discoverLoyaltyEpochsByFaction, loyaltyAtlasBankAccountDefinition, loyaltyContributionAccountDefinition, loyaltyEpochAccountDefinition, } from '../internal/c4/loyalty.js';
+import { requireGameAddress } from '../internal/game-context.js';
+import { attachJsonSerialization } from '../internal/json.js';
+import { attachReadMeta, readMeta } from '../internal/read-meta.js';
+import { freezeResolvedSnapshot } from '../internal/resolved-snapshot.js';
+const EPOCH_SNAPSHOTS = new WeakMap();
+const CONTRIBUTION_SNAPSHOTS = new WeakMap();
+const BANK_SNAPSHOTS = new WeakMap();
+function metadata(envelope, strategy) {
+    return {
+        commitment: envelope.commitment,
+        slot: envelope.slot,
+        source: envelope.source,
+        strategy,
+    };
+}
+function assertGame(context, type, envelope) {
+    const game = requireGameAddress(context);
+    if (envelope.data.game !== game) {
+        throw new AccountDecodeError(type, envelope.address, new RangeError('The loyalty account belongs to a different Game.'), `Loyalty account ${envelope.address} belongs to Game ${envelope.data.game}, not configured Game ${game}. Verify the loyalty keys and cluster before retrying.`);
+    }
+}
+function memoized(cache, envelope, strategy, create) {
+    let byStrategy = cache.get(envelope);
+    if (byStrategy === undefined) {
+        byStrategy = new Map();
+        cache.set(envelope, byStrategy);
+    }
+    const existing = byStrategy.get(strategy);
+    if (existing !== undefined)
+        return existing;
+    const pending = create();
+    byStrategy.set(strategy, pending);
+    void pending.catch(() => cache.get(envelope)?.delete(strategy));
+    return pending;
+}
+function epochSnapshot(context, envelope, strategy) {
+    assertGame(context, 'loyaltyEpoch', envelope);
+    return memoized(EPOCH_SNAPSHOTS, envelope, strategy, async () => {
+        const data = envelope.data;
+        const [factionAddress, rewardConfigAddress] = await Promise.all([
+            deriveLoyaltyFactionAddress(data.game, data.factionId),
+            deriveLoyaltyRewardConfigAddress(data.game, data.configVersion),
+        ]);
+        return freezeResolvedSnapshot(attachReadMeta(attachJsonSerialization({
+            ...data,
+            address: envelope.address,
+            faction: entityRef('faction', factionAddress),
+            game: entityRef('game', data.game),
+            kind: 'loyaltyEpoch',
+            rewardConfig: entityRef('atlasRewardConfig', rewardConfigAddress),
+        }), metadata(envelope, strategy)));
+    });
+}
+function contributionSnapshot(context, envelope, strategy) {
+    assertGame(context, 'loyaltyContribution', envelope);
+    return memoized(CONTRIBUTION_SNAPSHOTS, envelope, strategy, async () => {
+        const data = envelope.data;
+        const [factionAddress, epochAddress] = await Promise.all([
+            deriveLoyaltyFactionAddress(data.game, data.factionId),
+            deriveLoyaltyEpochAddress(data.game, data.factionId, data.epochIndex),
+        ]);
+        return freezeResolvedSnapshot(attachReadMeta(attachJsonSerialization({
+            ...data,
+            address: envelope.address,
+            epoch: entityRef('loyaltyEpoch', epochAddress),
+            faction: entityRef('faction', factionAddress),
+            game: entityRef('game', data.game),
+            kind: 'loyaltyContribution',
+            profile: entityRef('profile', data.profile),
+            settledAtUnixSeconds: data.settledAtUnixSeconds === 0n
+                ? undefined
+                : data.settledAtUnixSeconds,
+        }), metadata(envelope, strategy)));
+    });
+}
+function bankSnapshot(context, envelope, strategy) {
+    assertGame(context, 'loyaltyAtlasBank', envelope);
+    return memoized(BANK_SNAPSHOTS, envelope, strategy, async () => {
+        const data = envelope.data;
+        const factionAddress = await deriveLoyaltyFactionAddress(data.game, data.factionId);
+        return freezeResolvedSnapshot(attachReadMeta(attachJsonSerialization({
+            ...data,
+            address: envelope.address,
+            faction: entityRef('faction', factionAddress),
+            game: entityRef('game', data.game),
+            kind: 'loyaltyAtlasBank',
+            profile: entityRef('profile', data.profile),
+        }), metadata(envelope, strategy)));
+    });
+}
+function assertEpochKeys(envelope, factionId, epochIndex) {
+    if (envelope.data.factionId !== factionId ||
+        envelope.data.epochIndex !== epochIndex) {
+        throw new AccountDecodeError('loyaltyEpoch', envelope.address, new RangeError('LoyaltyEpoch fields contradicted its PDA seeds.'), `LoyaltyEpoch ${envelope.address} does not match faction ${String(factionId)} and epoch ${String(epochIndex)}. Verify the keys and refresh the account before retrying.`);
+    }
+}
+/** Derives and reads one required faction loyalty epoch.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * const epoch = await getLoyaltyEpoch(ctx, 1, 20_665n);
+ * ```
+ */
+export async function getLoyaltyEpoch(context, factionId, epochIndex, options) {
+    const game = requireGameAddress(context);
+    const address = await deriveLoyaltyEpochAddress(game, factionId, epochIndex);
+    const envelope = await context.data.read(loyaltyEpochAccountDefinition, address, options);
+    assertEpochKeys(envelope, factionId, epochIndex);
+    return epochSnapshot(context, envelope, 'derived');
+}
+/** Derives and reads one required Profile contribution.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const profile: Address;
+ * const contribution = await getLoyaltyContribution(ctx, profile, 1, 20_668n);
+ * ```
+ */
+export async function getLoyaltyContribution(context, profile, factionId, epochIndex, options) {
+    const game = requireGameAddress(context);
+    const address = await deriveLoyaltyContributionAddress(game, profile, factionId, epochIndex);
+    const envelope = await context.data.read(loyaltyContributionAccountDefinition, address, options);
+    if (envelope.data.profile !== profile ||
+        envelope.data.factionId !== factionId ||
+        envelope.data.epochIndex !== epochIndex) {
+        throw new AccountDecodeError('loyaltyContribution', address, new RangeError('LoyaltyContribution fields contradicted its PDA seeds.'), `LoyaltyContribution ${address} does not match the requested Profile, faction, and epoch. Verify all loyalty keys and refresh before retrying.`);
+    }
+    return contributionSnapshot(context, envelope, 'derived');
+}
+async function maybeBankEnvelope(context, profile, factionId, options) {
+    const game = requireGameAddress(context);
+    const address = await deriveLoyaltyAtlasBankAddress(game, profile, factionId);
+    const [envelope] = await context.data.readMany(loyaltyAtlasBankAccountDefinition, [address], options);
+    if (envelope !== undefined &&
+        (envelope.data.profile !== profile || envelope.data.factionId !== factionId)) {
+        throw new AccountDecodeError('loyaltyAtlasBank', address, new RangeError('LoyaltyAtlasBank fields contradicted its PDA seeds.'), `LoyaltyAtlasBank ${address} does not match the requested Profile and faction. Verify both loyalty keys and refresh before retrying.`);
+    }
+    return { address, envelope };
+}
+/** Derives and reads an optional Profile loyalty ATLAS bank.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const profile: Address;
+ * const bank = await maybeGetLoyaltyAtlasBank(ctx, profile, 3);
+ * ```
+ */
+export async function maybeGetLoyaltyAtlasBank(context, profile, factionId, options) {
+    const { envelope } = await maybeBankEnvelope(context, profile, factionId, options);
+    return envelope === undefined
+        ? undefined
+        : bankSnapshot(context, envelope, 'derived');
+}
+/** Derives and reads a required Profile loyalty ATLAS bank.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const profile: Address;
+ * const bank = await getLoyaltyAtlasBank(ctx, profile, 3);
+ * ```
+ */
+export async function getLoyaltyAtlasBank(context, profile, factionId, options) {
+    const game = requireGameAddress(context);
+    const address = await deriveLoyaltyAtlasBankAddress(game, profile, factionId);
+    const envelope = await context.data.read(loyaltyAtlasBankAccountDefinition, address, options);
+    if (envelope.data.profile !== profile ||
+        envelope.data.factionId !== factionId) {
+        throw new AccountDecodeError('loyaltyAtlasBank', address, new RangeError('LoyaltyAtlasBank fields contradicted its PDA seeds.'), `LoyaltyAtlasBank ${address} does not match the requested Profile and faction. Verify both loyalty keys and refresh before retrying.`);
+    }
+    return bankSnapshot(context, envelope, 'derived');
+}
+/** Discovers validated loyalty epochs for one faction.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * const epochs = await getLoyaltyEpochsByFaction(ctx, 1);
+ * ```
+ */
+export async function getLoyaltyEpochsByFaction(context, factionId, options) {
+    const envelopes = await discoverLoyaltyEpochsByFaction(context, factionId, options);
+    const snapshots = await Promise.all(envelopes.map((envelope) => epochSnapshot(context, envelope, 'targeted-program-accounts')));
+    return Object.freeze(attachReadMeta(snapshots, readMeta(envelopes)));
+}
+/** Discovers validated loyalty contributions for one Profile.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const profile: Address;
+ * const contributions = await getLoyaltyContributionsByProfile(ctx, profile);
+ * ```
+ */
+export async function getLoyaltyContributionsByProfile(context, profile, options) {
+    const envelopes = await discoverLoyaltyContributionsByProfile(context, profile, options);
+    const snapshots = await Promise.all(envelopes.map((envelope) => contributionSnapshot(context, envelope, 'targeted-program-accounts')));
+    return Object.freeze(attachReadMeta(snapshots, readMeta(envelopes)));
+}
+/** Discovers validated loyalty ATLAS banks for one Profile.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const profile: Address;
+ * const banks = await getLoyaltyAtlasBanksByProfile(ctx, profile);
+ * ```
+ */
+export async function getLoyaltyAtlasBanksByProfile(context, profile, options) {
+    const envelopes = await discoverLoyaltyAtlasBanksByProfile(context, profile, options);
+    const snapshots = await Promise.all(envelopes.map((envelope) => bankSnapshot(context, envelope, 'targeted-program-accounts')));
+    return Object.freeze(attachReadMeta(snapshots, readMeta(envelopes)));
+}
+/** Projects a loyalty epoch at an explicit Unix timestamp.
+ * @example
+ * ```ts
+ * declare const epoch: LoyaltyEpochSnapshot;
+ * const state = deriveLoyaltyEpochState(epoch, epoch.startsAtUnixSeconds);
+ * ```
+ */
+export function deriveLoyaltyEpochState(epoch, atUnixSeconds) {
+    if (epoch.status === 'swept')
+        return { kind: 'swept' };
+    if (atUnixSeconds < epoch.startsAtUnixSeconds)
+        return { kind: 'scheduled' };
+    if (epoch.status === 'open' && atUnixSeconds < epoch.endsAtUnixSeconds) {
+        return {
+            kind: 'open',
+            remainingSeconds: epoch.endsAtUnixSeconds - atUnixSeconds,
+        };
+    }
+    const deadline = epoch.settlementDeadlineUnixSeconds === 0n
+        ? epoch.endsAtUnixSeconds
+        : epoch.settlementDeadlineUnixSeconds;
+    if (atUnixSeconds < deadline) {
+        return {
+            kind: 'settling',
+            remainingSeconds: deadline - atUnixSeconds,
+        };
+    }
+    return { kind: 'expired' };
+}
+/** Projects settlement or expiry for one contribution and matching epoch.
+ * Unsettled contributions are expired as soon as their epoch is swept.
+ * @example
+ * ```ts
+ * declare const contribution: LoyaltyContributionSnapshot;
+ * declare const epoch: LoyaltyEpochSnapshot;
+ * const state = deriveLoyaltyContributionState(contribution, epoch, 1_700_000_000n);
+ * ```
+ */
+export function deriveLoyaltyContributionState(contribution, epoch, atUnixSeconds) {
+    if (contribution.epoch.address !== epoch.address ||
+        contribution.factionId !== epoch.factionId ||
+        contribution.game.address !== epoch.game.address) {
+        throw new RangeError('LoyaltyContribution and LoyaltyEpoch identities do not match.');
+    }
+    if (contribution.settled) {
+        if (contribution.settledAtUnixSeconds === undefined) {
+            throw new RangeError('A settled contribution is missing its settlement timestamp.');
+        }
+        return {
+            kind: 'settled',
+            settledAtUnixSeconds: contribution.settledAtUnixSeconds,
+        };
+    }
+    if (epoch.status === 'swept')
+        return { kind: 'expired' };
+    const deadline = epoch.settlementDeadlineUnixSeconds === 0n
+        ? epoch.endsAtUnixSeconds
+        : epoch.settlementDeadlineUnixSeconds;
+    return atUnixSeconds >= deadline
+        ? { kind: 'expired' }
+        : { kind: 'unsettled' };
+}
+/** Projects whether an accumulated ATLAS bank is empty, claimable, or expired.
+ * @example
+ * ```ts
+ * declare const bank: LoyaltyAtlasBankSnapshot;
+ * const state = deriveLoyaltyAtlasBankState(bank, 1_700_000_000n);
+ * ```
+ */
+export function deriveLoyaltyAtlasBankState(bank, atUnixSeconds) {
+    if (bank.claimableAtlasRaw === 0n)
+        return { kind: 'empty' };
+    return bank.expiresAtUnixSeconds !== 0n &&
+        atUnixSeconds >= bank.expiresAtUnixSeconds
+        ? { claimableAtlasRaw: bank.claimableAtlasRaw, kind: 'expired' }
+        : { claimableAtlasRaw: bank.claimableAtlasRaw, kind: 'claimable' };
+}
+//# sourceMappingURL=index.js.map

package/dist/loyalty/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/loyalty/index.ts"],"names":[],"mappings":"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"}