@stacksjs/ts-cloud 0.2.9 → 0.2.11

package/dist/aws/cost-explorer-cache.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Filesystem-backed cache for Cost Explorer responses.
+ *
+ * Cost Explorer charges $0.01 per GetCostAndUsage request. Running cost:analyze
+ * a few times in a day adds up — and closed-month data never changes, so we
+ * shouldn't keep paying to fetch it. This cache persists across CLI invocations
+ * under ~/.cache/ts-cloud/cost-explorer/<profile>/<sha>.json.
+ *
+ * TTL:
+ *   - Open period (end is on/after the first of the current UTC month): 1 hour
+ *   - Closed period (end is before the first of the current UTC month): 30 days
+ *     Closed months are immutable in Cost Explorer, so this is effectively
+ *     infinite while still bounding disk usage if many historical periods are
+ *     queried.
+ */
+export interface CostCacheKey {
+    start: string;
+    end: string;
+    granularity: string;
+    metrics: string[];
+    groupBy: Array<{
+        Type: string;
+        Key: string;
+    }>;
+}
+export interface CacheHit<T> {
+    response: T;
+    ageSeconds: number;
+}
+export declare function loadCache<T>(profile: string | undefined, key: CostCacheKey): CacheHit<T> | null;
+export declare function saveCache<T>(profile: string | undefined, key: CostCacheKey, response: T): void;
+export interface ClearResult {
+    deletedFiles: number;
+    scope: string;
+}
+/**
+ * Wipe cache entries. Pass a profile to scope; pass nothing to wipe everything.
+ */
+export declare function clearCache(profile?: string): ClearResult;
+export declare function cacheLocation(profile?: string): string;

package/dist/aws/cost-explorer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * AWS Cost Explorer Client
+ * Direct JSON-RPC calls (no AWS SDK / CLI dependency).
+ *
+ * Endpoint is global but lives in us-east-1.
+ *
+ * Cost Explorer requests are billed at $0.01 each, so getCostByService is
+ * served from a filesystem cache by default. Pass `useCache: false` to bypass.
+ */
+export interface ServiceCost {
+    service: string;
+    amount: number;
+    unit: string;
+}
+export interface CostExplorerOptions {
+    useCache?: boolean;
+}
+export declare class CostExplorerClient {
+    private client;
+    private profile;
+    private useCache;
+    /** Set after each call so callers can render a "(cached, NNN seconds old)" hint. */
+    lastCacheAgeSeconds: number | null;
+    constructor(profile?: string, options?: CostExplorerOptions);
+    /**
+     * Group total cost by SERVICE for a single time period, sorted descending.
+     */
+    getCostByService(params: {
+        start: string;
+        end: string;
+        granularity?: 'DAILY' | 'MONTHLY';
+    }): Promise<ServiceCost[]>;
+}

package/dist/aws/credentials.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared AWS credential resolution.
+ *
+ * Two modes:
+ *   - Explicit profile (caller passed a profile name): strict — use only that
+ *     profile, throw if it isn't in the credentials file. Mirrors the AWS CLI's
+ *     behavior with `--profile`.
+ *   - Implicit (no profile passed): standard precedence —
+ *       AWS_ACCESS_KEY_ID/SECRET env vars > AWS_PROFILE > 'default'.
+ */
+import type { AWSCredentials } from './client';
+export declare function resolveCredentials(profile?: string): AWSCredentials;

package/dist/aws/index.d.ts

@@ -4,6 +4,7 @@
  */
 export * from './client';
 export * from './cloudformation';
+export * from './cost-explorer';
 export * from './ec2';
 export * from './s3';
 export * from './cloudfront';

package/dist/aws/s3.d.ts

@@ -41,20 +41,13 @@ export interface S3Object {
 export declare class S3Client {
     private client;
     private region;
-    private profile;
+    private explicitProfile?;
     constructor(region?: string, profile?: string);
     /**
-     * Resolve credentials synchronously from file with the correct profile
-     */
-    private resolveProfileCredentialsSync;
-    /**
-     * Get AWS credentials from environment or credentials file
+     * Get AWS credentials (used by presigned URL / bucket-policy paths that bypass AWSClient.request).
+     * Honors the same explicit-vs-implicit profile semantics as the constructor.
      */
     private getCredentials;
-    /**
-     * Load credentials from ~/.aws/credentials file
-     */
-    private loadCredentialsFromFile;
     /**
      * List all S3 buckets in the account
      */