bharosa 0.3.3 → 0.5.0

package/dist/analytics-types.d.cts

@@ -0,0 +1,103 @@
+import type { RequestOptions } from "./client-types.cjs";
+export type AnalyticsPeriod = "1y" | "3y" | "5y" | "since_inception";
+export type AnalyticsMetric = {
+    status: "available";
+    value: string;
+    reason: null;
+} | {
+    status: "unavailable";
+    value: null;
+    reason: string;
+};
+export interface PerformanceSelection {
+    asOf: string;
+    periods?: AnalyticsPeriod[];
+}
+export interface AnalyticsEnvelope {
+    methodology_version: "ts-analytics-v1";
+    requested_as_of: string;
+    currency: "INR";
+    source_cutoff: string;
+    source_version: string;
+    warnings: string[];
+}
+export interface PerformancePeriod {
+    period: AnalyticsPeriod;
+    requested_start: string | null;
+    requested_end: string;
+    status: "available" | "unavailable";
+    reason: string | null;
+    total_return_pct: AnalyticsMetric;
+    cagr_pct: AnalyticsMetric;
+}
+export interface AnalyticsFreshnessPolicy {
+    nav_days: number;
+    aum_days: number;
+    ter_days: number;
+    category_min_funds: number;
+    category_min_coverage_pct: number;
+}
+export interface SchemePerformance extends AnalyticsEnvelope {
+    calculation_precision: "decimal_inputs_float64_returns";
+    freshness_policy: AnalyticsFreshnessPolicy;
+    available_history_start: string | null;
+    inception_basis: "verified_first_scheme_nav" | null;
+    scheme_nav_inception_date: string | null;
+    object: "scheme_performance";
+    scheme_id: string;
+    fund_id: string;
+    plan: string;
+    option: string;
+    basis: string;
+    periods: (PerformancePeriod & {
+        start_observation_date: string | null;
+        end_observation_date: string | null;
+        start_nav: string | null;
+        end_nav: string | null;
+        start_lag_days: number | null;
+        end_lag_days: number | null;
+        elapsed_days: number | null;
+        annualization_basis: "observed_nav_dates_365_25";
+    })[];
+}
+export interface CategorySelection {
+    asOf: string;
+    periods?: Exclude<AnalyticsPeriod, "since_inception">[];
+    metrics?: "return"[];
+    plan?: "direct" | "regular";
+    option?: "growth";
+}
+export interface CategoryStatistics extends AnalyticsEnvelope {
+    freshness_policy: AnalyticsFreshnessPolicy;
+    object: "category_statistics";
+    category: string;
+    cohort: {
+        policy: "current_classification_as_of_prices";
+        plan: "direct" | "regular";
+        option: "growth";
+        fund_count: number;
+        selected_scheme_count: number;
+        classification_date: string | null;
+    };
+    metrics: Record<string, AnalyticsMetric & {
+        method: "equal_weighted_arithmetic_mean";
+        return_type: "total_return" | "cagr" | null;
+        observation_date_min: string | null;
+        observation_date_max: string | null;
+        observed_elapsed_days_min: number | null;
+        observed_elapsed_days_max: number | null;
+        start_lag_days_max: number | null;
+        end_lag_days_max: number | null;
+        unit: string;
+        eligible_count: number;
+        valid_count: number;
+        missing_count: number;
+        stale_count: number;
+        invalid_count: number;
+        coverage_pct: string;
+        exclusions: Record<string, number>;
+    }>;
+}
+export interface AnalyticsResource<P, R> {
+    retrieve(id: string, params: P, options?: RequestOptions): Promise<R>;
+}

package/dist/analytics-types.d.ts

@@ -0,0 +1,103 @@
+import type { RequestOptions } from "./client-types.js";
+export type AnalyticsPeriod = "1y" | "3y" | "5y" | "since_inception";
+export type AnalyticsMetric = {
+    status: "available";
+    value: string;
+    reason: null;
+} | {
+    status: "unavailable";
+    value: null;
+    reason: string;
+};
+export interface PerformanceSelection {
+    asOf: string;
+    periods?: AnalyticsPeriod[];
+}
+export interface AnalyticsEnvelope {
+    methodology_version: "ts-analytics-v1";
+    requested_as_of: string;
+    currency: "INR";
+    source_cutoff: string;
+    source_version: string;
+    warnings: string[];
+}
+export interface PerformancePeriod {
+    period: AnalyticsPeriod;
+    requested_start: string | null;
+    requested_end: string;
+    status: "available" | "unavailable";
+    reason: string | null;
+    total_return_pct: AnalyticsMetric;
+    cagr_pct: AnalyticsMetric;
+}
+export interface AnalyticsFreshnessPolicy {
+    nav_days: number;
+    aum_days: number;
+    ter_days: number;
+    category_min_funds: number;
+    category_min_coverage_pct: number;
+}
+export interface SchemePerformance extends AnalyticsEnvelope {
+    calculation_precision: "decimal_inputs_float64_returns";
+    freshness_policy: AnalyticsFreshnessPolicy;
+    available_history_start: string | null;
+    inception_basis: "verified_first_scheme_nav" | null;
+    scheme_nav_inception_date: string | null;
+    object: "scheme_performance";
+    scheme_id: string;
+    fund_id: string;
+    plan: string;
+    option: string;
+    basis: string;
+    periods: (PerformancePeriod & {
+        start_observation_date: string | null;
+        end_observation_date: string | null;
+        start_nav: string | null;
+        end_nav: string | null;
+        start_lag_days: number | null;
+        end_lag_days: number | null;
+        elapsed_days: number | null;
+        annualization_basis: "observed_nav_dates_365_25";
+    })[];
+}
+export interface CategorySelection {
+    asOf: string;
+    periods?: Exclude<AnalyticsPeriod, "since_inception">[];
+    metrics?: "return"[];
+    plan?: "direct" | "regular";
+    option?: "growth";
+}
+export interface CategoryStatistics extends AnalyticsEnvelope {
+    freshness_policy: AnalyticsFreshnessPolicy;
+    object: "category_statistics";
+    category: string;
+    cohort: {
+        policy: "current_classification_as_of_prices";
+        plan: "direct" | "regular";
+        option: "growth";
+        fund_count: number;
+        selected_scheme_count: number;
+        classification_date: string | null;
+    };
+    metrics: Record<string, AnalyticsMetric & {
+        method: "equal_weighted_arithmetic_mean";
+        return_type: "total_return" | "cagr" | null;
+        observation_date_min: string | null;
+        observation_date_max: string | null;
+        observed_elapsed_days_min: number | null;
+        observed_elapsed_days_max: number | null;
+        start_lag_days_max: number | null;
+        end_lag_days_max: number | null;
+        unit: string;
+        eligible_count: number;
+        valid_count: number;
+        missing_count: number;
+        stale_count: number;
+        invalid_count: number;
+        coverage_pct: string;
+        exclusions: Record<string, number>;
+    }>;
+}
+export interface AnalyticsResource<P, R> {
+    retrieve(id: string, params: P, options?: RequestOptions): Promise<R>;
+}

package/dist/client-types.d.cts

@@ -1,3 +1,4 @@
+import type * as A from "./analytics-types.cjs";
 import type { MonthlyMarketClient } from "./monthly-types.cjs";
 import type { MarketDataClient, CurrentHoldingsInput, CurrentHoldingsResult } from "./market-types.cjs";
 export type * from "./market-types.cjs";
@@ -23,7 +24,7 @@ interface BharosaBaseConfig {
     readonly allowLocalhostHttp?: boolean;
     readonly maxResponseBytes?: number;
 }
-export type BharosaConfig = BharosaBaseConfig & ({
+type LegacyBharosaConfig = BharosaBaseConfig & ({
     readonly auth: Auth;
     readonly fetch?: typeof globalThis.fetch;
     readonly transport?: never;
@@ -32,6 +33,17 @@ export type BharosaConfig = BharosaBaseConfig & ({
     readonly auth?: never;
     readonly fetch?: never;
 });
+/** Simple server-side API-key configuration. Account access remains server-authorized. */
+export type BharosaConfig = LegacyBharosaConfig | {
+    readonly apiKey: string;
+    readonly account?: string;
+    readonly baseUrl?: string;
+    readonly allowLocalhostHttp?: boolean;
+    readonly maxResponseBytes?: number;
+    readonly fetch?: typeof globalThis.fetch;
+    readonly auth?: never;
+    readonly transport?: never;
+};
 export interface RequestOptions {
     idempotencyKey?: string;
     signal?: AbortSignal;
@@ -175,7 +187,11 @@ export type FundObjectReferences = Omit<Fields<FundReferences>, "data"> & {
 };
 export interface ClientSurface {
     readonly marketSnapshots: MonthlyMarketClient;
+    readonly fundCategories: {
+        readonly statistics: A.AnalyticsResource<A.CategorySelection, A.CategoryStatistics>;
+    };
     readonly mutualFundSchemes: {
+        readonly performance: A.AnalyticsResource<A.PerformanceSelection, A.SchemePerformance>;
         readonly navs: {
             readonly retrieve: MonthlyMarketClient["schemes"]["nav"];
         };

package/dist/client-types.d.ts

@@ -1,3 +1,4 @@
+import type * as A from "./analytics-types.js";
 import type { MonthlyMarketClient } from "./monthly-types.js";
 import type { MarketDataClient, CurrentHoldingsInput, CurrentHoldingsResult } from "./market-types.js";
 export type * from "./market-types.js";
@@ -23,7 +24,7 @@ interface BharosaBaseConfig {
     readonly allowLocalhostHttp?: boolean;
     readonly maxResponseBytes?: number;
 }
-export type BharosaConfig = BharosaBaseConfig & ({
+type LegacyBharosaConfig = BharosaBaseConfig & ({
     readonly auth: Auth;
     readonly fetch?: typeof globalThis.fetch;
     readonly transport?: never;
@@ -32,6 +33,17 @@ export type BharosaConfig = BharosaBaseConfig & ({
     readonly auth?: never;
     readonly fetch?: never;
 });
+/** Simple server-side API-key configuration. Account access remains server-authorized. */
+export type BharosaConfig = LegacyBharosaConfig | {
+    readonly apiKey: string;
+    readonly account?: string;
+    readonly baseUrl?: string;
+    readonly allowLocalhostHttp?: boolean;
+    readonly maxResponseBytes?: number;
+    readonly fetch?: typeof globalThis.fetch;
+    readonly auth?: never;
+    readonly transport?: never;
+};
 export interface RequestOptions {
     idempotencyKey?: string;
     signal?: AbortSignal;
@@ -175,7 +187,11 @@ export type FundObjectReferences = Omit<Fields<FundReferences>, "data"> & {
 };
 export interface ClientSurface {
     readonly marketSnapshots: MonthlyMarketClient;
+    readonly fundCategories: {
+        readonly statistics: A.AnalyticsResource<A.CategorySelection, A.CategoryStatistics>;
+    };
     readonly mutualFundSchemes: {
+        readonly performance: A.AnalyticsResource<A.PerformanceSelection, A.SchemePerformance>;
         readonly navs: {
             readonly retrieve: MonthlyMarketClient["schemes"]["nav"];
         };

package/dist/index.cjs

@@ -42,12 +42,52 @@ class Bharosa {
     clients;
     investors;
     portfolios;
+    fundCategories;
     mutualFunds;
     mutualFundSchemes;
+    markets;
     marketSnapshots;
     marketData;
     constructor(config) {
+        this.markets = baselineMarkets((0, transport_cjs_1.createTransport)(config, true));
         const call = (0, transport_cjs_1.createTransport)(config);
+        const analyticsQuery = (q, extra = []) => {
+            (0, transport_cjs_1.keys)(q, ["asOf", "periods", ...extra]);
+            checkedDate(q.asOf);
+            (0, transport_cjs_1.check)(q.asOf.endsWith("-01"));
+            if (q.periods !== undefined)
+                (0, transport_cjs_1.check)(Array.isArray(q.periods) &&
+                    q.periods.length > 0 &&
+                    q.periods.length <= 4 &&
+                    new Set(q.periods).size === q.periods.length &&
+                    q.periods.every((p) => ["1y", "3y", "5y", "since_inception"].includes(p)));
+            return {
+                as_of: q.asOf,
+                ...(q.periods === undefined ? {} : { periods: q.periods.join(",") }),
+            };
+        };
+        this.fundCategories = Object.freeze({
+            statistics: Object.freeze({
+                retrieve: (id, q, o) => {
+                    const query = analyticsQuery(q, ["metrics", "plan", "option"]);
+                    if (q.metrics !== undefined)
+                        (0, transport_cjs_1.check)(Array.isArray(q.metrics) &&
+                            q.metrics.length > 0 &&
+                            q.metrics.length <= 3 &&
+                            new Set(q.metrics).size === q.metrics.length &&
+                            q.metrics.every((m) => m === "return"));
+                    (0, transport_cjs_1.check)(!q.periods?.includes("since_inception"));
+                    (0, transport_cjs_1.check)(!(q.metrics && !q.metrics.includes("return") && q.periods));
+                    return call("analytics_category", {
+                        id,
+                        ...query,
+                        ...(q.metrics ? { metrics: q.metrics.join(",") } : {}),
+                        ...(q.plan ? { plan: q.plan } : {}),
+                        ...(q.option ? { option: q.option } : {}),
+                    }, undefined, o);
+                },
+            }),
+        });
         const list = (p) => {
             (0, transport_cjs_1.keys)(p, ["limit", "startingAfter", "client"]);
             return Object.fromEntries(Object.entries(p)
@@ -276,7 +316,10 @@ class Bharosa {
         };
         this.marketSnapshots = {
             schemes: {
-                nav: (id, q, o) => call("monthly_nav", { id, ...monthlyQuery(q) }, undefined, o),
+                nav: (id, q = {}, o) => {
+                    (0, transport_cjs_1.keys)(q, ["asOf"]);
+                    return call("monthly_nav", { id, ...(q.asOf === undefined ? {} : { as_of: q.asOf }) }, undefined, o);
+                },
                 expenseRatio: (id, q, o) => call("monthly_expense", { id, ...monthlyQuery(q) }, undefined, o),
                 valuation: (id, input = {}, o) => {
                     (0, transport_cjs_1.keys)(input, ["units", "asOf", "positionDate", "observedValue"]);
@@ -299,6 +342,9 @@ class Bharosa {
             },
         };
         this.mutualFundSchemes = Object.freeze({
+            performance: Object.freeze({
+                retrieve: (id, q, o) => call("analytics_scheme", { id, ...analyticsQuery(q) }, undefined, o),
+            }),
             navs: Object.freeze({ retrieve: this.marketSnapshots.schemes.nav }),
             expenseRatios: Object.freeze({
                 retrieve: this.marketSnapshots.schemes.expenseRatio,
@@ -367,24 +413,33 @@ class BharosaMarket {
         ]);
         const { apiKey, ...rest } = config;
         const call = (0, transport_cjs_1.createTransport)({ ...rest, account: "me", auth: { type: "account_key", apiKey } }, true);
-        const query = (q, paging = false) => {
-            (0, transport_cjs_1.keys)(q, paging ? ["asOf", "limit", "startingAfter"] : ["asOf"]);
-            return {
-                as_of: q.asOf,
-                ...(q.limit === undefined ? {} : { limit: q.limit }),
-                ...(q.startingAfter === undefined
-                    ? {}
-                    : { starting_after: q.startingAfter }),
-            };
-        };
-        this.schemes = {
-            nav: (id, q, o) => call("monthly_nav", { id, ...query(q) }, undefined, o),
-            expenseRatio: (id, q, o) => call("monthly_expense", { id, ...query(q) }, undefined, o),
-        };
-        this.funds = {
-            portfolio: (id, q, o) => call("monthly_portfolio", { id, ...query(q) }, undefined, o),
-            holdings: (id, q, o) => call("monthly_holdings", { id, ...query(q, true) }, undefined, o),
-        };
+        const resources = baselineMarkets(call);
+        this.schemes = resources.schemes;
+        this.funds = resources.funds;
     }
 }
 exports.BharosaMarket = BharosaMarket;
+function baselineMarkets(call) {
+    const query = (q, paging = false) => {
+        (0, transport_cjs_1.keys)(q, paging ? ["asOf", "limit", "startingAfter"] : ["asOf"]);
+        return {
+            as_of: q.asOf,
+            ...(q.limit === undefined ? {} : { limit: q.limit }),
+            ...(q.startingAfter === undefined
+                ? {}
+                : { starting_after: q.startingAfter }),
+        };
+    };
+    const schemes = {
+        nav: (id, q = {}, o) => {
+            (0, transport_cjs_1.keys)(q, ["asOf"]);
+            return call("monthly_nav", { id, ...(q.asOf === undefined ? {} : { as_of: q.asOf }) }, undefined, o);
+        },
+        expenseRatio: (id, q, o) => call("monthly_expense", { id, ...query(q) }, undefined, o),
+    };
+    const funds = {
+        portfolio: (id, q, o) => call("monthly_portfolio", { id, ...query(q) }, undefined, o),
+        holdings: (id, q, o) => call("monthly_holdings", { id, ...query(q, true) }, undefined, o),
+    };
+    return Object.freeze({ schemes: Object.freeze(schemes), funds: Object.freeze(funds) });
+}

package/dist/index.d.cts

@@ -1,3 +1,4 @@
+export type * from "./analytics-types.cjs";
 import type { MonthlyMarketClient } from "./monthly-types.cjs";
 export type * from "./monthly-types.cjs";
 import type * as T from "./client-types.cjs";
@@ -9,8 +10,10 @@ export declare class Bharosa implements T.ClientSurface {
     readonly clients: T.ClientSurface["clients"];
     readonly investors: T.ClientSurface["investors"];
     readonly portfolios: T.ClientSurface["portfolios"];
+    readonly fundCategories: T.ClientSurface["fundCategories"];
     readonly mutualFunds: T.ClientSurface["mutualFunds"];
     readonly mutualFundSchemes: T.ClientSurface["mutualFundSchemes"];
+    readonly markets: BaselineMarketClient;
     readonly marketSnapshots: MonthlyMarketClient;
     readonly marketData: D.MarketDataClient;
     constructor(config: T.BharosaConfig);
@@ -25,7 +28,16 @@ export interface BharosaMarketConfig {
 }
 /** Server-only registered-app monthly market access. No account or user token. */
 export declare class BharosaMarket {
-    readonly schemes: Pick<MonthlyMarketClient["schemes"], "nav" | "expenseRatio">;
+    readonly schemes: BaselineMarketClient["schemes"];
     readonly funds: MonthlyMarketClient["funds"];
     constructor(config: BharosaMarketConfig);
 }
+export interface BaselineMarketClient {
+    readonly schemes: {
+        nav(id: string, selection?: {
+            asOf?: string;
+        }, options?: T.RequestOptions): ReturnType<MonthlyMarketClient["schemes"]["nav"]>;
+        expenseRatio: MonthlyMarketClient["schemes"]["expenseRatio"];
+    };
+    readonly funds: MonthlyMarketClient["funds"];
+}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export type * from "./analytics-types.js";
 import type { MonthlyMarketClient } from "./monthly-types.js";
 export type * from "./monthly-types.js";
 import type * as T from "./client-types.js";
@@ -9,8 +10,10 @@ export declare class Bharosa implements T.ClientSurface {
     readonly clients: T.ClientSurface["clients"];
     readonly investors: T.ClientSurface["investors"];
     readonly portfolios: T.ClientSurface["portfolios"];
+    readonly fundCategories: T.ClientSurface["fundCategories"];
     readonly mutualFunds: T.ClientSurface["mutualFunds"];
     readonly mutualFundSchemes: T.ClientSurface["mutualFundSchemes"];
+    readonly markets: BaselineMarketClient;
     readonly marketSnapshots: MonthlyMarketClient;
     readonly marketData: D.MarketDataClient;
     constructor(config: T.BharosaConfig);
@@ -25,7 +28,16 @@ export interface BharosaMarketConfig {
 }
 /** Server-only registered-app monthly market access. No account or user token. */
 export declare class BharosaMarket {
-    readonly schemes: Pick<MonthlyMarketClient["schemes"], "nav" | "expenseRatio">;
+    readonly schemes: BaselineMarketClient["schemes"];
     readonly funds: MonthlyMarketClient["funds"];
     constructor(config: BharosaMarketConfig);
 }
+export interface BaselineMarketClient {
+    readonly schemes: {
+        nav(id: string, selection?: {
+            asOf?: string;
+        }, options?: T.RequestOptions): ReturnType<MonthlyMarketClient["schemes"]["nav"]>;
+        expenseRatio: MonthlyMarketClient["schemes"]["expenseRatio"];
+    };
+    readonly funds: MonthlyMarketClient["funds"];
+}

package/dist/monthly-market-data.cjs

@@ -29,12 +29,13 @@ module.exports = {
         {
           "name": "as_of",
           "in": "query",
-          "required": true,
+          "required": false,
           "schema": {
             "type": "string",
             "format": "date",
             "pattern": "^[0-9]{4}-[0-9]{2}-01$"
-          }
+          },
+          "description": "Omit for latest NAV on or before today in Asia/Kolkata. When supplied, must be the first of a month and not in the future. Actual observation date is returned separately."
         }
       ],
       "response": {

package/dist/monthly-types.d.cts

@@ -21,7 +21,7 @@ export interface MonthSelection {
 }
 export interface MonthlyMarketClient {
     schemes: {
-        nav(id: string, query: MonthSelection, options?: RequestOptions): Promise<MarketSnapshot<D.NavObservation>>;
+        nav(id: string, query?: Partial<MonthSelection>, options?: RequestOptions): Promise<MarketSnapshot<D.NavObservation>>;
         expenseRatio(id: string, query: MonthSelection, options?: RequestOptions): Promise<MarketSnapshot<D.ExpenseObservation>>;
         valuation(id: string, input?: D.ValuationInput, options?: RequestOptions): Promise<D.LatestNavValuation>;
     };

package/dist/monthly-types.d.ts

@@ -21,7 +21,7 @@ export interface MonthSelection {
 }
 export interface MonthlyMarketClient {
     schemes: {
-        nav(id: string, query: MonthSelection, options?: RequestOptions): Promise<MarketSnapshot<D.NavObservation>>;
+        nav(id: string, query?: Partial<MonthSelection>, options?: RequestOptions): Promise<MarketSnapshot<D.NavObservation>>;
         expenseRatio(id: string, query: MonthSelection, options?: RequestOptions): Promise<MarketSnapshot<D.ExpenseObservation>>;
         valuation(id: string, input?: D.ValuationInput, options?: RequestOptions): Promise<D.LatestNavValuation>;
     };

package/dist/operation-types.d.cts

@@ -1,9 +1,12 @@
+import type * as A from "./analytics-types.cjs";
 import type * as S from "./monthly-types.cjs";
 import type * as M from "./models.cjs";
 import type * as D from "./market-types.cjs";
 import type { CurrentMixEvidence } from "./client-types.cjs";
 /** Each entry is the decoded response of the corresponding generated operation. */
 export interface OperationResults {
+    analytics_scheme: A.SchemePerformance;
+    analytics_category: A.CategoryStatistics;
     monthly_nav: S.MarketSnapshot<D.NavObservation>;
     monthly_expense: S.MarketSnapshot<D.ExpenseObservation>;
     monthly_portfolio: S.MarketSnapshot<D.FundPortfolio>;

package/dist/operation-types.d.ts

@@ -1,9 +1,12 @@
+import type * as A from "./analytics-types.js";
 import type * as S from "./monthly-types.js";
 import type * as M from "./models.js";
 import type * as D from "./market-types.js";
 import type { CurrentMixEvidence } from "./client-types.js";
 /** Each entry is the decoded response of the corresponding generated operation. */
 export interface OperationResults {
+    analytics_scheme: A.SchemePerformance;
+    analytics_category: A.CategoryStatistics;
     monthly_nav: S.MarketSnapshot<D.NavObservation>;
     monthly_expense: S.MarketSnapshot<D.ExpenseObservation>;
     monthly_portfolio: S.MarketSnapshot<D.FundPortfolio>;

package/dist/response-checks.cjs

@@ -121,9 +121,76 @@ function responseMatches(id, op, data, params, body, account) {
             b("valuation_date") !== undefined &&
             d("valuation_date") !== b("valuation_date")))
         return false;
+    if (id.startsWith("analytics_")) {
+        if (id === "analytics_aum") {
+            if (d("requested_date") !== params.as_of ||
+                (d("observation_date") !== null &&
+                    String(d("observation_date")) > String(params.as_of)))
+                return false;
+            if (d("status") === "available" &&
+                field(d("data"), "basis") === "reported_fund_total" &&
+                field(field(d("data"), "source"), "date") !== d("observation_date"))
+                return false;
+            if (d("status") === "available" &&
+                (field(d("data"), "fund_id") !== params.id ||
+                    field(d("data"), "date") !== d("observation_date") ||
+                    String(d("observation_date")) > String(params.as_of)))
+                return false;
+        }
+        else {
+            if (d("requested_as_of") !== params.as_of)
+                return false;
+            const identity = id === "analytics_scheme"
+                ? "scheme_id"
+                : id === "analytics_portfolio"
+                    ? "portfolio_id"
+                    : "category";
+            if (d(identity) !== params.id)
+                return false;
+            if (id === "analytics_category") {
+                if (d("cohort", "plan") !== (params.plan ?? "direct") ||
+                    d("cohort", "option") !== (params.option ?? "growth"))
+                    return false;
+                const requested = String(params.metrics ?? "return").split(",");
+                const expected = requested.flatMap((m) => m === "return"
+                    ? String(params.periods ?? "1y,3y,5y")
+                        .split(",")
+                        .map((p) => "return_" + p)
+                    : [m]);
+                for (const key of expected) {
+                    const metric = d("metrics", key);
+                    if (!(0, schema_cjs_1.record)(metric))
+                        return false;
+                    const eligible = Number(field(metric, "eligible_count")), valid = Number(field(metric, "valid_count"));
+                    const excluded = [
+                        "missing_count",
+                        "stale_count",
+                        "invalid_count",
+                    ].reduce((n, k) => n + Number(field(metric, k)), 0);
+                    if (eligible !== d("cohort", "fund_count") ||
+                        valid + excluded !== eligible)
+                        return false;
+                    if (field(metric, "status") === "available" &&
+                        (valid < 3 || valid * 100 < eligible * 80))
+                        return false;
+                }
+            }
+            if (id !== "analytics_category") {
+                const expected = String(params.periods ?? "1y,3y,5y").split(",");
+                const got = rows(d("periods"));
+                if (got.length !== expected.length ||
+                    got.some((p, i) => field(p, "period") !== expected[i] ||
+                        field(p, "requested_end") !== params.as_of ||
+                        (id === "analytics_scheme" &&
+                            (later(field(p, "start_observation_date"), field(p, "requested_start")) ||
+                                later(field(p, "end_observation_date"), params.as_of)))))
+                    return false;
+            }
+        }
+    }
     if (id.startsWith("monthly_") && id !== "monthly_valuation") {
         const observation = d("observation_date"), requested = d("requested_date"), data = d("data");
-        if (requested !== params.as_of)
+        if (!(id === "monthly_nav" && params.as_of === undefined) && requested !== params.as_of)
             return false;
         if (d("status") === "available") {
             if (typeof observation !== "string" ||