@pymthouse/builder-sdk 0.0.8 → 0.3.0

package/dist/types-_R1AwEZp.d.cts

@@ -0,0 +1,343 @@
+type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+interface OidcDiscoveryDocument {
+    issuer: string;
+    authorization_endpoint: string;
+    token_endpoint: string;
+    jwks_uri: string;
+    userinfo_endpoint?: string;
+    device_authorization_endpoint?: string;
+}
+interface GetDiscoveryOptions {
+    /**
+     * Bypass the in-memory discovery cache and fetch fresh metadata.
+     */
+    force?: boolean;
+}
+interface PmtHouseClientOptions {
+    issuerUrl: string;
+    publicClientId: string;
+    m2mClientId: string;
+    m2mClientSecret: string;
+    fetch?: FetchLike;
+    /**
+     * Allow HTTP issuer URLs (e.g. local dev). Passed to oauth4webapi as `allowInsecureRequests`.
+     */
+    allowInsecureHttp?: boolean;
+    logger?: {
+        debug?: (message: string, details?: Record<string, unknown>) => void;
+        warn?: (message: string, details?: Record<string, unknown>) => void;
+    };
+}
+interface UpsertAppUserInput {
+    externalUserId: string;
+    email?: string;
+    status?: "active" | "inactive";
+}
+interface AppUserRecord {
+    id: string;
+    clientId: string;
+    externalUserId: string;
+    email: string | null;
+    status: string;
+    role: string;
+    createdAt: string;
+}
+interface MintUserAccessTokenInput {
+    externalUserId: string;
+    scope?: string;
+}
+interface MintUserSignerSessionTokenInput extends MintUserAccessTokenInput {
+    /**
+     * Optional RFC 8707 resource indicator for the signer-session exchange.
+     * Defaults to the configured PymtHouse issuer URL.
+     */
+    resource?: string;
+}
+interface MintUserAccessTokenResponse {
+    access_token: string;
+    refresh_token: string;
+    token_type: "Bearer";
+    expires_in: number;
+    scope: string;
+    subject_type: "app_user";
+    correlation_id?: string;
+}
+interface DeviceApprovalInput {
+    userJwt: string;
+    userCode: string;
+}
+interface TokenExchangeResponse {
+    access_token: string;
+    token_type: "Bearer";
+    expires_in: number;
+    scope: string;
+    issued_token_type: string;
+}
+interface UsageQueryInput {
+    startDate?: string;
+    endDate?: string;
+    groupBy?: "none" | "user" | "pipeline_model" | "daily_pipeline";
+    userId?: string;
+    gatewayRequestId?: string;
+    /** When true, sends `include=retail` for estimated end-user billable amounts. */
+    includeRetail?: boolean;
+}
+interface UsageTotals {
+    requestCount: number;
+    totalFeeWei?: string;
+    currency?: string;
+    networkFeeUsdMicros?: string;
+    ownerChargeUsdMicros?: string;
+    platformFeeUsdMicros?: string;
+    endUserBillableUsdMicros?: string;
+}
+interface UsageByUserRow {
+    endUserId: string;
+    externalUserId: string | null;
+    requestCount: number;
+    feeWei?: string;
+    currency?: string;
+    networkFeeUsdMicros?: string;
+    ownerChargeUsdMicros?: string;
+    endUserBillableUsdMicros?: string;
+    userType?: "system_managed" | "oidc_authorized" | "unknown";
+    identifier?: string;
+}
+/** One bucket from Usage API `groupBy=pipeline_model` (validated pipeline + model). */
+interface UsageByPipelineModelRow {
+    pipeline: string;
+    modelId: string;
+    requestCount: number;
+    currency?: string;
+    networkFeeWei?: string;
+    networkFeeEth?: string;
+    networkFeeUsdMicros: string;
+    ownerChargeUsdMicros?: string;
+    endUserBillableUsdMicros?: string;
+    retailRateUsd?: string;
+}
+/** One UTC day bucket from Usage API `groupBy=daily_pipeline` (requires `userId`). */
+interface UsageDailyPipelineRow {
+    pipeline: string;
+    modelId: string;
+    date: string;
+    requestCount: number;
+    currency?: string;
+    networkFeeUsdMicros: string;
+    ownerChargeUsdMicros?: string;
+    endUserBillableUsdMicros?: string;
+}
+interface UsageApiResponse {
+    clientId: string;
+    source?: "openmeter" | "postgres";
+    period: {
+        start: string | null;
+        end: string | null;
+    };
+    totals: UsageTotals;
+    byUser?: UsageByUserRow[];
+    byPipelineModel?: UsageByPipelineModelRow[];
+    byDailyPipeline?: UsageDailyPipelineRow[];
+}
+type BillingSyncStatus = "not_applicable" | "pending" | "synced" | "error";
+interface BillingSyncState {
+    status: BillingSyncStatus;
+    syncedAt: string | null;
+    errorCode: string | null;
+    errorMessage: string | null;
+    openmeterPlanId?: string | null;
+    openmeterPlanVersion?: number | null;
+}
+interface CapabilityPriceRule {
+    pipeline: string;
+    modelId: string;
+    retailRateUsd: string | null;
+    markupPercent: string | null;
+    effectiveRetailRateUsd: string;
+    featureKey: string;
+}
+interface AllowancePolicy {
+    includedUsdMicros: string | null;
+    billingCycle: string;
+}
+interface BillingProduct {
+    id: string;
+    clientId: string;
+    name: string;
+    type: string;
+    status: string;
+    priceAmount: string;
+    priceCurrency: string;
+    isNetworkDefault: boolean;
+    isStarterDefault: boolean;
+    allowance: AllowancePolicy;
+    defaultRetailRateUsd: string | null;
+    capabilities: CapabilityPriceRule[];
+    sync: BillingSyncState;
+}
+interface SignedTicketIngestInput {
+    requestId: string;
+    externalUserId: string;
+    networkFeeUsdMicros: string;
+    feeWei?: string;
+    pixels?: string;
+    pipeline?: string;
+    modelId?: string;
+    gatewayRequestId?: string;
+    ethUsdPrice?: string;
+    ethUsdRoundId?: string;
+    ethUsdObservedAt?: string;
+}
+interface SignedTicketIngestResult {
+    ingested: boolean;
+    duplicate: boolean;
+    source: "openmeter" | "disabled";
+}
+/** OpenMeter entitlement balance from `GET .../usage/balance`. */
+interface UsageBalanceResponse {
+    externalUserId: string;
+    balanceUsdMicros: string;
+    consumedUsdMicros: string;
+    lifetimeGrantedUsdMicros: string;
+    hasAccess: boolean;
+    remainingUsdMicros?: string;
+}
+/** @deprecated Use {@link UsageBalanceResponse}. */
+type UserCreditsResponse = UsageBalanceResponse;
+/** @deprecated Use {@link UserAllowanceGrantInput}. */
+type UserCreditGrantInput = UserAllowanceGrantInput;
+interface SignerRoutingConfig {
+    signerApiUrl: string;
+    remoteDmzUrl: string | null;
+    jwksUri: string;
+    identityMode: string;
+    meteringMode: "hosted_ingest" | "platform_ingest";
+}
+interface SignerRoutingResponse {
+    clientId: string;
+    routing: SignerRoutingConfig;
+    patterns: {
+        hostedFacade: {
+            description: string;
+            signerApiUrl: string;
+        };
+        platformDirectDmz: {
+            description: string;
+            remoteDmzUrl: string | null;
+            ingestUrl: string;
+        };
+    };
+}
+type GrantSource = "trial" | "manual" | "promo" | "plan_adjustment";
+interface UserAllowanceGrantInput {
+    amountUsdMicros: string;
+    source?: GrantSource;
+    featureKey?: string;
+}
+interface UserAllowancesResponse {
+    externalUserId: string;
+    allowances: {
+        balanceUsdMicros: string;
+        consumedUsdMicros?: string;
+        lifetimeGrantedUsdMicros?: string;
+        hasAccess?: boolean;
+    };
+}
+interface UserSubscriptionResponse {
+    externalUserId: string;
+    subscription: {
+        id: string;
+        status: string;
+        planId: string;
+        planName: string | null;
+        planType: string | null;
+        currentPeriodStart: string | null;
+        currentPeriodEnd: string | null;
+        openmeterSubscriptionId: string | null;
+        stripeCheckoutSessionId: string | null;
+        createdAt: string;
+        cancelledAt: string | null;
+    } | null;
+}
+interface PlanSyncResult {
+    planId: string;
+    ok: boolean;
+    sync: BillingSyncState;
+    openmeterPlanId: string | null;
+}
+interface ListBillingProductsResult {
+    apiVersion: number;
+    products: BillingProduct[];
+}
+/** Aggregated request count and fee for one provider `externalUserId` across duplicate `byUser` buckets. */
+interface UsageForExternalUser {
+    externalUserId: string;
+    requestCount: number;
+    feeWei: string;
+}
+interface ClientCredentialsTokenResponse {
+    access_token: string;
+    token_type: "Bearer";
+    expires_in?: number;
+    scope?: string;
+    [key: string]: unknown;
+}
+interface ParsedDeviceApprovalRedirect {
+    issuer: string;
+    targetLinkUri: string;
+    userCode: string;
+    clientId: string;
+}
+interface AppManifestCapability {
+    pipeline: string;
+    modelId: string;
+}
+interface AppManifestResponse {
+    /** PymtHouse-local resolved set; informational, not a complete integrator allowlist. */
+    capabilities: AppManifestCapability[];
+    /** Authoritative exclusions from the Network Price plan. */
+    excludedCapabilities?: AppManifestCapability[];
+    /** Server-computed revision for cache busting when present. */
+    manifestVersion?: string;
+}
+interface GetAppManifestResult {
+    manifest: AppManifestResponse | null;
+    etag: string | null;
+    notModified: boolean;
+}
+interface UsageByPipelineModelFiatRow {
+    pipeline: string;
+    modelId: string;
+    requestCount: number;
+    currency: string;
+    networkFeeUsdMicros: string;
+    ownerChargeUsdMicros: string;
+    endUserBillableUsdMicros: string;
+}
+interface MeScopeUsagePayload {
+    clientId: string;
+    period: UsageApiResponse["period"];
+    currentUser: {
+        externalUserId: string;
+        requestCount: number;
+        currency: string;
+        networkFeeUsdMicros: string;
+        ownerChargeUsdMicros: string;
+        endUserBillableUsdMicros: string;
+        pipelineModels: UsageByPipelineModelFiatRow[];
+        dailyByPipeline?: UsageDailyPipelineRow[];
+    };
+}
+interface MintSignerSessionForExternalUserInput {
+    externalUserId: string;
+    email?: string;
+    scope?: string;
+}
+interface ApproveDeviceLoginInput {
+    externalUserId: string;
+    userCode: string;
+    email?: string;
+    publicClientId?: string;
+}
+
+export type { AppUserRecord as A, BillingProduct as B, ClientCredentialsTokenResponse as C, DeviceApprovalInput as D, CapabilityPriceRule as E, FetchLike as F, GetDiscoveryOptions as G, SignerRoutingConfig as H, UsageDailyPipelineRow as I, UsageTotals as J, UserCreditGrantInput as K, ListBillingProductsResult as L, MintUserAccessTokenInput as M, UserCreditsResponse as N, OidcDiscoveryDocument as O, PmtHouseClientOptions as P, SignedTicketIngestInput as S, TokenExchangeResponse as T, UpsertAppUserInput as U, ParsedDeviceApprovalRedirect as a, MintUserAccessTokenResponse as b, MintUserSignerSessionTokenInput as c, UsageQueryInput as d, UsageApiResponse as e, SignedTicketIngestResult as f, SignerRoutingResponse as g, PlanSyncResult as h, UsageBalanceResponse as i, UserAllowancesResponse as j, UserAllowanceGrantInput as k, GrantSource as l, UserSubscriptionResponse as m, MeScopeUsagePayload as n, GetAppManifestResult as o, MintSignerSessionForExternalUserInput as p, ApproveDeviceLoginInput as q, UsageByUserRow as r, UsageForExternalUser as s, UsageByPipelineModelRow as t, UsageByPipelineModelFiatRow as u, AppManifestResponse as v, AllowancePolicy as w, AppManifestCapability as x, BillingSyncState as y, BillingSyncStatus as z };

package/dist/types-_R1AwEZp.d.ts

@@ -0,0 +1,343 @@
+type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+interface OidcDiscoveryDocument {
+    issuer: string;
+    authorization_endpoint: string;
+    token_endpoint: string;
+    jwks_uri: string;
+    userinfo_endpoint?: string;
+    device_authorization_endpoint?: string;
+}
+interface GetDiscoveryOptions {
+    /**
+     * Bypass the in-memory discovery cache and fetch fresh metadata.
+     */
+    force?: boolean;
+}
+interface PmtHouseClientOptions {
+    issuerUrl: string;
+    publicClientId: string;
+    m2mClientId: string;
+    m2mClientSecret: string;
+    fetch?: FetchLike;
+    /**
+     * Allow HTTP issuer URLs (e.g. local dev). Passed to oauth4webapi as `allowInsecureRequests`.
+     */
+    allowInsecureHttp?: boolean;
+    logger?: {
+        debug?: (message: string, details?: Record<string, unknown>) => void;
+        warn?: (message: string, details?: Record<string, unknown>) => void;
+    };
+}
+interface UpsertAppUserInput {
+    externalUserId: string;
+    email?: string;
+    status?: "active" | "inactive";
+}
+interface AppUserRecord {
+    id: string;
+    clientId: string;
+    externalUserId: string;
+    email: string | null;
+    status: string;
+    role: string;
+    createdAt: string;
+}
+interface MintUserAccessTokenInput {
+    externalUserId: string;
+    scope?: string;
+}
+interface MintUserSignerSessionTokenInput extends MintUserAccessTokenInput {
+    /**
+     * Optional RFC 8707 resource indicator for the signer-session exchange.
+     * Defaults to the configured PymtHouse issuer URL.
+     */
+    resource?: string;
+}
+interface MintUserAccessTokenResponse {
+    access_token: string;
+    refresh_token: string;
+    token_type: "Bearer";
+    expires_in: number;
+    scope: string;
+    subject_type: "app_user";
+    correlation_id?: string;
+}
+interface DeviceApprovalInput {
+    userJwt: string;
+    userCode: string;
+}
+interface TokenExchangeResponse {
+    access_token: string;
+    token_type: "Bearer";
+    expires_in: number;
+    scope: string;
+    issued_token_type: string;
+}
+interface UsageQueryInput {
+    startDate?: string;
+    endDate?: string;
+    groupBy?: "none" | "user" | "pipeline_model" | "daily_pipeline";
+    userId?: string;
+    gatewayRequestId?: string;
+    /** When true, sends `include=retail` for estimated end-user billable amounts. */
+    includeRetail?: boolean;
+}
+interface UsageTotals {
+    requestCount: number;
+    totalFeeWei?: string;
+    currency?: string;
+    networkFeeUsdMicros?: string;
+    ownerChargeUsdMicros?: string;
+    platformFeeUsdMicros?: string;
+    endUserBillableUsdMicros?: string;
+}
+interface UsageByUserRow {
+    endUserId: string;
+    externalUserId: string | null;
+    requestCount: number;
+    feeWei?: string;
+    currency?: string;
+    networkFeeUsdMicros?: string;
+    ownerChargeUsdMicros?: string;
+    endUserBillableUsdMicros?: string;
+    userType?: "system_managed" | "oidc_authorized" | "unknown";
+    identifier?: string;
+}
+/** One bucket from Usage API `groupBy=pipeline_model` (validated pipeline + model). */
+interface UsageByPipelineModelRow {
+    pipeline: string;
+    modelId: string;
+    requestCount: number;
+    currency?: string;
+    networkFeeWei?: string;
+    networkFeeEth?: string;
+    networkFeeUsdMicros: string;
+    ownerChargeUsdMicros?: string;
+    endUserBillableUsdMicros?: string;
+    retailRateUsd?: string;
+}
+/** One UTC day bucket from Usage API `groupBy=daily_pipeline` (requires `userId`). */
+interface UsageDailyPipelineRow {
+    pipeline: string;
+    modelId: string;
+    date: string;
+    requestCount: number;
+    currency?: string;
+    networkFeeUsdMicros: string;
+    ownerChargeUsdMicros?: string;
+    endUserBillableUsdMicros?: string;
+}
+interface UsageApiResponse {
+    clientId: string;
+    source?: "openmeter" | "postgres";
+    period: {
+        start: string | null;
+        end: string | null;
+    };
+    totals: UsageTotals;
+    byUser?: UsageByUserRow[];
+    byPipelineModel?: UsageByPipelineModelRow[];
+    byDailyPipeline?: UsageDailyPipelineRow[];
+}
+type BillingSyncStatus = "not_applicable" | "pending" | "synced" | "error";
+interface BillingSyncState {
+    status: BillingSyncStatus;
+    syncedAt: string | null;
+    errorCode: string | null;
+    errorMessage: string | null;
+    openmeterPlanId?: string | null;
+    openmeterPlanVersion?: number | null;
+}
+interface CapabilityPriceRule {
+    pipeline: string;
+    modelId: string;
+    retailRateUsd: string | null;
+    markupPercent: string | null;
+    effectiveRetailRateUsd: string;
+    featureKey: string;
+}
+interface AllowancePolicy {
+    includedUsdMicros: string | null;
+    billingCycle: string;
+}
+interface BillingProduct {
+    id: string;
+    clientId: string;
+    name: string;
+    type: string;
+    status: string;
+    priceAmount: string;
+    priceCurrency: string;
+    isNetworkDefault: boolean;
+    isStarterDefault: boolean;
+    allowance: AllowancePolicy;
+    defaultRetailRateUsd: string | null;
+    capabilities: CapabilityPriceRule[];
+    sync: BillingSyncState;
+}
+interface SignedTicketIngestInput {
+    requestId: string;
+    externalUserId: string;
+    networkFeeUsdMicros: string;
+    feeWei?: string;
+    pixels?: string;
+    pipeline?: string;
+    modelId?: string;
+    gatewayRequestId?: string;
+    ethUsdPrice?: string;
+    ethUsdRoundId?: string;
+    ethUsdObservedAt?: string;
+}
+interface SignedTicketIngestResult {
+    ingested: boolean;
+    duplicate: boolean;
+    source: "openmeter" | "disabled";
+}
+/** OpenMeter entitlement balance from `GET .../usage/balance`. */
+interface UsageBalanceResponse {
+    externalUserId: string;
+    balanceUsdMicros: string;
+    consumedUsdMicros: string;
+    lifetimeGrantedUsdMicros: string;
+    hasAccess: boolean;
+    remainingUsdMicros?: string;
+}
+/** @deprecated Use {@link UsageBalanceResponse}. */
+type UserCreditsResponse = UsageBalanceResponse;
+/** @deprecated Use {@link UserAllowanceGrantInput}. */
+type UserCreditGrantInput = UserAllowanceGrantInput;
+interface SignerRoutingConfig {
+    signerApiUrl: string;
+    remoteDmzUrl: string | null;
+    jwksUri: string;
+    identityMode: string;
+    meteringMode: "hosted_ingest" | "platform_ingest";
+}
+interface SignerRoutingResponse {
+    clientId: string;
+    routing: SignerRoutingConfig;
+    patterns: {
+        hostedFacade: {
+            description: string;
+            signerApiUrl: string;
+        };
+        platformDirectDmz: {
+            description: string;
+            remoteDmzUrl: string | null;
+            ingestUrl: string;
+        };
+    };
+}
+type GrantSource = "trial" | "manual" | "promo" | "plan_adjustment";
+interface UserAllowanceGrantInput {
+    amountUsdMicros: string;
+    source?: GrantSource;
+    featureKey?: string;
+}
+interface UserAllowancesResponse {
+    externalUserId: string;
+    allowances: {
+        balanceUsdMicros: string;
+        consumedUsdMicros?: string;
+        lifetimeGrantedUsdMicros?: string;
+        hasAccess?: boolean;
+    };
+}
+interface UserSubscriptionResponse {
+    externalUserId: string;
+    subscription: {
+        id: string;
+        status: string;
+        planId: string;
+        planName: string | null;
+        planType: string | null;
+        currentPeriodStart: string | null;
+        currentPeriodEnd: string | null;
+        openmeterSubscriptionId: string | null;
+        stripeCheckoutSessionId: string | null;
+        createdAt: string;
+        cancelledAt: string | null;
+    } | null;
+}
+interface PlanSyncResult {
+    planId: string;
+    ok: boolean;
+    sync: BillingSyncState;
+    openmeterPlanId: string | null;
+}
+interface ListBillingProductsResult {
+    apiVersion: number;
+    products: BillingProduct[];
+}
+/** Aggregated request count and fee for one provider `externalUserId` across duplicate `byUser` buckets. */
+interface UsageForExternalUser {
+    externalUserId: string;
+    requestCount: number;
+    feeWei: string;
+}
+interface ClientCredentialsTokenResponse {
+    access_token: string;
+    token_type: "Bearer";
+    expires_in?: number;
+    scope?: string;
+    [key: string]: unknown;
+}
+interface ParsedDeviceApprovalRedirect {
+    issuer: string;
+    targetLinkUri: string;
+    userCode: string;
+    clientId: string;
+}
+interface AppManifestCapability {
+    pipeline: string;
+    modelId: string;
+}
+interface AppManifestResponse {
+    /** PymtHouse-local resolved set; informational, not a complete integrator allowlist. */
+    capabilities: AppManifestCapability[];
+    /** Authoritative exclusions from the Network Price plan. */
+    excludedCapabilities?: AppManifestCapability[];
+    /** Server-computed revision for cache busting when present. */
+    manifestVersion?: string;
+}
+interface GetAppManifestResult {
+    manifest: AppManifestResponse | null;
+    etag: string | null;
+    notModified: boolean;
+}
+interface UsageByPipelineModelFiatRow {
+    pipeline: string;
+    modelId: string;
+    requestCount: number;
+    currency: string;
+    networkFeeUsdMicros: string;
+    ownerChargeUsdMicros: string;
+    endUserBillableUsdMicros: string;
+}
+interface MeScopeUsagePayload {
+    clientId: string;
+    period: UsageApiResponse["period"];
+    currentUser: {
+        externalUserId: string;
+        requestCount: number;
+        currency: string;
+        networkFeeUsdMicros: string;
+        ownerChargeUsdMicros: string;
+        endUserBillableUsdMicros: string;
+        pipelineModels: UsageByPipelineModelFiatRow[];
+        dailyByPipeline?: UsageDailyPipelineRow[];
+    };
+}
+interface MintSignerSessionForExternalUserInput {
+    externalUserId: string;
+    email?: string;
+    scope?: string;
+}
+interface ApproveDeviceLoginInput {
+    externalUserId: string;
+    userCode: string;
+    email?: string;
+    publicClientId?: string;
+}
+
+export type { AppUserRecord as A, BillingProduct as B, ClientCredentialsTokenResponse as C, DeviceApprovalInput as D, CapabilityPriceRule as E, FetchLike as F, GetDiscoveryOptions as G, SignerRoutingConfig as H, UsageDailyPipelineRow as I, UsageTotals as J, UserCreditGrantInput as K, ListBillingProductsResult as L, MintUserAccessTokenInput as M, UserCreditsResponse as N, OidcDiscoveryDocument as O, PmtHouseClientOptions as P, SignedTicketIngestInput as S, TokenExchangeResponse as T, UpsertAppUserInput as U, ParsedDeviceApprovalRedirect as a, MintUserAccessTokenResponse as b, MintUserSignerSessionTokenInput as c, UsageQueryInput as d, UsageApiResponse as e, SignedTicketIngestResult as f, SignerRoutingResponse as g, PlanSyncResult as h, UsageBalanceResponse as i, UserAllowancesResponse as j, UserAllowanceGrantInput as k, GrantSource as l, UserSubscriptionResponse as m, MeScopeUsagePayload as n, GetAppManifestResult as o, MintSignerSessionForExternalUserInput as p, ApproveDeviceLoginInput as q, UsageByUserRow as r, UsageForExternalUser as s, UsageByPipelineModelRow as t, UsageByPipelineModelFiatRow as u, AppManifestResponse as v, AllowancePolicy as w, AppManifestCapability as x, BillingSyncState as y, BillingSyncStatus as z };

package/dist/verify.cjs

@@ -25,7 +25,7 @@ var PmtHouseError = class extends Error {
 // src/string-utils.ts
 function stripTrailingSlashes(value) {
   let end = value.length;
-  while (end > 0 && value.charCodeAt(end - 1) === 47) {
+  while (end > 0 && (value.codePointAt(end - 1) ?? 0) === 47) {
     end--;
   }
   return value.slice(0, end);