@elaraai/e3-cloud-cli 1.0.90 → 1.0.92

package/dist/src/files-local.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { ArrayType, DictType, OptionType, StringType, StructType, type ValueTypeOf } from '@elaraai/east';
+import { type FilesBinding, type FilesManifest, type FilesProblem, type FilesStatus, type FilesSyncReport } from '@elaraai/e3-cloud-types';
+import { type FilesLedger, type FilesReader } from '@elaraai/e3-cloud-files/sync';
+/** What a local repository keeps of one workspace's Files. */
+export declare const LocalFilesStateType: StructType<{
+    /** The declarations deployed to the workspace */
+    readonly manifest: OptionType<StructType<{
+        readonly sources: ArrayType<StringType>;
+        readonly mappings: ArrayType<StructType<{
+            readonly input: StringType;
+            readonly source: StringType;
+            readonly shape: import("@elaraai/east").VariantType<{
+                readonly file: StructType<{
+                    readonly key: StringType;
+                }>;
+                readonly latest: StructType<{
+                    readonly prefix: StringType;
+                    readonly include: OptionType<StringType>;
+                }>;
+                readonly folder: StructType<{
+                    readonly prefix: StringType;
+                    readonly include: OptionType<StringType>;
+                }>;
+                readonly listing: StructType<{
+                    readonly prefix: StringType;
+                    readonly include: OptionType<StringType>;
+                }>;
+            }>;
+        }>>;
+    }>>;
+    /** Where each source is bound */
+    readonly bindings: ArrayType<StructType<{
+        readonly source: StringType;
+        readonly url: StringType;
+        readonly region: OptionType<StringType>;
+        readonly profile: OptionType<StringType>;
+        readonly latest: OptionType<import("@elaraai/east").IntegerType>;
+    }>>;
+    /** What each input took last, by input */
+    readonly ledgers: DictType<StringType, StructType<{
+        readonly entries: DictType<StringType, StructType<{
+            readonly etag: StringType;
+            readonly size: import("@elaraai/east").IntegerType;
+        }>>;
+        readonly value: OptionType<StringType>;
+        readonly under: OptionType<StringType>;
+    }>>;
+    /** The last sync's report; a dry run's is never kept */
+    readonly lastSync: OptionType<StructType<{
+        readonly started: import("@elaraai/east").DateTimeType;
+        readonly finished: import("@elaraai/east").DateTimeType;
+        readonly dryRun: import("@elaraai/east").BooleanType;
+        readonly mappings: ArrayType<StructType<{
+            readonly input: StringType;
+            readonly added: import("@elaraai/east").IntegerType;
+            readonly changed: import("@elaraai/east").IntegerType;
+            readonly removed: import("@elaraai/east").IntegerType;
+            readonly unchanged: import("@elaraai/east").IntegerType;
+            readonly refused: ArrayType<StructType<{
+                readonly key: StringType;
+                readonly reason: StringType;
+            }>>;
+            readonly bytes: import("@elaraai/east").IntegerType;
+            readonly updated: import("@elaraai/east").BooleanType;
+        }>>;
+    }>>;
+}>;
+export type LocalFilesState = ValueTypeOf<typeof LocalFilesStateType>;
+/**
+ * Opens a local repository, as e3's CLI does: refused when this e3 cannot
+ * read it, upgraded in place when an older release wrote it.
+ *
+ * @param repoArg - The repository's path
+ * @returns Its absolute path
+ * @throws {Error} When there is no repository there, or this e3 cannot open it
+ */
+export declare function openLocalRepository(repoArg: string): Promise<string>;
+/**
+ * Where a repository keeps a workspace's Files.
+ *
+ * @throws {Error} When the name is no workspace's
+ */
+export declare function statePath(repoPath: string, ws: string): string;
+/** What a repository keeps of a workspace's Files: nothing yet, before its first deploy. */
+export declare function readState(repoPath: string, ws: string): LocalFilesState;
+/** Keeps a workspace's Files, replacing the file whole so a reader never sees half of it. */
+export declare function writeState(repoPath: string, ws: string, state: LocalFilesState): void;
+/** The ledger over the repository's file: each write keeps what an input took the moment it is written. */
+export declare function stateLedger(repoPath: string, ws: string): FilesLedger;
+/**
+ * Reads each bound source's bucket with the developer's credentials: the
+ * binding's profile, else the SDK's usual chain (`AWS_PROFILE`, the
+ * environment, SSO). A bucket in another region than the one configured is
+ * followed there. A failure names the binding.
+ *
+ * @returns A reader for each binding, one client per profile and region
+ */
+export declare function s3Readers(): (binding: FilesBinding) => FilesReader;
+/** What a deploy of declarations did, or would do. */
+export interface LocalDeployResult {
+    /** The package the workspace runs, which the declarations were checked against */
+    readonly package: {
+        readonly name: string;
+        readonly version: string;
+    };
+    /** Why the declarations do not fit it; none when they were deployed */
+    readonly problems: readonly FilesProblem[];
+    /** The inputs whose declaration changed, which the next sync takes again whole */
+    readonly retaken: readonly string[];
+}
+/**
+ * Deploys declarations to a workspace, checked against the package it runs.
+ * An input whose declaration changed is taken again whole by the next sync.
+ *
+ * @param repoPath - The repository ({@link openLocalRepository})
+ * @param ws - The workspace
+ * @param manifest - The declarations
+ * @param options - `dryRun`: check them, and keep nothing
+ * @returns The package, every problem, and the inputs taken again
+ */
+export declare function deployLocal(repoPath: string, ws: string, manifest: FilesManifest, options?: {
+    dryRun?: boolean;
+}): Promise<LocalDeployResult>;
+/** What a bind did. */
+export interface LocalBindResult {
+    /** Why the binding does not fit the declarations; none when it was kept */
+    readonly problems: readonly FilesProblem[];
+    /** The inputs the source fills, which the next sync takes again whole when the binding moved */
+    readonly retaken: readonly string[];
+}
+/**
+ * Binds a source to where its files are, for a workspace. A binding moved to
+ * another URL has its inputs taken again whole by the next sync.
+ *
+ * @param repoPath - The repository
+ * @param ws - The workspace
+ * @param binding - The binding
+ * @returns Every problem, and the inputs taken again
+ * @throws {Error} When the workspace has no declarations deployed
+ */
+export declare function bindLocal(repoPath: string, ws: string, binding: FilesBinding): LocalBindResult;
+/** What a local sync is given. */
+export interface LocalSyncOptions {
+    /** Only these inputs; every declared input when absent */
+    readonly inputs?: readonly string[];
+    /** List what a sync would take, and take nothing */
+    readonly dryRun?: boolean;
+    /** Reads a bound source: its bucket, with the developer's credentials, when absent ({@link s3Readers}) */
+    readonly reader?: (binding: FilesBinding) => FilesReader;
+}
+/**
+ * Syncs a workspace's inputs with their sources' files. The declarations are
+ * checked again first, against the package the workspace runs now.
+ *
+ * @param repoPath - The repository
+ * @param ws - The workspace
+ * @param options - Which inputs, whether a dry run, and the reader
+ * @returns What it did, per input
+ * @throws {FilesSyncError} When the declarations no longer fit the package, or
+ *   a source is not bound, before anything is read
+ * @throws {Error} When the workspace has no declarations deployed
+ */
+export declare function syncLocal(repoPath: string, ws: string, options?: LocalSyncOptions): Promise<FilesSyncReport>;
+/**
+ * A workspace's Files: its declarations, its bindings and its last sync.
+ *
+ * @param repoPath - The repository
+ * @param ws - The workspace
+ * @returns Its status
+ */
+export declare function statusLocal(repoPath: string, ws: string): FilesStatus;
+//# sourceMappingURL=files-local.d.ts.map

package/dist/src/files-local.d.ts.map

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

package/dist/src/files-local.js

@@ -0,0 +1,258 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Files on a local repository: what `e3-cloud files` does given a
+ * repository's path.
+ *
+ * What a repository keeps of one workspace's Files is a file in the
+ * repository, `<repo>/.e3-cloud/files/<workspace>.json`: the declarations
+ * deployed to the workspace, where each source is bound, what each input
+ * took last, and the last sync's report. It belongs to the repository, never
+ * to the project, so removing the repository removes it, with the bytes the
+ * syncs took in.
+ *
+ * A sync reads each source with the developer's own cloud credentials (the
+ * binding's profile, else the SDK's usual chain) and writes the inputs
+ * through e3's own dataset writes, so the repository holds what a deployed
+ * workspace's sync would.
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { S3Client } from '@aws-sdk/client-s3';
+import { ArrayType, DictType, OptionType, StringType, StructType, decodeJSONFor, encodeJSONFor, equalFor, none, some, } from '@elaraai/east';
+import { LocalStorage, repoGet, repositoryOpen, workspaceGetPackage } from '@elaraai/e3-core';
+import { nameProblem } from '@elaraai/e3-types';
+import { FilesBindingType, FilesLedgerType, FilesManifestType, FilesMappingType, FilesSyncReportType, } from '@elaraai/e3-cloud-types';
+import { checkBindings, checkFiles, parseBucketUrl, readPackageInputs } from '@elaraai/e3-cloud-files/check';
+import { FilesSyncError, NO_LEDGER, ledgerStateOf, ledgerValueOf, syncFiles } from '@elaraai/e3-cloud-files/sync';
+import { storageWriter } from '@elaraai/e3-cloud-files/storage';
+import { s3FilesReader } from '@elaraai/e3-cloud-files/s3';
+/** What a local repository keeps of one workspace's Files. */
+export const LocalFilesStateType = StructType({
+    /** The declarations deployed to the workspace */
+    manifest: OptionType(FilesManifestType),
+    /** Where each source is bound */
+    bindings: ArrayType(FilesBindingType),
+    /** What each input took last, by input */
+    ledgers: DictType(StringType, FilesLedgerType),
+    /** The last sync's report; a dry run's is never kept */
+    lastSync: OptionType(FilesSyncReportType),
+});
+const encodeState = encodeJSONFor(LocalFilesStateType);
+const decodeState = decodeJSONFor(LocalFilesStateType);
+const sameMapping = equalFor(FilesMappingType);
+/**
+ * Opens a local repository, as e3's CLI does: refused when this e3 cannot
+ * read it, upgraded in place when an older release wrote it.
+ *
+ * @param repoArg - The repository's path
+ * @returns Its absolute path
+ * @throws {Error} When there is no repository there, or this e3 cannot open it
+ */
+export async function openLocalRepository(repoArg) {
+    const path = repoGet(resolve(repoArg));
+    await repositoryOpen(new LocalStorage(), path);
+    return path;
+}
+/**
+ * Where a repository keeps a workspace's Files.
+ *
+ * @throws {Error} When the name is no workspace's
+ */
+export function statePath(repoPath, ws) {
+    const reason = nameProblem('workspace', ws);
+    if (reason !== null)
+        throw new Error(`'${ws}' is no workspace's name: ${reason}`);
+    return join(repoPath, '.e3-cloud', 'files', `${ws}.json`);
+}
+/** What a repository keeps of a workspace's Files: nothing yet, before its first deploy. */
+export function readState(repoPath, ws) {
+    const path = statePath(repoPath, ws);
+    if (!existsSync(path))
+        return { manifest: none, bindings: [], ledgers: new Map(), lastSync: none };
+    try {
+        return decodeState(readFileSync(path));
+    }
+    catch (err) {
+        throw new Error(`${path} cannot be read (${err instanceof Error ? err.message : String(err)}): remove it, then deploy the declarations and bind the sources again`);
+    }
+}
+/** Keeps a workspace's Files, replacing the file whole so a reader never sees half of it. */
+export function writeState(repoPath, ws, state) {
+    const path = statePath(repoPath, ws);
+    mkdirSync(dirname(path), { recursive: true });
+    const partial = `${path}.${process.pid}.partial`;
+    writeFileSync(partial, encodeState(state));
+    renameSync(partial, path);
+}
+/** The ledger over the repository's file: each write keeps what an input took the moment it is written. */
+export function stateLedger(repoPath, ws) {
+    return {
+        read(input) {
+            const ledger = readState(repoPath, ws).ledgers.get(input);
+            return Promise.resolve(ledger === undefined ? NO_LEDGER : ledgerStateOf(ledger));
+        },
+        write(input, taken) {
+            const state = readState(repoPath, ws);
+            const ledgers = new Map(state.ledgers);
+            ledgers.set(input, ledgerValueOf(taken));
+            writeState(repoPath, ws, { ...state, ledgers });
+            return Promise.resolve();
+        },
+    };
+}
+/**
+ * A reader whose failures name the source, where it is bound and the profile
+ * it reads with: an expired login, a denied read or a missing bucket says
+ * which binding it was.
+ */
+function naming(reader, binding) {
+    const where = `source ${binding.source} (${binding.url}${binding.profile.type === 'some' ? `, profile ${binding.profile.value}` : ''})`;
+    const fail = (err) => {
+        throw new Error(`${where}: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    };
+    return {
+        async *list(prefix) {
+            try {
+                for await (const object of reader.list(prefix))
+                    yield object;
+            }
+            catch (err) {
+                fail(err);
+            }
+        },
+        stat: (key) => reader.stat(key).catch(fail),
+        read: (key) => reader.read(key).catch(fail),
+    };
+}
+/**
+ * Reads each bound source's bucket with the developer's credentials: the
+ * binding's profile, else the SDK's usual chain (`AWS_PROFILE`, the
+ * environment, SSO). A bucket in another region than the one configured is
+ * followed there. A failure names the binding.
+ *
+ * @returns A reader for each binding, one client per profile and region
+ */
+export function s3Readers() {
+    const clients = new Map();
+    return (binding) => {
+        const location = parseBucketUrl(binding.url);
+        if ('problem' in location)
+            throw new Error(`source ${binding.source}: '${binding.url}' ${location.problem}`);
+        const profile = binding.profile.type === 'some' ? binding.profile.value : undefined;
+        const region = binding.region.type === 'some' ? binding.region.value : (process.env.AWS_REGION ?? process.env.AWS_DEFAULT_REGION);
+        const key = `${profile ?? ''}\n${region ?? ''}`;
+        let client = clients.get(key);
+        if (client === undefined)
+            clients.set(key, client = new S3Client({ profile, region, followRegionRedirects: true }));
+        return naming(s3FilesReader(client, location), binding);
+    };
+}
+/** The package a workspace runs, and its inputs. */
+async function packageInputs(storage, repoPath, ws) {
+    const pkg = await workspaceGetPackage(storage, repoPath, ws);
+    const inputs = await readPackageInputs((hash) => storage.objects.read(repoPath, hash), pkg.hash);
+    return { pkg: { name: pkg.name, version: pkg.version }, inputs };
+}
+/**
+ * Deploys declarations to a workspace, checked against the package it runs.
+ * An input whose declaration changed is taken again whole by the next sync.
+ *
+ * @param repoPath - The repository ({@link openLocalRepository})
+ * @param ws - The workspace
+ * @param manifest - The declarations
+ * @param options - `dryRun`: check them, and keep nothing
+ * @returns The package, every problem, and the inputs taken again
+ */
+export async function deployLocal(repoPath, ws, manifest, options = {}) {
+    const storage = new LocalStorage();
+    const { pkg, inputs } = await packageInputs(storage, repoPath, ws);
+    const problems = checkFiles(manifest, inputs);
+    const state = readState(repoPath, ws);
+    const previous = state.manifest.type === 'some' ? state.manifest.value.mappings : [];
+    const retaken = [...state.ledgers.keys()].filter((input) => {
+        const was = previous.find((m) => m.input === input);
+        const now = manifest.mappings.find((m) => m.input === input);
+        return was === undefined || now === undefined || !sameMapping(was, now);
+    });
+    if (problems.length === 0 && options.dryRun !== true) {
+        const ledgers = new Map([...state.ledgers].filter(([input]) => !retaken.includes(input)));
+        writeState(repoPath, ws, { ...state, manifest: some(manifest), ledgers });
+    }
+    return { package: pkg, problems, retaken: retaken.filter((input) => manifest.mappings.some((m) => m.input === input)) };
+}
+/**
+ * Binds a source to where its files are, for a workspace. A binding moved to
+ * another URL has its inputs taken again whole by the next sync.
+ *
+ * @param repoPath - The repository
+ * @param ws - The workspace
+ * @param binding - The binding
+ * @returns Every problem, and the inputs taken again
+ * @throws {Error} When the workspace has no declarations deployed
+ */
+export function bindLocal(repoPath, ws, binding) {
+    const state = readState(repoPath, ws);
+    if (state.manifest.type === 'none')
+        throw new Error(`${ws} has no Files declarations: deploy them first (e3-cloud files deploy)`);
+    const problems = checkBindings(state.manifest.value, [binding], { local: true });
+    if (problems.length > 0)
+        return { problems, retaken: [] };
+    const previous = state.bindings.find((b) => b.source === binding.source);
+    const retaken = previous !== undefined && previous.url !== binding.url
+        ? state.manifest.value.mappings.filter((m) => m.source === binding.source && state.ledgers.has(m.input)).map((m) => m.input)
+        : [];
+    const ledgers = new Map([...state.ledgers].filter(([input]) => !retaken.includes(input)));
+    const bindings = previous === undefined ? [...state.bindings, binding] : state.bindings.map((b) => (b.source === binding.source ? binding : b));
+    writeState(repoPath, ws, { ...state, bindings, ledgers });
+    return { problems: [], retaken };
+}
+/**
+ * Syncs a workspace's inputs with their sources' files. The declarations are
+ * checked again first, against the package the workspace runs now.
+ *
+ * @param repoPath - The repository
+ * @param ws - The workspace
+ * @param options - Which inputs, whether a dry run, and the reader
+ * @returns What it did, per input
+ * @throws {FilesSyncError} When the declarations no longer fit the package, or
+ *   a source is not bound, before anything is read
+ * @throws {Error} When the workspace has no declarations deployed
+ */
+export async function syncLocal(repoPath, ws, options = {}) {
+    const storage = new LocalStorage();
+    const state = readState(repoPath, ws);
+    if (state.manifest.type === 'none')
+        throw new Error(`${ws} has no Files declarations: deploy them first (e3-cloud files deploy)`);
+    const manifest = state.manifest.value;
+    const { inputs } = await packageInputs(storage, repoPath, ws);
+    const problems = checkFiles(manifest, inputs);
+    if (problems.length > 0)
+        throw new FilesSyncError(problems);
+    const report = await syncFiles({
+        manifest,
+        bindings: state.bindings,
+        reader: options.reader ?? s3Readers(),
+        writer: storageWriter(storage, repoPath, ws),
+        ledger: stateLedger(repoPath, ws),
+        dryRun: options.dryRun,
+        inputs: options.inputs,
+    });
+    if (options.dryRun !== true)
+        writeState(repoPath, ws, { ...readState(repoPath, ws), lastSync: some(report) });
+    return report;
+}
+/**
+ * A workspace's Files: its declarations, its bindings and its last sync.
+ *
+ * @param repoPath - The repository
+ * @param ws - The workspace
+ * @returns Its status
+ */
+export function statusLocal(repoPath, ws) {
+    const { manifest, bindings, lastSync } = readState(repoPath, ws);
+    return { manifest, bindings, lastSync };
+}
+//# sourceMappingURL=files-local.js.map

package/dist/src/files-local.js.map

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

package/dist/src/files-source.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { type FilesManifest } from '@elaraai/e3-cloud-types';
+/**
+ * The declarations a source file's default export holds.
+ *
+ * @param file - The source: a module whose default export is `Files.manifest(...)`
+ * @returns The declarations
+ * @throws {Error} When the source does not bundle or run, the project has no
+ *   `@elaraai/e3-cloud-files`, or its default export is no declarations
+ */
+export declare function filesFromSource(file: string): Promise<FilesManifest>;
+//# sourceMappingURL=files-source.d.ts.map

package/dist/src/files-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files-source.d.ts","sourceRoot":"","sources":["../../src/files-source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAWhF;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAU1E"}

package/dist/src/files-source.js

@@ -0,0 +1,41 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Files' declarations from a solution's source: what `e3-cloud files deploy`
+ * deploys. The source is run as `e3-cloud app` runs an app's
+ * (`source-module.ts`), and its default export must be `Files.manifest(...)`
+ * of the project's own `@elaraai/e3-cloud-files`.
+ */
+import { decodeBeast2For, encodeBeast2For } from '@elaraai/east';
+import { FilesManifestType } from '@elaraai/e3-cloud-types';
+import { resolveSource, sourceDefaultExport } from './source-module.js';
+const encodeManifest = encodeBeast2For(FilesManifestType);
+const decodeManifest = decodeBeast2For(FilesManifestType);
+/** What a default export that is no declarations is told. */
+function notDeclarations(file) {
+    return new Error(`${file}'s default export must be Files' declarations:\n\n  export default Files.manifest([upload]);\n`);
+}
+/**
+ * The declarations a source file's default export holds.
+ *
+ * @param file - The source: a module whose default export is `Files.manifest(...)`
+ * @returns The declarations
+ * @throws {Error} When the source does not bundle or run, the project has no
+ *   `@elaraai/e3-cloud-files`, or its default export is no declarations
+ */
+export async function filesFromSource(file) {
+    const { path } = resolveSource(file, '@elaraai/e3-cloud-files', 'files are declared');
+    const exported = await sourceDefaultExport(file, path);
+    if (typeof exported !== 'object' || exported === null || !('sources' in exported) || !('mappings' in exported))
+        throw notDeclarations(file);
+    try {
+        // Read back as this CLI's type, so declarations of another shape are refused here
+        return decodeManifest(encodeManifest(exported));
+    }
+    catch {
+        throw notDeclarations(file);
+    }
+}
+//# sourceMappingURL=files-source.js.map

package/dist/src/files-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files-source.js","sourceRoot":"","sources":["../../src/files-source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAsB,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAExE,MAAM,cAAc,GAAG,eAAe,CAAC,iBAAiB,CAAC,CAAC;AAC1D,MAAM,cAAc,GAAG,eAAe,CAAC,iBAAiB,CAAC,CAAC;AAE1D,6DAA6D;AAC7D,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,KAAK,CAAC,GAAG,IAAI,gGAAgG,CAAC,CAAC;AAC5H,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,MAAM,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,IAAI,EAAE,yBAAyB,EAAE,oBAAoB,CAAC,CAAC;IACtF,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACvD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,IAAI,QAAQ,CAAC;QAAE,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAC5I,IAAI,CAAC;QACH,kFAAkF;QAClF,OAAO,cAAc,CAAC,cAAc,CAAC,QAAyB,CAAC,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/src/source-module.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * A source's entry, resolved, and a package of its project's.
+ *
+ * @param file - The source
+ * @param entry - The package the project must have, e.g. `@elaraai/e3-cloud-ui`
+ * @param why - What it is needed for, completing "… is built with the version its source imports"
+ * @returns The source's absolute path, and the package's entry, as the source's project resolves it
+ * @throws {Error} When the source does not exist, or its project lacks the package
+ */
+export declare function resolveSource(file: string, entry: string, why: string): {
+    path: string;
+    entryPath: string;
+};
+/**
+ * Runs a source module and answers its default export.
+ *
+ * @param file - The source, as the user named it (for messages)
+ * @param path - Its absolute path ({@link resolveSource})
+ * @returns Its default export
+ * @throws {Error} When it does not bundle or does not run
+ */
+export declare function sourceDefaultExport(file: string, path: string): Promise<unknown>;
+/**
+ * Imports a package by the entry a source's project resolves it to.
+ *
+ * @param entryPath - The entry ({@link resolveSource})
+ * @returns The module
+ */
+export declare function importEntry<T>(entryPath: string): Promise<T>;
+//# sourceMappingURL=source-module.d.ts.map

package/dist/src/source-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-module.d.ts","sourceRoot":"","sources":["../../src/source-module.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2BH;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAQ3G;AAiBD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAwBtF;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAElE"}