@fnndsc/stratus 0.0.0-stage → 0.1.0

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

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @file `@fnndsc/stratus`: a mise session over the cloud substrate a Trusted
+ * Domain runs on. One backend, clouds as drivers, OCI first
+ * (docs/stratus.adoc).
+ *
+ * @module
+ */
+export * from './cloud/driver.js';
+export { FakeDriver, fakeCloud_sample, availabilityKey_make, type FakeCloud } from './cloud/fake/driver.js';
+export { OciDriver, ociTags_flatten, shape_ofRecord, type OciDriverOptions } from './cloud/oci/driver.js';
+export { ociApi_make, type OciApi, type OciApiOptions, type OciCompartmentRecord, type OciLimitValueRecord, type OciShapeRecord, type OciTenancyRecord } from './cloud/oci/api.js';
+export { SHAPE_TERMS, familyName_derive, shapeTerms_get, partPrices_index, shapePrices_map, ociPrices_read, PRICE_LIST_URL, type ShapeTerms, type JsonFetch } from './cloud/oci/prices.js';
+export { TenancyProvider, TENANCY_RESERVED, CONTAINER_RESERVED, READ_ONLY_REASON, type TenancyProviderOptions } from './vfs/tenancy.js';
+export { stratusListingLook, stratusName_colorize, STRATUS_ITEM_KINDS, CONTAINER_TYPES } from './vfs/look.js';
+export { StratusSession, configDir_default, type StratusSessionOptions } from './session.js';
+export { stratusBackend_make, type StratusBackend, type StratusBackendOptions } from './backend.js';
+export { AnswerCache } from './cache.js';
+export { segments_assign, segment_resolve, idSuffix_of, ambiguity_words, type Named, type Segment, type SegmentMatch } from './names.js';
+export { stratusArgs_parse, type StratusArgs } from './args.js';

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * @file `@fnndsc/stratus`: a mise session over the cloud substrate a Trusted
+ * Domain runs on. One backend, clouds as drivers, OCI first
+ * (docs/stratus.adoc).
+ *
+ * @module
+ */
+export * from './cloud/driver.js';
+export { FakeDriver, fakeCloud_sample, availabilityKey_make } from './cloud/fake/driver.js';
+export { OciDriver, ociTags_flatten, shape_ofRecord } from './cloud/oci/driver.js';
+export { ociApi_make } from './cloud/oci/api.js';
+export { SHAPE_TERMS, familyName_derive, shapeTerms_get, partPrices_index, shapePrices_map, ociPrices_read, PRICE_LIST_URL } from './cloud/oci/prices.js';
+export { TenancyProvider, TENANCY_RESERVED, CONTAINER_RESERVED, READ_ONLY_REASON } from './vfs/tenancy.js';
+export { stratusListingLook, stratusName_colorize, STRATUS_ITEM_KINDS, CONTAINER_TYPES } from './vfs/look.js';
+export { StratusSession, configDir_default } from './session.js';
+export { stratusBackend_make } from './backend.js';
+export { AnswerCache } from './cache.js';
+export { segments_assign, segment_resolve, idSuffix_of, ambiguity_words } from './names.js';
+export { stratusArgs_parse } from './args.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,oBAAoB,EAAkB,MAAM,wBAAwB,CAAC;AAC5G,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAyB,MAAM,uBAAuB,CAAC;AAC1G,OAAO,EAAE,WAAW,EAAoI,MAAM,oBAAoB,CAAC;AACnL,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAmC,MAAM,uBAAuB,CAAC;AAC3L,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAA+B,MAAM,kBAAkB,CAAC;AACxI,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC9G,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAA8B,MAAM,cAAc,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAmD,MAAM,cAAc,CAAC;AACpG,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAA+C,MAAM,YAAY,CAAC;AACzI,OAAO,EAAE,iBAAiB,EAAoB,MAAM,WAAW,CAAC"}

package/dist/names.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @file Names in paths: display names, never ids, and what happens when two
+ * share one (docs/stratus.adoc, D4).
+ *
+ * A duplicate shows as `name~<last six of its id>`; the plain name refuses
+ * as ambiguous, never picks one. The rule holds wherever a path is resolved.
+ *
+ * @module
+ */
+/** Something with a display name and an id. */
+export interface Named {
+    readonly name: string;
+    readonly id: string;
+}
+/** A path segment and the thing it names. */
+export interface Segment<T extends Named> {
+    readonly segment: string;
+    readonly item: T;
+}
+/** The suffix a duplicate wears: the last six characters of its id. */
+export declare function idSuffix_of(id: string): string;
+/**
+ * The path segment for each item: its name, or `name~<id6>` when another
+ * item in the same listing has the same name.
+ *
+ * @param items - The listing.
+ * @returns A segment per item, in the same order.
+ */
+export declare function segments_assign<T extends Named>(items: ReadonlyArray<T>): Segment<T>[];
+/** What resolving a segment came to. */
+export type SegmentMatch<T extends Named> = {
+    readonly kind: 'one';
+    readonly item: T;
+} | {
+    readonly kind: 'none';
+} | {
+    readonly kind: 'ambiguous';
+    readonly segments: string[];
+};
+/**
+ * The item a path segment names: the plain name when one item has it, the
+ * suffixed form when several do, and a refusal naming every suffixed form
+ * when the plain name is asked for a duplicate.
+ *
+ * @param items - The listing the segment is resolved in.
+ * @param segment - The segment as typed.
+ * @returns The match.
+ */
+export declare function segment_resolve<T extends Named>(items: ReadonlyArray<T>, segment: string): SegmentMatch<T>;
+/** The words a refusal of an ambiguous name uses. */
+export declare function ambiguity_words(segment: string, segments: ReadonlyArray<string>): string;

package/dist/names.js

@@ -0,0 +1,53 @@
+/**
+ * @file Names in paths: display names, never ids, and what happens when two
+ * share one (docs/stratus.adoc, D4).
+ *
+ * A duplicate shows as `name~<last six of its id>`; the plain name refuses
+ * as ambiguous, never picks one. The rule holds wherever a path is resolved.
+ *
+ * @module
+ */
+/** The suffix a duplicate wears: the last six characters of its id. */
+export function idSuffix_of(id) {
+    return id.slice(-6);
+}
+/**
+ * The path segment for each item: its name, or `name~<id6>` when another
+ * item in the same listing has the same name.
+ *
+ * @param items - The listing.
+ * @returns A segment per item, in the same order.
+ */
+export function segments_assign(items) {
+    const counts = new Map();
+    for (const item of items)
+        counts.set(item.name, (counts.get(item.name) ?? 0) + 1);
+    return items.map((item) => ({
+        segment: (counts.get(item.name) ?? 0) > 1 ? `${item.name}~${idSuffix_of(item.id)}` : item.name,
+        item,
+    }));
+}
+/**
+ * The item a path segment names: the plain name when one item has it, the
+ * suffixed form when several do, and a refusal naming every suffixed form
+ * when the plain name is asked for a duplicate.
+ *
+ * @param items - The listing the segment is resolved in.
+ * @param segment - The segment as typed.
+ * @returns The match.
+ */
+export function segment_resolve(items, segment) {
+    const assigned = segments_assign(items);
+    const exact = assigned.find((entry) => entry.segment === segment);
+    if (exact !== undefined)
+        return { kind: 'one', item: exact.item };
+    const sameName = assigned.filter((entry) => entry.item.name === segment);
+    if (sameName.length === 0)
+        return { kind: 'none' };
+    return { kind: 'ambiguous', segments: sameName.map((entry) => entry.segment) };
+}
+/** The words a refusal of an ambiguous name uses. */
+export function ambiguity_words(segment, segments) {
+    return `${segment}: ambiguous: ${segments.join(', ')}`;
+}
+//# sourceMappingURL=names.js.map

package/dist/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../src/names.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,uEAAuE;AACvE,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACtB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAkB,KAAuB;IACtE,MAAM,MAAM,GAAwB,IAAI,GAAG,EAAE,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAO,EAAc,EAAE,CAAC,CAAC;QACzC,OAAO,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;QAC9F,IAAI;KACL,CAAC,CAAC,CAAC;AACN,CAAC;AAQD;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAkB,KAAuB,EAAE,OAAe;IACvF,MAAM,QAAQ,GAAiB,eAAe,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,KAAK,GAA2B,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAiB,EAAW,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IAC/G,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IAClE,MAAM,QAAQ,GAAiB,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAiB,EAAW,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAC5G,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACnD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAiB,EAAU,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;AACrG,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,QAA+B;IAC9E,OAAO,GAAG,OAAO,gBAAgB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACzD,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,48 @@
+import type { BackendSession, SessionIdentity } from '@fnndsc/brasa/core';
+import type { CloudDriver, CloudIdentity } from './cloud/driver.js';
+/** Where mise keeps a user's configuration. */
+export declare function configDir_default(env?: NodeJS.ProcessEnv): string;
+/** How a session is made. */
+export interface StratusSessionOptions {
+    readonly driver: CloudDriver;
+    /** The region the session works in; the credential's home region when absent. */
+    readonly region?: string;
+    /** Where the working directory is kept; the user's configuration directory when absent. */
+    readonly configDir?: string;
+}
+/** The session over a cloud. */
+export declare class StratusSession implements BackendSession {
+    private readonly driver;
+    private readonly configDir;
+    private readonly regionAsked;
+    private cloudIdentity;
+    private failure;
+    private cwd;
+    private regionCurrent;
+    constructor(options: StratusSessionOptions);
+    /** The cloud's short name. */
+    get cloud(): string;
+    /** Why the session is not connected, or null when it is. */
+    get disconnectedReason(): string | null;
+    /** The cloud identity, or null when not connected. */
+    get identity(): CloudIdentity | null;
+    /** The session's region, or null when not connected and none was asked. */
+    get region(): string | null;
+    /** Changes the session's region. */
+    region_set(region: string): void;
+    /** The mount the tenancy lives under. */
+    get mount(): string;
+    /** The tenancy's folder, or the mount when not connected. */
+    get tenancyPath(): string;
+    init(): Promise<void>;
+    identity_get(): Promise<SessionIdentity>;
+    user_get(): Promise<string | null>;
+    home_get(): Promise<string>;
+    cwd_load(): Promise<string | null>;
+    cwd_save(cwd: string): Promise<void>;
+    /** The working directory as it stands, for the prompt. */
+    cwd_get(): string | null;
+    /** The file the working directory is kept in, or null when not connected. */
+    private cwdFile_get;
+    private cwd_read;
+}

package/dist/session.js

@@ -0,0 +1,128 @@
+/**
+ * @file The stratus session: who it is, where it starts, where it left off.
+ *
+ * The identity is the cloud user at the tenancy (`rudolph@fnndsc`), the
+ * berth a daemon advertises; disconnected, it is `disconnected@<cloud>`, so
+ * two disconnected substrate daemons never share a name with each other or
+ * with a ChRIS one. Home is the tenancy's `domains/`. The working directory
+ * is kept per identity under the user's configuration directory, so a
+ * restarted daemon stands where it stood. The region is the session's
+ * (docs/stratus.adoc, D4 and D8).
+ *
+ * @module
+ */
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import path from 'node:path';
+/** Where mise keeps a user's configuration. */
+export function configDir_default(env = process.env) {
+    return path.join(env['XDG_CONFIG_HOME'] ?? path.join(homedir(), '.config'), 'mise', 'stratus');
+}
+/** The session over a cloud. */
+export class StratusSession {
+    driver;
+    configDir;
+    regionAsked;
+    cloudIdentity = null;
+    failure = null;
+    cwd = null;
+    regionCurrent = null;
+    constructor(options) {
+        this.driver = options.driver;
+        this.configDir = options.configDir ?? configDir_default();
+        this.regionAsked = options.region;
+    }
+    /** The cloud's short name. */
+    get cloud() {
+        return this.driver.cloud;
+    }
+    /** Why the session is not connected, or null when it is. */
+    get disconnectedReason() {
+        return this.failure;
+    }
+    /** The cloud identity, or null when not connected. */
+    get identity() {
+        return this.cloudIdentity;
+    }
+    /** The session's region, or null when not connected and none was asked. */
+    get region() {
+        return this.regionCurrent ?? this.regionAsked ?? null;
+    }
+    /** Changes the session's region. */
+    region_set(region) {
+        this.regionCurrent = region;
+    }
+    /** The mount the tenancy lives under. */
+    get mount() {
+        return `/net/${this.driver.cloud}`;
+    }
+    /** The tenancy's folder, or the mount when not connected. */
+    get tenancyPath() {
+        return this.cloudIdentity === null ? this.mount : `${this.mount}/${this.cloudIdentity.tenancy}`;
+    }
+    async init() {
+        try {
+            this.cloudIdentity = await this.driver.identity_get();
+            this.failure = null;
+            if (this.regionCurrent === null)
+                this.regionCurrent = this.regionAsked ?? this.cloudIdentity.homeRegion;
+        }
+        catch (error) {
+            this.cloudIdentity = null;
+            this.failure = error instanceof Error ? error.message : String(error);
+        }
+        this.cwd = this.cwd_read();
+    }
+    async identity_get() {
+        if (this.cloudIdentity === null)
+            return { user: 'disconnected', where: this.driver.cloud, connected: false };
+        return { user: this.cloudIdentity.user, where: this.cloudIdentity.tenancy, connected: true };
+    }
+    async user_get() {
+        return this.cloudIdentity?.user ?? null;
+    }
+    async home_get() {
+        return this.cloudIdentity === null ? this.mount : `${this.tenancyPath}/domains`;
+    }
+    async cwd_load() {
+        return this.cwd;
+    }
+    async cwd_save(cwd) {
+        this.cwd = cwd;
+        const file = this.cwdFile_get();
+        if (file === null)
+            return;
+        try {
+            mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
+            writeFileSync(file, `${cwd}\n`, { mode: 0o600 });
+        }
+        catch {
+            // Deliberate absorption: a working directory that cannot be kept is
+            // still the working directory; the next start begins at home.
+        }
+    }
+    /** The working directory as it stands, for the prompt. */
+    cwd_get() {
+        return this.cwd;
+    }
+    /** The file the working directory is kept in, or null when not connected. */
+    cwdFile_get() {
+        if (this.cloudIdentity === null)
+            return null;
+        const berth = `${this.cloudIdentity.user}@${this.cloudIdentity.tenancy}`.replace(/[^A-Za-z0-9@._-]/g, '_');
+        return path.join(this.configDir, berth, 'cwd');
+    }
+    cwd_read() {
+        const file = this.cwdFile_get();
+        if (file === null)
+            return null;
+        try {
+            const text = readFileSync(file, 'utf-8').trim();
+            return text === '' ? null : text;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/stratus.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/stratus.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+/**
+ * @file The `stratus` command: hosts a substrate session as a calypso daemon.
+ *
+ * stratus ships its own launcher (docs/stratus.adoc, D2): it composes the
+ * engine with the stratus backend over the OCI driver and hands it to
+ * calypso's `daemon_launch`; calypso itself knows nothing of stratus. The
+ * daemon runs on the bastion, the host that holds the cloud credential.
+ *
+ * Usage:
+ *   stratus [--profile NAME] [--config FILE] [--region REGION]
+ *           [--host-control[=TIERS]] [--expose-host-control]
+ *   stratus --fake            a session over the fake cloud, for tests
+ *
+ * @module
+ */
+import { realpathSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { engine_create } from '@fnndsc/brasa/core';
+import { daemon_launch, daemonConsole_run, hostControl_parseArgv, packageWebRoot_find } from '@fnndsc/calypso';
+import { stratusBackend_make } from './backend.js';
+import { FakeDriver, fakeCloud_sample } from './cloud/fake/driver.js';
+import { OciDriver } from './cloud/oci/driver.js';
+import { ociApi_make } from './cloud/oci/api.js';
+import { stratusArgs_parse } from './args.js';
+const USAGE = [
+    'stratus: a mise session over the cloud substrate a Trusted Domain runs on.',
+    '',
+    'Usage: stratus [--profile NAME] [--config FILE] [--region REGION]',
+    '               [--host-control[=shell,files,pipes]] [--expose-host-control]',
+    '       stratus --fake',
+    '',
+    '  --profile NAME   the ~/.oci/config profile (DEFAULT)',
+    '  --config FILE    the OCI configuration file (~/.oci/config)',
+    '  --region REGION  the region the session works in (the profile\'s)',
+    '  --fake           host a session over the fake cloud, for tests',
+].join('\n');
+/**
+ * Hosts the daemon.
+ */
+async function stratus_start() {
+    const parsed = stratusArgs_parse(process.argv.slice(2));
+    if ('error' in parsed) {
+        console.error(`[!] ${parsed.error}`);
+        process.exit(1);
+    }
+    if (parsed.args.help) {
+        console.log(USAGE);
+        return;
+    }
+    const driver = parsed.args.fake
+        ? new FakeDriver(fakeCloud_sample())
+        : new OciDriver({ api: ociApi_make({ configFile: parsed.args.configFile, profile: parsed.args.profile }) });
+    const made = stratusBackend_make({ driver, region: parsed.args.region });
+    const engine = await engine_create(made.backend);
+    if (made.session.identity === null) {
+        console.error(`[!] Not connected to ${driver.cloud}: ${made.session.disconnectedReason ?? 'no credential'}; hosting offline.`);
+    }
+    else {
+        console.error(`[+] ${made.session.identity.user}@${made.session.identity.tenancy} on ${driver.cloud}, region ${made.session.region}.`);
+    }
+    const parsedPolicy = hostControl_parseArgv(process.argv, process.env);
+    if ('error' in parsedPolicy) {
+        console.error(`[!] ${parsedPolicy.error}`);
+        process.exit(1);
+    }
+    const policy = parsedPolicy.policy;
+    const info = await daemon_launch(engine, undefined, {
+        hostControl: policy,
+        webRoot: packageWebRoot_find('@fnndsc/argus'),
+    });
+    if (process.stdin.isTTY === true && process.stdout.isTTY === true) {
+        await daemonConsole_run({ identity: info.identity, url: info.url, token: info.token });
+    }
+}
+const currentFile = fileURLToPath(import.meta.url);
+let isMain = false;
+try {
+    isMain = realpathSync(process.argv[1]) === realpathSync(currentFile);
+}
+catch {
+    // Not invoked as a script.
+}
+if (isMain) {
+    stratus_start().catch((error) => {
+        console.error(`[!] stratus: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=stratus.js.map

package/dist/stratus.js.map

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

package/dist/vfs/look.d.ts

@@ -0,0 +1,9 @@
+import { type ItemKindLook, type ListingLook } from '@fnndsc/fond';
+/** The container nouns every cloud maps onto (docs/stratus.adoc, D4). */
+export declare const CONTAINER_TYPES: ReadonlyArray<string>;
+/** The kinds stratus lists beside the core's. */
+export declare const STRATUS_ITEM_KINDS: ReadonlyArray<ItemKindLook>;
+/** Colours a name by the item's kind and state. */
+export declare function stratusName_colorize(name: string, type: string, status?: string): string;
+/** The look of a stratus listing. */
+export declare const stratusListingLook: ListingLook;

package/dist/vfs/look.js

@@ -0,0 +1,60 @@
+/**
+ * @file How a stratus listing shows: its item kinds and the colour of a name.
+ *
+ * Every row is a folder or a file to the shell (docs/stratus.adoc, D5); the
+ * kind is how `ls -l` draws it: the container nouns, the resource kinds, the
+ * facts under `regions/`. A name is coloured by its kind and, where the item
+ * carries one, its lifecycle state: running green, stopped dim, provisioning
+ * amber, failed red, as jobs are by status.
+ *
+ * @module
+ */
+import chalk from 'chalk';
+import { LISTING_CORE_KINDS } from '@fnndsc/fond';
+/** The container nouns every cloud maps onto (docs/stratus.adoc, D4). */
+export const CONTAINER_TYPES = ['tenancy', 'compartment', 'account', 'organization', 'project', 'folder', 'subscription', 'resourcegroup', 'managementgroup'];
+/** The kinds stratus lists beside the core's. */
+export const STRATUS_ITEM_KINDS = [
+    ...CONTAINER_TYPES.map((type) => ({ type, mark: 'c', container: true, sizeColumn: state_column })),
+    { type: 'region', mark: 'r', container: true },
+    { type: 'zone', mark: 'z', container: true },
+    { type: 'service', mark: 'd', container: true },
+    { type: 'limit', mark: 'L', container: true },
+    { type: 'shape', mark: 's', container: true },
+    { type: 'price', mark: '$', container: true },
+    { type: 'domain', mark: 'D', container: true, sizeColumn: state_column },
+];
+/** The long view's size column for an item with a state: the state. */
+function state_column(item) {
+    return item.status !== undefined && item.status !== '' ? item.status : null;
+}
+/** States and the tone each is drawn in. */
+const STATE_TONES = [
+    { matches: /^(running|active|available|attached|ready|done)$/, paint: chalk.green },
+    { matches: /^(stopped|inactive|terminated|deleted|detached)$/, paint: chalk.dim },
+    { matches: /^(provisioning|creating|starting|stopping|updating|deleting|terminating|moving|queued|pending)$/, paint: chalk.yellow },
+    { matches: /^(failed|faulted|error|unknown_value)$/, paint: chalk.red },
+];
+/** Colours a name by the item's kind and state. */
+export function stratusName_colorize(name, type, status) {
+    if (status !== undefined) {
+        const tone = STATE_TONES.find((entry) => entry.matches.test(status.toLowerCase()));
+        if (tone !== undefined)
+            return tone.paint(name);
+    }
+    if (CONTAINER_TYPES.includes(type) || type === 'dir')
+        return chalk.blue(name);
+    if (type === 'region' || type === 'zone')
+        return chalk.cyan(name);
+    if (type === 'domain')
+        return chalk.magenta(name);
+    if (type === 'shape' || type === 'price' || type === 'limit' || type === 'service')
+        return chalk.white(name);
+    return name;
+}
+/** The look of a stratus listing. */
+export const stratusListingLook = {
+    kinds: [...LISTING_CORE_KINDS, ...STRATUS_ITEM_KINDS],
+    name_colorize: (name, type) => stratusName_colorize(name, type),
+};
+//# sourceMappingURL=look.js.map

package/dist/vfs/look.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"look.js","sourceRoot":"","sources":["../../src/vfs/look.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAqD,MAAM,cAAc,CAAC;AAErG,yEAAyE;AACzE,MAAM,CAAC,MAAM,eAAe,GAA0B,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,CAAC,CAAC;AAErL,iDAAiD;AACjD,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,IAAY,EAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,CAAC;IACxH,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE;IAC9C,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE;IAC5C,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE;IAC/C,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE;IAC7C,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE;IAC7C,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE;IAC7C,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE;CACzE,CAAC;AAEF,uEAAuE;AACvE,SAAS,YAAY,CAAC,IAAa;IACjC,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9E,CAAC;AAED,4CAA4C;AAC5C,MAAM,WAAW,GAA0F;IACzG,EAAE,OAAO,EAAE,kDAAkD,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;IACnF,EAAE,OAAO,EAAE,kDAAkD,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE;IACjF,EAAE,OAAO,EAAE,iGAAiG,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE;IACnI,EAAE,OAAO,EAAE,wCAAwC,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE;CACxE,CAAC;AAEF,mDAAmD;AACnD,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,IAAY,EAAE,MAAe;IAC9E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,EAAW,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAC5F,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9E,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7G,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAgB;IAC7C,KAAK,EAAE,CAAC,GAAG,kBAAkB,EAAE,GAAG,kBAAkB,CAAC;IACrD,aAAa,EAAE,CAAC,IAAY,EAAE,IAAY,EAAU,EAAE,CAAC,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC;CACxF,CAAC"}

package/dist/vfs/tenancy.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @file The tenancy as a tree: `/net/<cloud>/<tenancy>/…` (docs/stratus.adoc, D4).
+ *
+ * A fond provider over the cloud driver. Under the mount: the tenancy by its
+ * display name; inside it, its containers (compartments) nesting as the cloud
+ * nests them, `regions/` with each region's zones, limits, shapes and prices,
+ * and `domains/`. A container lists its children and `info.json`; a fact
+ * (a limit, a shape, a price) is a folder of field files, as `/proc` does it:
+ * a field is a file when a shell line wants it, and `info.json` holds the
+ * whole record.
+ *
+ * Names in paths are display names; a duplicate wears `~<id6>` and the plain
+ * name refuses as ambiguous (`names.ts`). Kind folders and `info.json` are
+ * reserved, so a container with such a name wears the suffix too. Every
+ * answer is kept for a short life (`cache.ts`). The mount is read-only: the
+ * substrate changes through `domain` (D6).
+ *
+ * @module
+ */
+import { type CpOptions, type Result, type VFSItem, type VFSProvider, type VfsOutcome } from '@fnndsc/fond';
+import type { CloudDriver } from '../cloud/driver.js';
+import { AnswerCache } from '../cache.js';
+/** The folders a tenancy level reserves beside its containers. */
+export declare const TENANCY_RESERVED: ReadonlyArray<string>;
+/** The folders a container level reserves beside its children. */
+export declare const CONTAINER_RESERVED: ReadonlyArray<string>;
+/** The words a refusal of a write uses. */
+export declare const READ_ONLY_REASON: string;
+/** How the provider is made. */
+export interface TenancyProviderOptions {
+    readonly driver: CloudDriver;
+    /** The cache; a fresh one with a minute's life when absent. */
+    readonly cache?: AnswerCache;
+    /** The clock for item dates the cloud does not give. */
+    readonly now?: () => string;
+}
+/** The tenancy as a tree under `/net/<cloud>`. */
+export declare class TenancyProvider implements VFSProvider {
+    readonly prefix: string;
+    private readonly driver;
+    private readonly cache;
+    private readonly now;
+    constructor(options: TenancyProviderOptions);
+    /** Forgets every kept answer: the next listing asks the cloud. */
+    cache_clear(): void;
+    private identity_get;
+    private root_get;
+    private containers_list;
+    private regions_list;
+    private zones_list;
+    private services_list;
+    private limits_list;
+    private availability_get;
+    private shapes_list;
+    private prices_list;
+    /** The path's segments under the mount; null when the path is not under it. */
+    private segments_of;
+    /** Containers with their path segments: a reserved name or a duplicate wears the suffix. */
+    private containerSegments_of;
+    /** The child a segment names among containers, with the reserved rule. */
+    private container_resolve;
+    /**
+     * The node a path names.
+     *
+     * @param pathStr - The absolute path.
+     * @returns The node, or `missing` with a reason to show.
+     */
+    private node_resolve;
+    /** Walks container segments from a parent. */
+    private containerNode_resolve;
+    /** Walks `regions/…`. */
+    private regionNode_resolve;
+    private zoneNode_resolve;
+    private limitNode_resolve;
+    private shapeNode_resolve;
+    private priceNode_resolve;
+    /** A field file in a folder of fields, by its remaining segments. */
+    private fieldNode_resolve;
+    /** A limit's fields: its value and scope, and what is used and left when the cloud says. */
+    private limit_fields;
+    private folder_item;
+    private file_item;
+    private container_item;
+    /** What a container level lists: its children, the reserved folders, `info.json`. */
+    private containerLevel_list;
+    /** What a node lists. */
+    private node_list;
+    list(pathStr: string): Promise<Result<VFSItem[]>>;
+    read(pathStr: string): Promise<VfsOutcome<string>>;
+    readBinary(pathStr: string): Promise<VfsOutcome<Buffer>>;
+    cp(): Promise<VfsOutcome>;
+}
+/** A `cp` the provider refuses, typed for the interface. */
+export type ReadOnlyCp = (src: string, dest: string, options: CpOptions) => Promise<VfsOutcome>;