@slkiser/opencode-quota 2.4.0 → 2.5.0

package/dist/lib/copilot.d.ts

@@ -1,25 +1,57 @@
 /**
- * GitHub Copilot quota fetcher
+ * GitHub Copilot premium request usage fetcher.
  *
- * Strategy (new Copilot API reality):
- *
- * 1) Preferred: GitHub public billing API using a fine-grained PAT
- *    configured in ~/.config/opencode/copilot-quota-token.json.
- * 2) Best-effort: internal endpoint using OpenCode's stored OAuth token
- *    (legacy formats or via token exchange).
+ * The plugin only uses documented GitHub billing APIs:
+ * - /users/{username}/settings/billing/premium_request/usage
+ * - /organizations/{org}/settings/billing/premium_request/usage
+ * - /enterprises/{enterprise}/settings/billing/premium_request/usage
  */
-import type { CopilotResult } from "./types.js";
+import type { AuthData, CopilotQuotaConfig, CopilotResult } from "./types.js";
+type CopilotAuthKeyName = "github-copilot" | "copilot" | "copilot-chat" | "github-copilot-chat";
+type CopilotPatTokenKind = "github_pat" | "ghp" | "ghu" | "ghs" | "other";
+type EffectiveCopilotAuthSource = "pat" | "oauth" | "none";
+type CopilotBillingMode = "user_quota" | "organization_usage" | "enterprise_usage" | "none";
+type CopilotRemainingTotalsState = "available" | "not_available_from_org_usage" | "not_available_from_enterprise_usage" | "unavailable";
+export type CopilotPatState = "absent" | "invalid" | "valid";
+export interface CopilotPatReadResult {
+    state: CopilotPatState;
+    checkedPaths: string[];
+    selectedPath?: string;
+    config?: CopilotQuotaConfig;
+    error?: string;
+    tokenKind?: CopilotPatTokenKind;
+}
+export interface CopilotQuotaAuthDiagnostics {
+    pat: CopilotPatReadResult;
+    oauth: {
+        configured: boolean;
+        keyName: CopilotAuthKeyName | null;
+        hasRefreshToken: boolean;
+        hasAccessToken: boolean;
+    };
+    effectiveSource: EffectiveCopilotAuthSource;
+    override: "pat_overrides_oauth" | "none";
+    billingMode: CopilotBillingMode;
+    billingScope: "user" | "organization" | "enterprise" | "none";
+    billingApiAccessLikely: boolean;
+    remainingTotalsState: CopilotRemainingTotalsState;
+    queryPeriod?: {
+        year: number;
+        month: number;
+    };
+    usernameFilter?: string;
+    billingTargetError?: string;
+    tokenCompatibilityError?: string;
+}
+export declare function getCopilotPatConfigCandidatePaths(): string[];
+export declare function readQuotaConfigWithMeta(): CopilotPatReadResult;
+export declare function getCopilotQuotaAuthDiagnostics(authData: AuthData | null): CopilotQuotaAuthDiagnostics;
 /**
- * Query GitHub Copilot premium requests quota
+ * Query GitHub Copilot premium request usage.
  *
- * @returns Quota result, error, or null if not configured
+ * PAT configuration wins over OpenCode OAuth auth when both are present.
  */
 export declare function queryCopilotQuota(): Promise<CopilotResult>;
-/**
- * Format Copilot quota for toast display
- *
- * @param result - Copilot quota result
- * @returns Formatted string like "Copilot 229/300 (24%)" or null
- */
 export declare function formatCopilotQuota(result: CopilotResult): string | null;
+export {};
 //# sourceMappingURL=copilot.d.ts.map

package/dist/lib/copilot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copilot.d.ts","sourceRoot":"","sources":["../../src/lib/copilot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAOV,aAAa,EACd,MAAM,YAAY,CAAC;AA0YpB;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,CAAC,CA2DhE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAevE"}
+{"version":3,"file":"copilot.d.ts","sourceRoot":"","sources":["../../src/lib/copilot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EACV,QAAQ,EAIR,kBAAkB,EAElB,aAAa,EAGd,MAAM,YAAY,CAAC;AAWpB,KAAK,kBAAkB,GACnB,gBAAgB,GAChB,SAAS,GACT,cAAc,GACd,qBAAqB,CAAC;AAC1B,KAAK,mBAAmB,GAAG,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;AAC1E,KAAK,0BAA0B,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAC3D,KAAK,kBAAkB,GAAG,YAAY,GAAG,oBAAoB,GAAG,kBAAkB,GAAG,MAAM,CAAC;AAC5F,KAAK,2BAA2B,GAC5B,WAAW,GACX,8BAA8B,GAC9B,qCAAqC,GACrC,aAAa,CAAC;AA4BlB,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,eAAe,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAED,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,oBAAoB,CAAC;IAC1B,KAAK,EAAE;QACL,UAAU,EAAE,OAAO,CAAC;QACpB,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;QACnC,eAAe,EAAE,OAAO,CAAC;QACzB,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,eAAe,EAAE,0BAA0B,CAAC;IAC5C,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAAC;IACzC,WAAW,EAAE,kBAAkB,CAAC;IAChC,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,YAAY,GAAG,MAAM,CAAC;IAC9D,sBAAsB,EAAE,OAAO,CAAC;IAChC,oBAAoB,EAAE,2BAA2B,CAAC;IAClD,WAAW,CAAC,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAiOD,wBAAgB,iCAAiC,IAAI,MAAM,EAAE,CAK5D;AA6DD,wBAAgB,uBAAuB,IAAI,oBAAoB,CAsC9D;AA0BD,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,2BAA2B,CA8CrG;AAqTD;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,CAAC,CAmFhE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CA0BvE"}