@fnndsc/stratus 0.0.0-stage → 0.0.0

package/dist/cloud/fake/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../src/cloud/fake/driver.ts"],"names":[],"mappings":"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"}

package/dist/cloud/oci/api.d.ts

@@ -0,0 +1,81 @@
+/** What the SDK says about the credential's tenancy. */
+export interface OciTenancyRecord {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly homeRegionKey: string;
+    readonly freeformTags: Readonly<Record<string, string>>;
+    readonly definedTags: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+}
+/** What the SDK says about a compartment. */
+export interface OciCompartmentRecord {
+    readonly id: string;
+    readonly compartmentId: string;
+    readonly name: string;
+    readonly description: string;
+    readonly lifecycleState: string;
+    readonly timeCreated: string;
+    readonly freeformTags: Readonly<Record<string, string>>;
+    readonly definedTags: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+}
+/** One limit value, as the Limits API lists it. */
+export interface OciLimitValueRecord {
+    readonly name: string;
+    readonly scopeType: string;
+    readonly availabilityDomain: string | null;
+    readonly value: number;
+}
+/** A shape, as Compute lists it. */
+export interface OciShapeRecord {
+    readonly shape: string;
+    readonly processorDescription: string;
+    readonly ocpus: number | null;
+    readonly memoryInGBs: number | null;
+    readonly gpus: number;
+    readonly isFlexible: boolean;
+    readonly ocpuOptions: {
+        readonly min: number;
+        readonly max: number;
+    } | null;
+    readonly memoryOptions: {
+        readonly minInGBs: number;
+        readonly maxInGBs: number;
+    } | null;
+    readonly quotaNames: ReadonlyArray<string>;
+    readonly raw: unknown;
+}
+/** The calls the driver makes. */
+export interface OciApi {
+    /** The credential's tenancy id, user id and home region, read from the profile without a call. */
+    credential_get(): {
+        tenancyId: string;
+        userId: string;
+        region: string;
+    };
+    tenancy_get(tenancyId: string): Promise<OciTenancyRecord>;
+    userName_get(userId: string): Promise<string>;
+    compartments_list(parentId: string): Promise<OciCompartmentRecord[]>;
+    regionSubscriptions_list(tenancyId: string): Promise<string[]>;
+    availabilityDomains_list(region: string, tenancyId: string): Promise<string[]>;
+    limitServices_list(region: string, tenancyId: string): Promise<string[]>;
+    limitValues_list(region: string, tenancyId: string, service: string): Promise<OciLimitValueRecord[]>;
+    resourceAvailability_get(region: string, tenancyId: string, service: string, limitName: string, availabilityDomain?: string): Promise<{
+        used: number;
+        available: number;
+    } | null>;
+    shapes_list(region: string, tenancyId: string): Promise<OciShapeRecord[]>;
+}
+/** How the real API is reached. */
+export interface OciApiOptions {
+    /** The profile's file; the SDK's default (`~/.oci/config`) when absent. */
+    readonly configFile?: string;
+    /** The profile; `DEFAULT` when absent. */
+    readonly profile?: string;
+}
+/**
+ * The real API over the SDK, authenticated by an API-key profile.
+ *
+ * @param options - The profile.
+ * @returns The API.
+ */
+export declare function ociApi_make(options?: OciApiOptions): OciApi;

package/dist/cloud/oci/api.js

@@ -0,0 +1,184 @@
+/**
+ * @file The OCI API as the driver uses it: a few calls, plain answers.
+ *
+ * The SDK's clients sit behind this interface so the driver can be tested
+ * against recorded answers (`tests/fixtures/oci/*.json`) and the SDK is
+ * loaded only here. Every call pages to the end; the driver never sees a
+ * page token. Only this folder may import an `oci-*` package
+ * (`lint:stratus-deps`).
+ *
+ * @module
+ */
+import * as common from 'oci-common';
+import * as identity from 'oci-identity';
+import * as limits from 'oci-limits';
+import * as core from 'oci-core';
+/**
+ * Every item of a paged list call.
+ *
+ * @param page_get - Fetches one page, given the token of the previous (undefined first).
+ * @returns Every item, in order.
+ */
+async function pages_drain(page_get) {
+    const items = [];
+    let token = undefined;
+    do {
+        const page = await page_get(token);
+        items.push(...page.items);
+        token = page.opcNextPage === '' ? undefined : page.opcNextPage;
+    } while (token !== undefined);
+    return items;
+}
+/** Tags as the SDK gives them, with absent ones as empty. */
+function tags_of(freeform, defined) {
+    return { freeformTags: freeform ?? {}, definedTags: defined ?? {} };
+}
+/**
+ * The real API over the SDK, authenticated by an API-key profile.
+ *
+ * @param options - The profile.
+ * @returns The API.
+ */
+export function ociApi_make(options = {}) {
+    const provider = new common.ConfigFileAuthenticationDetailsProvider(options.configFile, options.profile);
+    const clients = new Map();
+    const identityClient_for = (region) => {
+        const key = `identity/${region}`;
+        let client = clients.get(key);
+        if (client === undefined) {
+            client = new identity.IdentityClient({ authenticationDetailsProvider: provider });
+            client.regionId = region;
+            clients.set(key, client);
+        }
+        return client;
+    };
+    const limitsClient_for = (region) => {
+        const key = `limits/${region}`;
+        let client = clients.get(key);
+        if (client === undefined) {
+            client = new limits.LimitsClient({ authenticationDetailsProvider: provider });
+            client.regionId = region;
+            clients.set(key, client);
+        }
+        return client;
+    };
+    const computeClient_for = (region) => {
+        const key = `compute/${region}`;
+        let client = clients.get(key);
+        if (client === undefined) {
+            client = new core.ComputeClient({ authenticationDetailsProvider: provider });
+            client.regionId = region;
+            clients.set(key, client);
+        }
+        return client;
+    };
+    const homeRegion = provider.getRegion().regionId;
+    return {
+        credential_get: () => ({
+            tenancyId: provider.getTenantId(),
+            userId: provider.getUser(),
+            region: homeRegion,
+        }),
+        async tenancy_get(tenancyId) {
+            const answer = await identityClient_for(homeRegion).getTenancy({ tenancyId });
+            const tenancy = answer.tenancy;
+            return {
+                id: tenancy.id ?? tenancyId,
+                name: tenancy.name ?? '',
+                description: tenancy.description ?? '',
+                homeRegionKey: tenancy.homeRegionKey ?? '',
+                ...tags_of(tenancy.freeformTags, tenancy.definedTags),
+            };
+        },
+        async userName_get(userId) {
+            const answer = await identityClient_for(homeRegion).getUser({ userId });
+            return answer.user.name;
+        },
+        async compartments_list(parentId) {
+            const client = identityClient_for(homeRegion);
+            const items = await pages_drain(async (page) => {
+                const answer = await client.listCompartments({
+                    compartmentId: parentId,
+                    accessLevel: identity.requests.ListCompartmentsRequest.AccessLevel.Accessible,
+                    sortBy: identity.requests.ListCompartmentsRequest.SortBy.Name,
+                    sortOrder: identity.requests.ListCompartmentsRequest.SortOrder.Asc,
+                    ...(page !== undefined ? { page } : {}),
+                });
+                return { items: answer.items, opcNextPage: answer.opcNextPage };
+            });
+            return items.map((compartment) => ({
+                id: compartment.id,
+                compartmentId: compartment.compartmentId,
+                name: compartment.name,
+                description: compartment.description,
+                lifecycleState: String(compartment.lifecycleState),
+                timeCreated: new Date(compartment.timeCreated).toISOString(),
+                ...tags_of(compartment.freeformTags, compartment.definedTags),
+            }));
+        },
+        async regionSubscriptions_list(tenancyId) {
+            const answer = await identityClient_for(homeRegion).listRegionSubscriptions({ tenancyId });
+            return answer.items
+                .filter((subscription) => String(subscription.status) === 'READY')
+                .map((subscription) => subscription.regionName)
+                .sort();
+        },
+        async availabilityDomains_list(region, tenancyId) {
+            const answer = await identityClient_for(region).listAvailabilityDomains({ compartmentId: tenancyId });
+            return answer.items.map((domain) => domain.name ?? '').filter((name) => name !== '').sort();
+        },
+        async limitServices_list(region, tenancyId) {
+            const client = limitsClient_for(region);
+            const items = await pages_drain(async (page) => {
+                const answer = await client.listServices({ compartmentId: tenancyId, ...(page !== undefined ? { page } : {}) });
+                return { items: answer.items, opcNextPage: answer.opcNextPage };
+            });
+            return items.map((service) => service.name ?? '').filter((name) => name !== '').sort();
+        },
+        async limitValues_list(region, tenancyId, service) {
+            const client = limitsClient_for(region);
+            const items = await pages_drain(async (page) => {
+                const answer = await client.listLimitValues({ compartmentId: tenancyId, serviceName: service, ...(page !== undefined ? { page } : {}) });
+                return { items: answer.items, opcNextPage: answer.opcNextPage };
+            });
+            return items.map((value) => ({
+                name: value.name ?? '',
+                scopeType: String(value.scopeType ?? ''),
+                availabilityDomain: value.availabilityDomain ?? null,
+                value: value.value ?? 0,
+            }));
+        },
+        async resourceAvailability_get(region, tenancyId, service, limitName, availabilityDomain) {
+            const answer = await limitsClient_for(region).getResourceAvailability({
+                serviceName: service,
+                limitName,
+                compartmentId: tenancyId,
+                ...(availabilityDomain !== undefined ? { availabilityDomain } : {}),
+            });
+            const availability = answer.resourceAvailability;
+            if (availability.used === undefined || availability.available === undefined)
+                return null;
+            return { used: availability.used, available: availability.available };
+        },
+        async shapes_list(region, tenancyId) {
+            const client = computeClient_for(region);
+            const items = await pages_drain(async (page) => {
+                const answer = await client.listShapes({ compartmentId: tenancyId, ...(page !== undefined ? { page } : {}) });
+                return { items: answer.items, opcNextPage: answer.opcNextPage };
+            });
+            return items.map((shape) => ({
+                shape: shape.shape,
+                processorDescription: shape.processorDescription ?? '',
+                ocpus: shape.ocpus ?? null,
+                memoryInGBs: shape.memoryInGBs ?? null,
+                gpus: shape.gpus ?? 0,
+                isFlexible: shape.isFlexible ?? false,
+                ocpuOptions: shape.ocpuOptions !== undefined ? { min: shape.ocpuOptions.min ?? 0, max: shape.ocpuOptions.max ?? 0 } : null,
+                memoryOptions: shape.memoryOptions !== undefined ? { minInGBs: shape.memoryOptions.minInGBs ?? 0, maxInGBs: shape.memoryOptions.maxInGBs ?? 0 } : null,
+                quotaNames: shape.quotaNames ?? [],
+                raw: shape,
+            }));
+        },
+    };
+}
+//# sourceMappingURL=api.js.map

package/dist/cloud/oci/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/cloud/oci/api.ts"],"names":[],"mappings":"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"}

package/dist/cloud/oci/driver.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @file The OCI driver: Oracle Cloud Infrastructure as stratus's cloud.
+ *
+ * Containers are compartments, the root the tenancy; zones are availability
+ * domains; limits come from the Limits service and shapes from Compute,
+ * each asked in the region given; prices from Oracle's public list. The SDK
+ * is reached through `OciApi` (`api.ts`), so this file maps records and
+ * tests run it over recorded answers.
+ *
+ * @module
+ */
+import type { CloudAvailability, CloudContainer, CloudDriver, CloudIdentity, CloudLimit, CloudPrice, CloudShape, CloudZone } from '../driver.js';
+import type { OciApi, OciShapeRecord } from './api.js';
+import { type JsonFetch } from './prices.js';
+/** How the driver is made. */
+export interface OciDriverOptions {
+    /** The API; the real one when absent. */
+    readonly api: OciApi;
+    /** How the price list is fetched; Node's fetch when absent. */
+    readonly fetchJson?: JsonFetch;
+}
+/** Tags flattened: freeform as `key`, defined as `namespace.key`. */
+export declare function ociTags_flatten(freeform: Readonly<Record<string, string>>, defined: Readonly<Record<string, Readonly<Record<string, unknown>>>>): Record<string, string>;
+/** A shape record as a shape. */
+export declare function shape_ofRecord(record: OciShapeRecord): CloudShape;
+/** Oracle Cloud Infrastructure as a cloud driver. */
+export declare class OciDriver implements CloudDriver {
+    readonly cloud: string;
+    private readonly api;
+    private readonly fetchJson;
+    constructor(options: OciDriverOptions);
+    identity_get(): Promise<CloudIdentity>;
+    root_get(): Promise<CloudContainer>;
+    containers_list(parentId: string): Promise<CloudContainer[]>;
+    regions_list(): Promise<string[]>;
+    zones_list(region: string): Promise<CloudZone[]>;
+    limitServices_list(region: string): Promise<string[]>;
+    limits_list(region: string, service: string): Promise<CloudLimit[]>;
+    limitAvailability_get(region: string, service: string, name: string, zone?: string): Promise<CloudAvailability | null>;
+    shapes_list(region: string): Promise<CloudShape[]>;
+    prices_list(): Promise<CloudPrice[]>;
+}

package/dist/cloud/oci/driver.js

@@ -0,0 +1,131 @@
+import { ociPrices_read, shapeTerms_get } from './prices.js';
+/** Tags flattened: freeform as `key`, defined as `namespace.key`. */
+export function ociTags_flatten(freeform, defined) {
+    const tags = {};
+    for (const [key, value] of Object.entries(freeform))
+        tags[key] = value;
+    for (const [namespace, keys] of Object.entries(defined)) {
+        for (const [key, value] of Object.entries(keys))
+            tags[`${namespace}.${key}`] = String(value);
+    }
+    return tags;
+}
+/** A compartment record as a container. */
+function container_ofCompartment(record) {
+    return {
+        name: record.name,
+        id: record.id,
+        parentId: record.compartmentId,
+        state: record.lifecycleState.toLowerCase(),
+        created: record.timeCreated,
+        description: record.description,
+        tags: ociTags_flatten(record.freeformTags, record.definedTags),
+        noun: 'compartment',
+        raw: record,
+    };
+}
+/** The tenancy as the root container. */
+function container_ofTenancy(record) {
+    return {
+        name: record.name,
+        id: record.id,
+        parentId: null,
+        state: 'active',
+        created: '',
+        description: record.description,
+        tags: ociTags_flatten(record.freeformTags, record.definedTags),
+        noun: 'tenancy',
+        raw: record,
+    };
+}
+/** A limit value as a limit at its scope. */
+function limit_ofValue(service, record) {
+    const scope = record.scopeType.toUpperCase();
+    if (scope === 'AD' && record.availabilityDomain !== null) {
+        return { service, name: record.name, scope: 'zone', zone: record.availabilityDomain, value: record.value };
+    }
+    return { service, name: record.name, scope: scope === 'GLOBAL' ? 'global' : 'region', value: record.value };
+}
+/** A shape record as a shape. */
+export function shape_ofRecord(record) {
+    const terms = shapeTerms_get(record.shape);
+    const cores = record.isFlexible && record.ocpuOptions !== null
+        ? { min: record.ocpuOptions.min * terms.vcpuPerOcpu, max: record.ocpuOptions.max * terms.vcpuPerOcpu }
+        : { min: (record.ocpus ?? 0) * terms.vcpuPerOcpu, max: (record.ocpus ?? 0) * terms.vcpuPerOcpu };
+    const memoryGib = record.isFlexible && record.memoryOptions !== null
+        ? { min: record.memoryOptions.minInGBs, max: record.memoryOptions.maxInGBs }
+        : { min: record.memoryInGBs ?? 0, max: record.memoryInGBs ?? 0 };
+    return {
+        name: record.shape,
+        family: terms.family,
+        flexible: record.isFlexible,
+        vcpuPerCore: terms.vcpuPerOcpu,
+        cores,
+        memoryGib,
+        processor: record.processorDescription,
+        gpus: record.gpus,
+        quotaNames: record.quotaNames,
+        raw: record.raw,
+    };
+}
+/** Oracle Cloud Infrastructure as a cloud driver. */
+export class OciDriver {
+    cloud = 'oci';
+    api;
+    fetchJson;
+    constructor(options) {
+        this.api = options.api;
+        this.fetchJson = options.fetchJson;
+    }
+    async identity_get() {
+        const credential = this.api.credential_get();
+        const [tenancy, user] = await Promise.all([
+            this.api.tenancy_get(credential.tenancyId),
+            this.api.userName_get(credential.userId),
+        ]);
+        return { user, tenancy: tenancy.name, tenancyId: tenancy.id, homeRegion: credential.region };
+    }
+    async root_get() {
+        return container_ofTenancy(await this.api.tenancy_get(this.api.credential_get().tenancyId));
+    }
+    async containers_list(parentId) {
+        const records = await this.api.compartments_list(parentId);
+        return records
+            .filter((record) => record.lifecycleState.toUpperCase() !== 'DELETED')
+            .map(container_ofCompartment)
+            .sort((a, b) => a.name.localeCompare(b.name));
+    }
+    async regions_list() {
+        return this.api.regionSubscriptions_list(this.api.credential_get().tenancyId);
+    }
+    async zones_list(region) {
+        const names = await this.api.availabilityDomains_list(region, this.api.credential_get().tenancyId);
+        return names.map((name) => ({ name }));
+    }
+    async limitServices_list(region) {
+        return this.api.limitServices_list(region, this.api.credential_get().tenancyId);
+    }
+    async limits_list(region, service) {
+        const records = await this.api.limitValues_list(region, this.api.credential_get().tenancyId, service);
+        return records.map((record) => limit_ofValue(service, record));
+    }
+    async limitAvailability_get(region, service, name, zone) {
+        return this.api.resourceAvailability_get(region, this.api.credential_get().tenancyId, service, name, zone);
+    }
+    async shapes_list(region) {
+        const records = await this.api.shapes_list(region, this.api.credential_get().tenancyId);
+        const seen = new Set();
+        const shapes = [];
+        for (const record of records) {
+            if (seen.has(record.shape))
+                continue;
+            seen.add(record.shape);
+            shapes.push(shape_ofRecord(record));
+        }
+        return shapes.sort((a, b) => a.name.localeCompare(b.name));
+    }
+    async prices_list() {
+        return ociPrices_read(this.fetchJson);
+    }
+}
+//# sourceMappingURL=driver.js.map

package/dist/cloud/oci/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../src/cloud/oci/driver.ts"],"names":[],"mappings":"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"}

package/dist/cloud/oci/prices.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @file Oracle's public price list, read into prices per shape.
+ *
+ * Ported from `harbor-oci`'s `ocipricing.py`: the list is fetched once from
+ * Oracle's public API, pay-as-you-go prices are indexed by part number, and
+ * each flexible shape's family maps to its core and memory parts. OCI bills
+ * an OCPU, which is two vCPU on x86 and the newer Ampere shapes and one on
+ * the A1, so the vCPU price is the OCPU price over that ratio. List prices
+ * only; a tenancy's commitment discount is not applied.
+ *
+ * @module
+ */
+import type { CloudPrice } from '../driver.js';
+/** Where Oracle publishes its prices. */
+export declare const PRICE_LIST_URL: string;
+/** What the shape list does not say about a flexible shape. */
+export interface ShapeTerms {
+    /** A neutral family name. */
+    readonly family: string;
+    /** vCPU per OCPU. */
+    readonly vcpuPerOcpu: number;
+    /** The price-list part number for an OCPU-hour. */
+    readonly ocpuPart: string;
+    /** The price-list part number for a GB-hour of memory. */
+    readonly memoryPart: string;
+}
+/** The flexible shapes and their terms, as `harbor-oci` tabled them. */
+export declare const SHAPE_TERMS: Readonly<Record<string, ShapeTerms>>;
+/**
+ * A neutral family name for a shape the table does not know: the shape
+ * without `VM.`, `Standard.` and `.Flex` (`VM.Standard.X9.Flex` is `X9`).
+ */
+export declare function familyName_derive(shape: string): string;
+/** The terms for a shape: the table's, or derived with two vCPU per OCPU and no parts. */
+export declare function shapeTerms_get(shape: string): ShapeTerms;
+/** One product as the price list writes it; only what is read is typed. */
+interface PriceListItem {
+    readonly partNumber?: string;
+    readonly currencyCodeLocalizations?: ReadonlyArray<{
+        readonly currencyCode?: string;
+        readonly prices?: ReadonlyArray<{
+            readonly model?: string;
+            readonly value?: number | string;
+        }>;
+    }>;
+}
+/**
+ * The paid pay-as-you-go price per part number, in the currency read; the
+ * highest tier for tiered parts, as `harbor-oci` reads it.
+ *
+ * @param items - The `items` of the price list reply.
+ * @returns USD per the part's own metric.
+ */
+export declare function partPrices_index(items: ReadonlyArray<PriceListItem>): Map<string, number>;
+/**
+ * Prices per shape from part prices: the shapes whose parts the list holds.
+ *
+ * @param parts - Price per part number.
+ * @returns A price per shape, sorted by shape name.
+ */
+export declare function shapePrices_map(parts: ReadonlyMap<string, number>): CloudPrice[];
+/** Fetches a URL as JSON; injected so a test needs no network. */
+export type JsonFetch = (url: string) => Promise<unknown>;
+/** The default fetch: Node's, thirty seconds. */
+export declare const jsonFetch_default: JsonFetch;
+/**
+ * Oracle's list prices for the flexible shapes, per hour.
+ *
+ * @param fetchJson - How the list is fetched.
+ * @returns A price per shape the list prices.
+ */
+export declare function ociPrices_read(fetchJson?: JsonFetch): Promise<CloudPrice[]>;
+export {};

package/dist/cloud/oci/prices.js

@@ -0,0 +1,105 @@
+/** Where Oracle publishes its prices. */
+export const PRICE_LIST_URL = 'https://apexapps.oracle.com/pls/apex/cetools/api/v1/products/';
+/** The price model read: paid, hourly. */
+const PRICE_MODEL = 'PAY_AS_YOU_GO';
+/** The currency read. */
+const PRICE_CURRENCY = 'USD';
+/** The flexible shapes and their terms, as `harbor-oci` tabled them. */
+export const SHAPE_TERMS = {
+    'VM.Standard.E3.Flex': { family: 'E3', vcpuPerOcpu: 2, ocpuPart: 'B92306', memoryPart: 'B92307' },
+    'VM.Standard.E4.Flex': { family: 'E4', vcpuPerOcpu: 2, ocpuPart: 'B93113', memoryPart: 'B93114' },
+    'VM.Standard.E5.Flex': { family: 'E5', vcpuPerOcpu: 2, ocpuPart: 'B97384', memoryPart: 'B97385' },
+    'VM.Standard.E6.Flex': { family: 'E6', vcpuPerOcpu: 2, ocpuPart: 'B111129', memoryPart: 'B111130' },
+    'VM.Standard.E6.Ax.Flex': { family: 'E6.Ax', vcpuPerOcpu: 2, ocpuPart: 'B112530', memoryPart: 'B112531' },
+    'VM.Standard.A1.Flex': { family: 'A1', vcpuPerOcpu: 1, ocpuPart: 'B93297', memoryPart: 'B93298' },
+    'VM.Standard.A2.Flex': { family: 'A2', vcpuPerOcpu: 2, ocpuPart: 'B109529', memoryPart: 'B109530' },
+    'VM.Standard.A4.Flex': { family: 'A4', vcpuPerOcpu: 2, ocpuPart: 'B112145', memoryPart: 'B112146' },
+    'VM.Standard.A4.Ax.Flex': { family: 'A4.Ax', vcpuPerOcpu: 2, ocpuPart: 'B112532', memoryPart: 'B112533' },
+    'VM.Standard3.Flex': { family: 'Standard3', vcpuPerOcpu: 2, ocpuPart: 'B94176', memoryPart: 'B94177' },
+    'VM.Standard4.Ax.Flex': { family: 'Standard4.Ax', vcpuPerOcpu: 2, ocpuPart: 'B112141', memoryPart: 'B112142' },
+    'VM.Optimized3.Flex': { family: 'Optimized3', vcpuPerOcpu: 2, ocpuPart: 'B93311', memoryPart: 'B93312' },
+    'VM.DenseIO.E4.Flex': { family: 'DenseIO.E4', vcpuPerOcpu: 2, ocpuPart: 'B93121', memoryPart: 'B93122' },
+    'VM.DenseIO.E5.Flex': { family: 'DenseIO.E5', vcpuPerOcpu: 2, ocpuPart: 'B98202', memoryPart: 'B98203' },
+    'VM.DenseIO.E6.Ax.Flex': { family: 'DenseIO.E6.Ax', vcpuPerOcpu: 2, ocpuPart: 'B112556', memoryPart: 'B112557' },
+};
+/**
+ * A neutral family name for a shape the table does not know: the shape
+ * without `VM.`, `Standard.` and `.Flex` (`VM.Standard.X9.Flex` is `X9`).
+ */
+export function familyName_derive(shape) {
+    let name = shape;
+    if (name.startsWith('VM.'))
+        name = name.slice(3);
+    if (name.endsWith('.Flex'))
+        name = name.slice(0, -5);
+    if (name.startsWith('Standard.'))
+        name = name.slice(9);
+    return name;
+}
+/** The terms for a shape: the table's, or derived with two vCPU per OCPU and no parts. */
+export function shapeTerms_get(shape) {
+    return SHAPE_TERMS[shape] ?? { family: familyName_derive(shape), vcpuPerOcpu: 2, ocpuPart: '', memoryPart: '' };
+}
+/**
+ * The paid pay-as-you-go price per part number, in the currency read; the
+ * highest tier for tiered parts, as `harbor-oci` reads it.
+ *
+ * @param items - The `items` of the price list reply.
+ * @returns USD per the part's own metric.
+ */
+export function partPrices_index(items) {
+    const index = new Map();
+    for (const item of items) {
+        if (item.partNumber === undefined)
+            continue;
+        for (const localization of item.currencyCodeLocalizations ?? []) {
+            if (localization.currencyCode !== undefined && localization.currencyCode !== PRICE_CURRENCY)
+                continue;
+            const values = (localization.prices ?? [])
+                .filter((price) => price.model === PRICE_MODEL)
+                .map((price) => Number(price.value))
+                .filter((value) => Number.isFinite(value));
+            if (values.length > 0)
+                index.set(item.partNumber, Math.max(...values));
+        }
+    }
+    return index;
+}
+/**
+ * Prices per shape from part prices: the shapes whose parts the list holds.
+ *
+ * @param parts - Price per part number.
+ * @returns A price per shape, sorted by shape name.
+ */
+export function shapePrices_map(parts) {
+    const prices = [];
+    for (const [shape, terms] of Object.entries(SHAPE_TERMS)) {
+        const ocpu = parts.get(terms.ocpuPart);
+        const memory = parts.get(terms.memoryPart);
+        if (ocpu === undefined || memory === undefined)
+            continue;
+        prices.push({ shape, vcpuHour: ocpu / terms.vcpuPerOcpu, gibHour: memory, currency: PRICE_CURRENCY });
+    }
+    return prices.sort((a, b) => a.shape.localeCompare(b.shape));
+}
+/** The default fetch: Node's, thirty seconds. */
+export const jsonFetch_default = async (url) => {
+    const response = await fetch(url, { signal: AbortSignal.timeout(30_000) });
+    if (!response.ok)
+        throw new Error(`price list: ${response.status} ${response.statusText}`);
+    return response.json();
+};
+/**
+ * Oracle's list prices for the flexible shapes, per hour.
+ *
+ * @param fetchJson - How the list is fetched.
+ * @returns A price per shape the list prices.
+ */
+export async function ociPrices_read(fetchJson = jsonFetch_default) {
+    const reply = await fetchJson(PRICE_LIST_URL);
+    const items = typeof reply === 'object' && reply !== null ? reply.items : undefined;
+    if (!Array.isArray(items))
+        throw new Error('price list: no items in the reply');
+    return shapePrices_map(partPrices_index(items));
+}
+//# sourceMappingURL=prices.js.map