@pymthouse/builder-sdk 0.0.8 → 0.3.0

package/dist/index.d.ts

@@ -1,8 +1,22 @@
-import { U as UsageByUserRow, a as UsageForExternalUser, b as UsageApiResponse, c as UsageByPipelineModelRow, O as OidcDiscoveryDocument, F as FetchLike } from './types-W9PJAspR.js';
-export { A as AppUserRecord, C as ClientCredentialsTokenResponse, D as DeviceApprovalInput, G as GetDiscoveryOptions, M as MintUserAccessTokenInput, d as MintUserAccessTokenResponse, e as MintUserSignerSessionTokenInput, P as ParsedDeviceApprovalRedirect, f as PmtHouseClientOptions, T as TokenExchangeResponse, g as UpsertAppUserInput, h as UsageQueryInput, i as UsageTotals } from './types-W9PJAspR.js';
-export { P as PmtHouseClient, b as buildDeviceCodeResource, c as createPmtHouseClientFromEnv, g as getPymthouseBaseUrl, n as normalizeUserCode } from './env-4YmzarGJ.js';
+export { NETWORK_USD_PER_MICRO, applyRetailRateToNetworkMicros, defaultRetailRateUsd, markupPercentToRetailRateUsd, parseMarkupPercentInput, parseRetailRateUsd, retailRateUsdPerMillion, retailRateUsdToMarkupPercent } from './plan-pricing.js';
+export { i as ingestSignedTicket, a as ingestSignedTicketsBatch, s as signerSnapshotToIngestPayload } from './ingest-DoKJTWU9.js';
+import { r as UsageByUserRow, s as UsageForExternalUser, e as UsageApiResponse, n as MeScopeUsagePayload, t as UsageByPipelineModelRow, u as UsageByPipelineModelFiatRow, O as OidcDiscoveryDocument, F as FetchLike, v as AppManifestResponse } from './types-_R1AwEZp.js';
+export { w as AllowancePolicy, x as AppManifestCapability, A as AppUserRecord, q as ApproveDeviceLoginInput, B as BillingProduct, y as BillingSyncState, z as BillingSyncStatus, E as CapabilityPriceRule, C as ClientCredentialsTokenResponse, D as DeviceApprovalInput, o as GetAppManifestResult, G as GetDiscoveryOptions, l as GrantSource, L as ListBillingProductsResult, p as MintSignerSessionForExternalUserInput, M as MintUserAccessTokenInput, b as MintUserAccessTokenResponse, c as MintUserSignerSessionTokenInput, a as ParsedDeviceApprovalRedirect, h as PlanSyncResult, P as PmtHouseClientOptions, S as SignedTicketIngestInput, f as SignedTicketIngestResult, H as SignerRoutingConfig, g as SignerRoutingResponse, T as TokenExchangeResponse, U as UpsertAppUserInput, i as UsageBalanceResponse, I as UsageDailyPipelineRow, d as UsageQueryInput, J as UsageTotals, k as UserAllowanceGrantInput, j as UserAllowancesResponse, K as UserCreditGrantInput, N as UserCreditsResponse, m as UserSubscriptionResponse } from './types-_R1AwEZp.js';
+export { P as PmtHouseClient, b as buildDeviceCodeResource, n as normalizeUserCode } from './client-BHfjDvIe.js';
+export { PYMTHOUSE_NOT_CONFIGURED_MESSAGE, getBuilderApiV1BaseFromIssuerUrl, getPymthouseIssuerOrigin, getPymthouseIssuerUrlFromEnv, getPymthousePublicClientIdFromEnv, isPymthouseConfigured, readPymthouseEnv } from './config.js';
 import { AuthorizationServer } from 'oauth4webapi';
+export { PYMTHOUSE_SIGNER_SESSION_TTL_MS, SIGNER_SESSION_EXPIRES_IN_SEC, SIGNER_SESSION_TTL_MS, SIGN_JOB_SCOPE, SignerSessionToken, computePymthouseExpiry, computeSignerSessionExpiry, decodeJwtExp, isLikelyOidcJwt, isOpaqueSignerSessionToken, parseSignerSessionExchange } from './tokens.js';
 
+/** ISO bounds for the current calendar month in UTC (billing-friendly window). */
+declare function getUtcCalendarMonthIsoBounds(now?: Date): {
+    startDate: string;
+    endDate: string;
+};
+/**
+ * Parse a single date query value. Accepts ISO strings understood by `Date.parse`.
+ * Returns `null` when missing, empty, or invalid.
+ */
+declare function parseUsageDateParam(raw: string | null): string | null;
 /**
  * Sum all `byUser` buckets whose `externalUserId` matches the provider user.
  *
@@ -16,9 +30,28 @@ declare function aggregateUsageByExternalUserId(byUser: UsageByUserRow[] | undef
 declare function summarizeUsageForExternalUser(usage: UsageApiResponse, externalUserId: string): UsageForExternalUser;
 /**
  * Returns `byPipelineModel` rows from a Usage API response, sorted by `pipeline` then `modelId`.
- * Use with `getUsage({ groupBy: "pipeline_model", ... })`.
  */
 declare function listUsageByPipelineModel(usage: UsageApiResponse): UsageByPipelineModelRow[];
+/** Map `externalUserId` to internal `endUserId` values for follow-up pipeline_model queries. */
+declare function getEndUserIdsForExternalUser(usage: UsageApiResponse, externalUserId: string): string[];
+/** @deprecated Use {@link getEndUserIdsForExternalUser}. */
+declare const getUsageRecordUserIdsForExternalUser: typeof getEndUserIdsForExternalUser;
+interface UsageFiatSummary {
+    externalUserId: string;
+    requestCount: number;
+    currency: string;
+    networkFeeUsdMicros: string;
+    ownerChargeUsdMicros: string;
+    endUserBillableUsdMicros: string;
+}
+/** Sum fiat usage fields across duplicate `byUser` buckets for one external user. */
+declare function summarizeUsageFiatForExternalUser(usageByUser: UsageApiResponse, externalUserId: string): UsageFiatSummary;
+/** Merge and sort pipeline/model rows from multiple Usage API responses. */
+declare function mergeUsageByPipelineModel(usagePipelineModels: UsageApiResponse | UsageApiResponse[] | undefined): UsageByPipelineModelFiatRow[];
+/** Build the session-scoped `scope=me` usage payload for integrator BFFs. */
+declare function buildMeScopeUsagePayload(usageByUser: UsageApiResponse, externalUserId: string, usagePipelineModel?: UsageApiResponse | UsageApiResponse[], usageDaily?: UsageApiResponse): MeScopeUsagePayload;
+/** Default cap for parallel pipeline_model fetches per external user (matches NaaP BFF). */
+declare const DEFAULT_MAX_END_USER_IDS = 25;
 
 declare class PmtHouseError extends Error {
     readonly status: number;
@@ -44,4 +77,7 @@ declare function loadAuthorizationServer(issuerUrl: string, fetchImpl: FetchLike
 declare function fetchDiscoveryDocument(issuerUrl: string, fetchImpl: FetchLike, options?: LoadAuthorizationServerOptions): Promise<OidcDiscoveryDocument>;
 declare function clearDiscoveryCache(issuerUrl?: string): void;
 
-export { FetchLike, type LoadAuthorizationServerOptions, OidcDiscoveryDocument, PmtHouseError, UsageApiResponse, UsageByPipelineModelRow, UsageByUserRow, UsageForExternalUser, aggregateUsageByExternalUserId, authorizationServerToOidcDocument, clearDiscoveryCache, fetchDiscoveryDocument, listUsageByPipelineModel, loadAuthorizationServer, summarizeUsageForExternalUser, toPmtHouseError };
+declare function parseAppManifestResponse(json: unknown): AppManifestResponse;
+declare function computeManifestRevision(data: Pick<AppManifestResponse, "capabilities" | "excludedCapabilities" | "manifestVersion"> | null): string;
+
+export { AppManifestResponse, DEFAULT_MAX_END_USER_IDS, FetchLike, type LoadAuthorizationServerOptions, MeScopeUsagePayload, OidcDiscoveryDocument, PmtHouseError, UsageApiResponse, UsageByPipelineModelFiatRow, UsageByPipelineModelRow, UsageByUserRow, UsageForExternalUser, aggregateUsageByExternalUserId, authorizationServerToOidcDocument, buildMeScopeUsagePayload, clearDiscoveryCache, computeManifestRevision, fetchDiscoveryDocument, getEndUserIdsForExternalUser, getUsageRecordUserIdsForExternalUser, getUtcCalendarMonthIsoBounds, listUsageByPipelineModel, loadAuthorizationServer, mergeUsageByPipelineModel, parseAppManifestResponse, parseUsageDateParam, summarizeUsageFiatForExternalUser, summarizeUsageForExternalUser, toPmtHouseError };