aws-instance-info 0.1.0

package/dist/rds.async.d.ts

@@ -0,0 +1,210 @@
+import { clearRDSCache, getRDSCacheStats } from './rds.cache.js';
+import type { RDSCategory, RDSFamilyData, RDSInfo, RDSInstanceClass, RDSInstanceDetails, RDSInstanceFamily } from './types.js';
+export { clearRDSCache, getRDSCacheStats };
+/**
+ * Get the RDS info manifest containing lists of all families and instance classes.
+ * This is a lightweight file that can be used to enumerate available data.
+ *
+ * @returns Promise resolving to RDSInfo object with families, instances, and categories arrays
+ *
+ * @example
+ * ```typescript
+ * import { getRDSInfo } from 'aws-instance-info/async'
+ *
+ * const info = await getRDSInfo()
+ * console.log(info.families) // ['M5', 'R6g', 'T3', ...]
+ * console.log(info.instances) // ['db.m5.large', 'db.r6g.xlarge', ...]
+ * console.log(info.categories) // ['general_purpose', 'memory_optimized', ...]
+ * ```
+ */
+export declare function getRDSInfo(): Promise<RDSInfo>;
+/**
+ * Get detailed information for a specific RDS instance class.
+ * Loads only the JSON file for the requested instance class. Results are cached using LRU.
+ *
+ * @param instanceClass - The instance class (e.g., "db.m5.large")
+ * @returns Promise resolving to instance class details including vCPUs, memory, network, and storage specs
+ *
+ * @example
+ * ```typescript
+ * import { getRDSInstanceInfo } from 'aws-instance-info/async'
+ *
+ * const instance = await getRDSInstanceInfo('db.m5.large')
+ * console.log(instance.instanceClass) // 'db.m5.large'
+ * console.log(instance.vCPUs) // 2
+ * console.log(instance.memoryGiB) // 8
+ * console.log(instance.networkBandwidthGbps) // 'Up to 10'
+ * ```
+ */
+export declare function getRDSInstanceInfo(instanceClass: RDSInstanceClass): Promise<RDSInstanceDetails>;
+/**
+ * Get all data for an RDS instance family.
+ * Includes the list of instance classes in the family. Results are cached using LRU.
+ *
+ * @param family - The instance family (e.g., "M5")
+ * @returns Promise resolving to family data including category and instance class list
+ *
+ * @example
+ * ```typescript
+ * import { getRDSFamily } from 'aws-instance-info/async'
+ *
+ * const family = await getRDSFamily('M5')
+ * console.log(family.category) // 'general_purpose'
+ * console.log(family.instanceClasses) // ['db.m5.large', 'db.m5.xlarge', ...]
+ * ```
+ */
+export declare function getRDSFamily(family: RDSInstanceFamily): Promise<RDSFamilyData>;
+/**
+ * Get all instance classes belonging to a specific RDS family.
+ * This loads the family file but only returns the list of instance classes.
+ *
+ * @param family - The instance family (e.g., "M5")
+ * @returns Promise resolving to array of instance class names in the family
+ *
+ * @example
+ * ```typescript
+ * import { getRDSFamilyInstanceClasses } from 'aws-instance-info/async'
+ *
+ * const classes = await getRDSFamilyInstanceClasses('M5')
+ * console.log(classes) // ['db.m5.large', 'db.m5.xlarge', 'db.m5.2xlarge', ...]
+ * ```
+ */
+export declare function getRDSFamilyInstanceClasses(family: RDSInstanceFamily): Promise<RDSInstanceClass[]>;
+/**
+ * Get the category for an RDS instance family.
+ *
+ * @param family - The instance family (e.g., "M5")
+ * @returns Promise resolving to the category (e.g., "general_purpose")
+ *
+ * @example
+ * ```typescript
+ * import { getRDSFamilyCategory } from 'aws-instance-info/async'
+ *
+ * const category = await getRDSFamilyCategory('M5')
+ * console.log(category) // 'general_purpose'
+ *
+ * const category2 = await getRDSFamilyCategory('R6g')
+ * console.log(category2) // 'memory_optimized'
+ * ```
+ */
+export declare function getRDSFamilyCategory(family: RDSInstanceFamily): Promise<RDSCategory>;
+/**
+ * Get all available RDS instance families.
+ *
+ * @returns Promise resolving to array of all family names
+ *
+ * @example
+ * ```typescript
+ * import { getAllRDSFamilies } from 'aws-instance-info/async'
+ *
+ * const families = await getAllRDSFamilies()
+ * console.log(families) // ['M5', 'M6g', 'M6i', 'R6g', 'R6i', 'T3', 'T4g', ...]
+ * console.log(families.length) // ~40
+ * ```
+ */
+export declare function getAllRDSFamilies(): Promise<RDSInstanceFamily[]>;
+/**
+ * Get all available RDS instance classes.
+ *
+ * @returns Promise resolving to array of all instance class names
+ *
+ * @example
+ * ```typescript
+ * import { getAllRDSInstanceClasses } from 'aws-instance-info/async'
+ *
+ * const classes = await getAllRDSInstanceClasses()
+ * console.log(classes) // ['db.m5.large', 'db.m5.xlarge', 'db.r6g.2xlarge', ...]
+ * console.log(classes.length) // ~350
+ * ```
+ */
+export declare function getAllRDSInstanceClasses(): Promise<RDSInstanceClass[]>;
+/**
+ * Get all available RDS categories.
+ *
+ * @returns Promise resolving to array of all category names
+ *
+ * @example
+ * ```typescript
+ * import { getAllRDSCategories } from 'aws-instance-info/async'
+ *
+ * const categories = await getAllRDSCategories()
+ * console.log(categories)
+ * // ['general_purpose', 'memory_optimized', 'compute_optimized', 'burstable_performance']
+ * ```
+ */
+export declare function getAllRDSCategories(): Promise<RDSCategory[]>;
+/**
+ * Check if an RDS instance class exists in the dataset.
+ *
+ * @param instanceClass - The instance class to check
+ * @returns Promise resolving to true if the instance class exists, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { isValidRDSInstanceClass } from 'aws-instance-info/async'
+ *
+ * console.log(await isValidRDSInstanceClass('db.m5.large')) // true
+ * console.log(await isValidRDSInstanceClass('db.m5.invalid')) // false
+ * console.log(await isValidRDSInstanceClass('db.t3.micro')) // true
+ * ```
+ */
+export declare function isValidRDSInstanceClass(instanceClass: string): Promise<boolean>;
+/**
+ * Check if an RDS instance family exists in the dataset.
+ *
+ * @param family - The family name to check
+ * @returns Promise resolving to true if the family exists, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { isValidRDSFamily } from 'aws-instance-info/async'
+ *
+ * console.log(await isValidRDSFamily('M5')) // true
+ * console.log(await isValidRDSFamily('R6g')) // true
+ * console.log(await isValidRDSFamily('Invalid')) // false
+ * ```
+ */
+export declare function isValidRDSFamily(family: string): Promise<boolean>;
+/**
+ * Get multiple RDS instance classes at once. Loads instances in parallel for better performance.
+ *
+ * @param instanceClasses - Array of instance classes to fetch
+ * @returns Promise resolving to Map of instance class to details
+ *
+ * @example
+ * ```typescript
+ * import { getRDSInstances } from 'aws-instance-info/async'
+ *
+ * const instances = await getRDSInstances(['db.m5.large', 'db.m5.xlarge', 'db.r6g.2xlarge'])
+ *
+ * for (const [cls, details] of instances) {
+ *   console.log(`${cls}: ${details.vCPUs} vCPUs, ${details.memoryGiB} GiB`)
+ * }
+ * // db.m5.large: 2 vCPUs, 8 GiB
+ * // db.m5.xlarge: 4 vCPUs, 16 GiB
+ * // db.r6g.2xlarge: 8 vCPUs, 64 GiB
+ * ```
+ */
+export declare function getRDSInstances(instanceClasses: RDSInstanceClass[]): Promise<Map<RDSInstanceClass, RDSInstanceDetails>>;
+/**
+ * Get multiple RDS families at once. Loads families in parallel for better performance.
+ *
+ * @param families - Array of family names to fetch
+ * @returns Promise resolving to Map of family name to family data
+ *
+ * @example
+ * ```typescript
+ * import { getRDSFamilies } from 'aws-instance-info/async'
+ *
+ * const families = await getRDSFamilies(['M5', 'R6g', 'T3'])
+ *
+ * for (const [name, data] of families) {
+ *   console.log(`${name}: ${data.category}, ${data.instanceClasses.length} classes`)
+ * }
+ * // M5: general_purpose, 12 classes
+ * // R6g: memory_optimized, 11 classes
+ * // T3: burstable_performance, 8 classes
+ * ```
+ */
+export declare function getRDSFamilies(families: RDSInstanceFamily[]): Promise<Map<RDSInstanceFamily, RDSFamilyData>>;
+//# sourceMappingURL=rds.async.d.ts.map

package/dist/rds.async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rds.async.d.ts","sourceRoot":"","sources":["../lib/rds.async.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,aAAa,EAEb,gBAAgB,EAGjB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,OAAO,EACP,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAA;AAS1C;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAOnD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,gBAAgB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAW7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,aAAa,CAAC,CASxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAG7B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,WAAW,CAAC,CAGtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAGtE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAG5E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAGlE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGvE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,eAAe,CACnC,eAAe,EAAE,gBAAgB,EAAE,GAClC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC,CASpD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAShD"}

package/dist/rds.async.js

@@ -0,0 +1,273 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { RDS_DATA_DIR, clearRDSCache, familyCache, getRDSCacheStats, infoCacheHolder, instanceCache, } from './rds.cache.js';
+/* Re-export cache utilities (these remain synchronous) */
+export { clearRDSCache, getRDSCacheStats };
+/* Internal helper function to load and parse JSON files asynchronously */
+async function loadJson(relativePath) {
+    const fullPath = join(RDS_DATA_DIR, relativePath);
+    const content = await readFile(fullPath, 'utf-8');
+    return JSON.parse(content);
+}
+/**
+ * Get the RDS info manifest containing lists of all families and instance classes.
+ * This is a lightweight file that can be used to enumerate available data.
+ *
+ * @returns Promise resolving to RDSInfo object with families, instances, and categories arrays
+ *
+ * @example
+ * ```typescript
+ * import { getRDSInfo } from 'aws-instance-info/async'
+ *
+ * const info = await getRDSInfo()
+ * console.log(info.families) // ['M5', 'R6g', 'T3', ...]
+ * console.log(info.instances) // ['db.m5.large', 'db.r6g.xlarge', ...]
+ * console.log(info.categories) // ['general_purpose', 'memory_optimized', ...]
+ * ```
+ */
+export async function getRDSInfo() {
+    if (infoCacheHolder.value) {
+        return infoCacheHolder.value;
+    }
+    infoCacheHolder.value = await loadJson('info.json');
+    return infoCacheHolder.value;
+}
+/**
+ * Get detailed information for a specific RDS instance class.
+ * Loads only the JSON file for the requested instance class. Results are cached using LRU.
+ *
+ * @param instanceClass - The instance class (e.g., "db.m5.large")
+ * @returns Promise resolving to instance class details including vCPUs, memory, network, and storage specs
+ *
+ * @example
+ * ```typescript
+ * import { getRDSInstanceInfo } from 'aws-instance-info/async'
+ *
+ * const instance = await getRDSInstanceInfo('db.m5.large')
+ * console.log(instance.instanceClass) // 'db.m5.large'
+ * console.log(instance.vCPUs) // 2
+ * console.log(instance.memoryGiB) // 8
+ * console.log(instance.networkBandwidthGbps) // 'Up to 10'
+ * ```
+ */
+export async function getRDSInstanceInfo(instanceClass) {
+    const cached = instanceCache.get(instanceClass);
+    if (cached) {
+        return cached;
+    }
+    const data = await loadJson(`instances/${instanceClass}.json`);
+    instanceCache.set(instanceClass, data);
+    return data;
+}
+/**
+ * Get all data for an RDS instance family.
+ * Includes the list of instance classes in the family. Results are cached using LRU.
+ *
+ * @param family - The instance family (e.g., "M5")
+ * @returns Promise resolving to family data including category and instance class list
+ *
+ * @example
+ * ```typescript
+ * import { getRDSFamily } from 'aws-instance-info/async'
+ *
+ * const family = await getRDSFamily('M5')
+ * console.log(family.category) // 'general_purpose'
+ * console.log(family.instanceClasses) // ['db.m5.large', 'db.m5.xlarge', ...]
+ * ```
+ */
+export async function getRDSFamily(family) {
+    const cached = familyCache.get(family);
+    if (cached) {
+        return cached;
+    }
+    const data = await loadJson(`families/${family}.json`);
+    familyCache.set(family, data);
+    return data;
+}
+/**
+ * Get all instance classes belonging to a specific RDS family.
+ * This loads the family file but only returns the list of instance classes.
+ *
+ * @param family - The instance family (e.g., "M5")
+ * @returns Promise resolving to array of instance class names in the family
+ *
+ * @example
+ * ```typescript
+ * import { getRDSFamilyInstanceClasses } from 'aws-instance-info/async'
+ *
+ * const classes = await getRDSFamilyInstanceClasses('M5')
+ * console.log(classes) // ['db.m5.large', 'db.m5.xlarge', 'db.m5.2xlarge', ...]
+ * ```
+ */
+export async function getRDSFamilyInstanceClasses(family) {
+    const familyData = await getRDSFamily(family);
+    return familyData.instanceClasses;
+}
+/**
+ * Get the category for an RDS instance family.
+ *
+ * @param family - The instance family (e.g., "M5")
+ * @returns Promise resolving to the category (e.g., "general_purpose")
+ *
+ * @example
+ * ```typescript
+ * import { getRDSFamilyCategory } from 'aws-instance-info/async'
+ *
+ * const category = await getRDSFamilyCategory('M5')
+ * console.log(category) // 'general_purpose'
+ *
+ * const category2 = await getRDSFamilyCategory('R6g')
+ * console.log(category2) // 'memory_optimized'
+ * ```
+ */
+export async function getRDSFamilyCategory(family) {
+    const familyData = await getRDSFamily(family);
+    return familyData.category;
+}
+/**
+ * Get all available RDS instance families.
+ *
+ * @returns Promise resolving to array of all family names
+ *
+ * @example
+ * ```typescript
+ * import { getAllRDSFamilies } from 'aws-instance-info/async'
+ *
+ * const families = await getAllRDSFamilies()
+ * console.log(families) // ['M5', 'M6g', 'M6i', 'R6g', 'R6i', 'T3', 'T4g', ...]
+ * console.log(families.length) // ~40
+ * ```
+ */
+export async function getAllRDSFamilies() {
+    const info = await getRDSInfo();
+    return info.families;
+}
+/**
+ * Get all available RDS instance classes.
+ *
+ * @returns Promise resolving to array of all instance class names
+ *
+ * @example
+ * ```typescript
+ * import { getAllRDSInstanceClasses } from 'aws-instance-info/async'
+ *
+ * const classes = await getAllRDSInstanceClasses()
+ * console.log(classes) // ['db.m5.large', 'db.m5.xlarge', 'db.r6g.2xlarge', ...]
+ * console.log(classes.length) // ~350
+ * ```
+ */
+export async function getAllRDSInstanceClasses() {
+    const info = await getRDSInfo();
+    return info.instances;
+}
+/**
+ * Get all available RDS categories.
+ *
+ * @returns Promise resolving to array of all category names
+ *
+ * @example
+ * ```typescript
+ * import { getAllRDSCategories } from 'aws-instance-info/async'
+ *
+ * const categories = await getAllRDSCategories()
+ * console.log(categories)
+ * // ['general_purpose', 'memory_optimized', 'compute_optimized', 'burstable_performance']
+ * ```
+ */
+export async function getAllRDSCategories() {
+    const info = await getRDSInfo();
+    return info.categories;
+}
+/**
+ * Check if an RDS instance class exists in the dataset.
+ *
+ * @param instanceClass - The instance class to check
+ * @returns Promise resolving to true if the instance class exists, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { isValidRDSInstanceClass } from 'aws-instance-info/async'
+ *
+ * console.log(await isValidRDSInstanceClass('db.m5.large')) // true
+ * console.log(await isValidRDSInstanceClass('db.m5.invalid')) // false
+ * console.log(await isValidRDSInstanceClass('db.t3.micro')) // true
+ * ```
+ */
+export async function isValidRDSInstanceClass(instanceClass) {
+    const info = await getRDSInfo();
+    return info.instances.includes(instanceClass);
+}
+/**
+ * Check if an RDS instance family exists in the dataset.
+ *
+ * @param family - The family name to check
+ * @returns Promise resolving to true if the family exists, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { isValidRDSFamily } from 'aws-instance-info/async'
+ *
+ * console.log(await isValidRDSFamily('M5')) // true
+ * console.log(await isValidRDSFamily('R6g')) // true
+ * console.log(await isValidRDSFamily('Invalid')) // false
+ * ```
+ */
+export async function isValidRDSFamily(family) {
+    const info = await getRDSInfo();
+    return info.families.includes(family);
+}
+/**
+ * Get multiple RDS instance classes at once. Loads instances in parallel for better performance.
+ *
+ * @param instanceClasses - Array of instance classes to fetch
+ * @returns Promise resolving to Map of instance class to details
+ *
+ * @example
+ * ```typescript
+ * import { getRDSInstances } from 'aws-instance-info/async'
+ *
+ * const instances = await getRDSInstances(['db.m5.large', 'db.m5.xlarge', 'db.r6g.2xlarge'])
+ *
+ * for (const [cls, details] of instances) {
+ *   console.log(`${cls}: ${details.vCPUs} vCPUs, ${details.memoryGiB} GiB`)
+ * }
+ * // db.m5.large: 2 vCPUs, 8 GiB
+ * // db.m5.xlarge: 4 vCPUs, 16 GiB
+ * // db.r6g.2xlarge: 8 vCPUs, 64 GiB
+ * ```
+ */
+export async function getRDSInstances(instanceClasses) {
+    const results = await Promise.all(instanceClasses.map(async (instanceClass) => {
+        const details = await getRDSInstanceInfo(instanceClass);
+        return [instanceClass, details];
+    }));
+    return new Map(results);
+}
+/**
+ * Get multiple RDS families at once. Loads families in parallel for better performance.
+ *
+ * @param families - Array of family names to fetch
+ * @returns Promise resolving to Map of family name to family data
+ *
+ * @example
+ * ```typescript
+ * import { getRDSFamilies } from 'aws-instance-info/async'
+ *
+ * const families = await getRDSFamilies(['M5', 'R6g', 'T3'])
+ *
+ * for (const [name, data] of families) {
+ *   console.log(`${name}: ${data.category}, ${data.instanceClasses.length} classes`)
+ * }
+ * // M5: general_purpose, 12 classes
+ * // R6g: memory_optimized, 11 classes
+ * // T3: burstable_performance, 8 classes
+ * ```
+ */
+export async function getRDSFamilies(families) {
+    const results = await Promise.all(families.map(async (family) => {
+        const data = await getRDSFamily(family);
+        return [family, data];
+    }));
+    return new Map(results);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmRzLmFzeW5jLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vbGliL3Jkcy5hc3luYy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sa0JBQWtCLENBQUE7QUFDM0MsT0FBTyxFQUFFLElBQUksRUFBRSxNQUFNLFdBQVcsQ0FBQTtBQUVoQyxPQUFPLEVBQ0wsWUFBWSxFQUNaLGFBQWEsRUFDYixXQUFXLEVBQ1gsZ0JBQWdCLEVBQ2hCLGVBQWUsRUFDZixhQUFhLEdBQ2QsTUFBTSxnQkFBZ0IsQ0FBQTtBQVV2QiwwREFBMEQ7QUFDMUQsT0FBTyxFQUFFLGFBQWEsRUFBRSxnQkFBZ0IsRUFBRSxDQUFBO0FBRTFDLDBFQUEwRTtBQUMxRSxLQUFLLFVBQVUsUUFBUSxDQUFJLFlBQW9CO0lBQzdDLE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxZQUFZLEVBQUUsWUFBWSxDQUFDLENBQUE7SUFDakQsTUFBTSxPQUFPLEdBQUcsTUFBTSxRQUFRLENBQUMsUUFBUSxFQUFFLE9BQU8sQ0FBQyxDQUFBO0lBQ2pELE9BQU8sSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQU0sQ0FBQTtBQUNqQyxDQUFDO0FBRUQ7Ozs7Ozs7Ozs7Ozs7OztHQWVHO0FBQ0gsTUFBTSxDQUFDLEtBQUssVUFBVSxVQUFVO0lBQzlCLElBQUksZUFBZSxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQzFCLE9BQU8sZUFBZSxDQUFDLEtBQUssQ0FBQTtJQUM5QixDQUFDO0lBRUQsZUFBZSxDQUFDLEtBQUssR0FBRyxNQUFNLFFBQVEsQ0FBVSxXQUFXLENBQUMsQ0FBQTtJQUM1RCxPQUFPLGVBQWUsQ0FBQyxLQUFLLENBQUE7QUFDOUIsQ0FBQztBQUVEOzs7Ozs7Ozs7Ozs7Ozs7OztHQWlCRztBQUNILE1BQU0sQ0FBQyxLQUFLLFVBQVUsa0JBQWtCLENBQ3RDLGFBQStCO0lBRS9CLE1BQU0sTUFBTSxHQUFHLGFBQWEsQ0FBQyxHQUFHLENB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

package/dist/rds.cache.d.ts

@@ -0,0 +1,50 @@
+import { LRUCache } from 'lru-cache';
+import type { RDSFamilyData, RDSInfo, RDSInstanceDetails } from './types.js';
+/** Base directory for RDS data files */
+export declare const RDS_DATA_DIR: string;
+export declare const instanceCache: LRUCache<string, RDSInstanceDetails, unknown>;
+export declare const familyCache: LRUCache<string, RDSFamilyData, unknown>;
+/** Info cache wrapper to allow mutation */
+export declare const infoCacheHolder: {
+    value: RDSInfo | null;
+};
+/**
+ * Clear all RDS cached data.
+ * Useful for testing or when you need to free memory.
+ *
+ * @example
+ * ```typescript
+ * import { clearRDSCache, getRDSCacheStats } from 'aws-instance-info'
+ *
+ * console.log(getRDSCacheStats()) // { instances: 10, families: 3, infoLoaded: true }
+ *
+ * clearRDSCache()
+ *
+ * console.log(getRDSCacheStats()) // { instances: 0, families: 0, infoLoaded: false }
+ * ```
+ */
+export declare function clearRDSCache(): void;
+/**
+ * Get RDS cache statistics.
+ * Useful for debugging or monitoring memory usage.
+ *
+ * @returns Object with cache statistics
+ *
+ * @example
+ * ```typescript
+ * import { getRDSCacheStats, getRDSInstanceInfo } from 'aws-instance-info'
+ *
+ * getRDSInstanceInfo('db.m5.large')
+ * getRDSInstanceInfo('db.m5.xlarge')
+ *
+ * const stats = getRDSCacheStats()
+ * console.log(stats)
+ * // { instances: 2, families: 0, infoLoaded: true }
+ * ```
+ */
+export declare function getRDSCacheStats(): {
+    instances: number;
+    families: number;
+    infoLoaded: boolean;
+};
+//# sourceMappingURL=rds.cache.d.ts.map

package/dist/rds.cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rds.cache.d.ts","sourceRoot":"","sources":["../lib/rds.cache.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAGpC,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAM5E,wCAAwC;AACxC,eAAO,MAAM,YAAY,QAAuC,CAAA;AAGhE,eAAO,MAAM,aAAa,+CAExB,CAAA;AACF,eAAO,MAAM,WAAW,0CAEtB,CAAA;AAEF,2CAA2C;AAC3C,eAAO,MAAM,eAAe,EAAE;IAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;CAAoB,CAAA;AAEzE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAIpC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,IAAI;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;CACpB,CAMA"}

package/dist/rds.cache.js

@@ -0,0 +1,64 @@
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { LRUCache } from 'lru-cache';
+import { RDS_FAMILY_CACHE_SIZE, RDS_INSTANCE_CACHE_SIZE } from './constants.js';
+/* File Paths */
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/** Base directory for RDS data files */
+export const RDS_DATA_DIR = join(__dirname, '..', 'data', 'rds');
+/* Internal Caches - shared between sync and async APIs */
+export const instanceCache = new LRUCache({
+    max: RDS_INSTANCE_CACHE_SIZE,
+});
+export const familyCache = new LRUCache({
+    max: RDS_FAMILY_CACHE_SIZE,
+});
+/** Info cache wrapper to allow mutation */
+export const infoCacheHolder = { value: null };
+/**
+ * Clear all RDS cached data.
+ * Useful for testing or when you need to free memory.
+ *
+ * @example
+ * ```typescript
+ * import { clearRDSCache, getRDSCacheStats } from 'aws-instance-info'
+ *
+ * console.log(getRDSCacheStats()) // { instances: 10, families: 3, infoLoaded: true }
+ *
+ * clearRDSCache()
+ *
+ * console.log(getRDSCacheStats()) // { instances: 0, families: 0, infoLoaded: false }
+ * ```
+ */
+export function clearRDSCache() {
+    instanceCache.clear();
+    familyCache.clear();
+    infoCacheHolder.value = null;
+}
+/**
+ * Get RDS cache statistics.
+ * Useful for debugging or monitoring memory usage.
+ *
+ * @returns Object with cache statistics
+ *
+ * @example
+ * ```typescript
+ * import { getRDSCacheStats, getRDSInstanceInfo } from 'aws-instance-info'
+ *
+ * getRDSInstanceInfo('db.m5.large')
+ * getRDSInstanceInfo('db.m5.xlarge')
+ *
+ * const stats = getRDSCacheStats()
+ * console.log(stats)
+ * // { instances: 2, families: 0, infoLoaded: true }
+ * ```
+ */
+export function getRDSCacheStats() {
+    return {
+        instances: instanceCache.size,
+        families: familyCache.size,
+        infoLoaded: infoCacheHolder.value !== null,
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmRzLmNhY2hlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vbGliL3Jkcy5jYWNoZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsT0FBTyxFQUFFLElBQUksRUFBRSxNQUFNLFdBQVcsQ0FBQTtBQUN6QyxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sVUFBVSxDQUFBO0FBQ3hDLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxXQUFXLENBQUE7QUFFcEMsT0FBTyxFQUFFLHFCQUFxQixFQUFFLHVCQUF1QixFQUFFLE1BQU0sZ0JBQWdCLENBQUE7QUFHL0UsZ0JBQWdCO0FBQ2hCLE1BQU0sVUFBVSxHQUFHLGFBQWEsQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFBO0FBQ2pELE1BQU0sU0FBUyxHQUFHLE9BQU8sQ0FBQyxVQUFVLENBQUMsQ0FBQTtBQUVyQyx3Q0FBd0M7QUFDeEMsTUFBTSxDQUFDLE1BQU0sWUFBWSxHQUFHLElBQUksQ0FBQyxTQUFTLEVBQUUsSUFBSSxFQUFFLE1BQU0sRUFBRSxLQUFLLENBQUMsQ0FBQTtBQUVoRSwwREFBMEQ7QUFDMUQsTUFBTSxDQUFDLE1BQU0sYUFBYSxHQUFHLElBQUksUUFBUSxDQUE2QjtJQUNwRSxHQUFHLEVBQUUsdUJBQXVCO0NBQzdCLENBQUMsQ0FBQTtBQUNGLE1BQU0sQ0FBQyxNQUFNLFdBQVcsR0FBRyxJQUFJLFFBQVEsQ0FBd0I7SUFDN0QsR0FBRyxFQUFFLHFCQUFxQjtDQUMzQixDQUFDLENBQUE7QUFFRiwyQ0FBMkM7QUFDM0MsTUFBTSxDQUFDLE1BQU0sZUFBZSxHQUE4QixFQUFFLEtBQUssRUFBRSxJQUFJLEVBQUUsQ0FBQTtBQUV6RTs7Ozs7Ozs7Ozs7Ozs7R0FjRztBQUNILE1BQU0sVUFBVSxhQUFhO0lBQzNCLGFBQWEsQ0FBQyxLQUFLLEVBQUUsQ0FBQTtJQUNyQixXQUFXLENBQUMsS0FBSyxFQUFFLENBQUE7SUFDbkIsZUFBZSxDQUFDLEtBQUssR0FBRyxJQUFJLENBQUE7QUFDOUIsQ0FBQztBQUVEOzs7Ozs7Ozs7Ozs7Ozs7OztHQWlCRztBQUNILE1BQU0sVUFBVSxnQkFBZ0I7SUFLOUIsT0FBTztRQUNMLFNBQVMsRUFBRSxhQUFhLENBQUMsSUFBSTtRQUM3QixRQUFRLEVBQUUsV0FBVyxDQUFDLElBQUk7UUFDMUIsVUFBVSxFQUFFLGVBQWUsQ0FBQyxLQUFLLEtBQUssSUFBSTtLQUMzQyxDQUFBO0FBQ0gsQ0FBQyJ9