@slkiser/opencode-quota 4.0.0 → 4.1.0

package/dist/lib/quota-providers.d.ts

@@ -1,4 +1,5 @@
-export declare const QUOTA_PROVIDER_REMOTE_FORMATS: readonly ["accounting-v1", "openrouter-key-v1"];
+import type { AccountingResultType } from "./entries.js";
+export declare const QUOTA_PROVIDER_REMOTE_FORMATS: readonly ["quota-v1", "openrouter-key-v1", "json-v1"];
 export declare const QUOTA_PROVIDER_MODES: readonly ["remote-api", "local-estimate"];
 export declare const QUOTA_PROVIDER_WINDOW_TYPES: readonly ["utc-day", "rolling"];
 export declare const QUOTA_PROVIDERS_AGGREGATE_ID = "quota-providers";
@@ -22,6 +23,68 @@ export declare function selectEligibleQuotaProviderDefinitions(params: {
 export type QuotaProviderRemoteFormat = (typeof QUOTA_PROVIDER_REMOTE_FORMATS)[number];
 export type QuotaProviderMode = (typeof QUOTA_PROVIDER_MODES)[number];
 export type QuotaProviderWindowType = (typeof QUOTA_PROVIDER_WINDOW_TYPES)[number];
+export type JsonV1Path = string[];
+export type JsonV1NumberSource = {
+    path: JsonV1Path;
+    divideBy?: 100 | 1_000 | 1_000_000;
+} | {
+    literal: number;
+};
+export type JsonV1TextSource = {
+    path: JsonV1Path;
+} | {
+    literal: string;
+};
+export type JsonV1TimestampEncoding = "iso-8601" | "unix-seconds" | "unix-milliseconds";
+export type JsonV1TimestampSource = {
+    path: JsonV1Path;
+    encoding: JsonV1TimestampEncoding;
+} | {
+    literal: string | number;
+    encoding: JsonV1TimestampEncoding;
+};
+export type JsonV1Metric = {
+    type: "percentage";
+    percentage: JsonV1NumberSource;
+    meaning: "remaining" | "used";
+} | {
+    type: "used-limit";
+    used: JsonV1NumberSource;
+    limit: JsonV1NumberSource;
+} | {
+    type: "remaining-limit";
+    remaining: JsonV1NumberSource;
+    limit: JsonV1NumberSource;
+} | {
+    type: "spend-budget";
+    spend: JsonV1NumberSource;
+    budget: JsonV1NumberSource;
+} | {
+    type: "remaining-budget";
+    remaining: JsonV1NumberSource;
+    budget: JsonV1NumberSource;
+} | {
+    type: "value";
+    valueType: "used" | "limit" | "remaining" | "balance" | "spend" | "budget";
+    value: JsonV1NumberSource;
+} | {
+    type: "status";
+    value: JsonV1TextSource;
+};
+export interface JsonV1Mapping {
+    resultType: AccountingResultType;
+    name: string;
+    label?: string;
+    unit?: string;
+    unitPosition?: "prefix" | "suffix";
+    resetTime?: JsonV1TimestampSource;
+    observedTime?: JsonV1TimestampSource;
+    metric: JsonV1Metric;
+}
+export interface JsonV1Adapter {
+    rowsPath?: JsonV1Path;
+    mappings: JsonV1Mapping[];
+}
 interface QuotaProviderDefinitionBase {
     id: string;
     /** Effective OpenCode provider id. Input omits this when it is the same as id. */
@@ -32,13 +95,19 @@ interface QuotaProviderDefinitionBase {
     /** Exact OpenCode model ids, without a provider prefix. Omission covers the provider. */
     modelIds?: string[];
 }
-export interface RemoteApiQuotaProviderDefinition extends QuotaProviderDefinitionBase {
+interface RemoteApiQuotaProviderDefinitionBase extends QuotaProviderDefinitionBase {
     mode: "remote-api";
     /** Canonical absolute HTTPS URL, or loopback HTTP URL. */
     url: string;
-    format: QuotaProviderRemoteFormat;
     apiKeyEnv?: string;
 }
+export type RemoteApiQuotaProviderDefinition = (RemoteApiQuotaProviderDefinitionBase & {
+    format: "quota-v1" | "openrouter-key-v1";
+    adapter?: never;
+}) | (RemoteApiQuotaProviderDefinitionBase & {
+    format: "json-v1";
+    adapter: JsonV1Adapter;
+});
 export interface LocalEstimateWindow {
     id: string;
     label: string;
@@ -69,6 +138,18 @@ export type QuotaProvidersValidationResult = {
     value?: undefined;
     issues: QuotaProviderValidationIssue[];
 };
+export declare const JSON_V1_MAX_MAPPINGS = 16;
+export declare const JSON_V1_MAX_ADAPTER_DEPTH = 8;
+export declare const JSON_V1_MAX_ADAPTER_OBJECTS = 128;
+export declare const JSON_V1_MAX_ADAPTER_PROPERTIES = 384;
+export declare const JSON_V1_MAX_ADAPTER_ARRAY_ELEMENTS = 640;
+export declare const JSON_V1_MAX_PATH_SEGMENTS = 8;
+export declare const JSON_V1_MAX_PATH_SEGMENT_CODE_POINTS = 64;
+export declare const JSON_V1_MAX_STATIC_NAME_CODE_POINTS = 80;
+export declare const JSON_V1_MAX_STATIC_UNIT_CODE_POINTS = 32;
+export declare const JSON_V1_MAX_DISPLAY_CODE_POINTS = 160;
+export declare const JSON_V1_MAX_NUMBER_MAGNITUDE = 1000000000000000;
+export declare function normalizeJsonV1Timestamp(value: unknown, encoding: JsonV1TimestampEncoding): string | null;
 /** Validate and normalize the complete global-only quotaProviders array atomically. */
 export declare function validateQuotaProviders(value: unknown): QuotaProvidersValidationResult;
 export declare function cloneQuotaProviders(definitions: readonly QuotaProviderDefinition[]): QuotaProviderDefinition[];

package/dist/lib/quota-providers.d.ts.map

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