@overkill-dev/resources 0.0.1 → 0.0.2

package/resources/runtime-lifecycle.js

@@ -0,0 +1,83 @@
+import { isDefinedRuntime } from "./resources.js";
+import { resourceLifecycleError } from "./resource-lifecycle-error.js";
+import { acquireResourceGraph, disposeResources, runtimeAsyncDisposeSymbol } from "./resource-session.js";
+const runtimeResourceAcquisitionContext = {
+    acquisitionFailureMessage: 'Runtime resource acquisition failed.',
+    fallbackResourceName: 'runtime'
+};
+function assertRuntimeDefinition(runtime) {
+    if (isDefinedRuntime(runtime)) {
+        return;
+    }
+    throw resourceLifecycleError('Runtime descriptor is invalid.', [
+        { cause: runtime, phase: 'graph', resourceName: 'runtime' }
+    ], runtime);
+}
+function isRuntimeContext(context, resources) {
+    for (const key of Object.keys(resources)) {
+        if (!Object.hasOwn(context, key)) {
+            return false;
+        }
+    }
+    return true;
+}
+function runtimeContext(resources, handles) {
+    const context = {};
+    for (const key of Object.keys(resources)) {
+        context[key] = Reflect.get(handles, key);
+    }
+    const frozenContext = Object.freeze(context);
+    if (isRuntimeContext(frozenContext, resources)) {
+        return frozenContext;
+    }
+    throw resourceLifecycleError('Runtime resource context is incomplete.', [
+        { cause: resources, phase: 'graph', resourceName: 'runtime' }
+    ], resources);
+}
+function internalDisposalSignal() {
+    const controller = new AbortController();
+    return controller.signal;
+}
+function isRuntimeSession(session) {
+    return Reflect.has(session, runtimeAsyncDisposeSymbol());
+}
+async function disposeRuntimeResources(acquisition, signal) {
+    const failures = await disposeResources(acquisition.order, acquisition.handles, signal);
+    if (failures.length > 0) {
+        throw resourceLifecycleError('Runtime resource disposal failed.', failures, failures[0]?.cause);
+    }
+}
+function runtimeSession(context, acquisition) {
+    let disposal = null;
+    const session = {
+        context,
+        async disposeOnce(disposalContext) {
+            if (disposal === null) {
+                disposal = disposeRuntimeResources(acquisition, disposalContext.signal);
+            }
+            await disposal;
+        }
+    };
+    Object.defineProperty(session, runtimeAsyncDisposeSymbol(), {
+        value: async function disposeRuntimeWithInternalSignal() {
+            await session.disposeOnce({ signal: internalDisposalSignal() });
+        }
+    });
+    const frozenSession = Object.freeze(session);
+    if (isRuntimeSession(frozenSession)) {
+        return frozenSession;
+    }
+    throw resourceLifecycleError('Runtime session is incomplete.', [
+        { cause: session, phase: 'graph', resourceName: 'runtime' }
+    ], session);
+}
+export async function startRuntime(request) {
+    assertRuntimeDefinition(request.runtime);
+    const acquisition = await acquireResourceGraph({
+        resources: request.runtime.resources,
+        signal: request.signal
+    }, runtimeResourceAcquisitionContext);
+    const context = runtimeContext(request.runtime.resources, acquisition.context);
+    return runtimeSession(context, acquisition);
+}
+//# sourceMappingURL=runtime-lifecycle.js.map

package/resources/runtime-lifecycle.js.map

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

package/resources/runtime-matrix-definition.d.ts

@@ -0,0 +1,53 @@
+import { type RuntimeDefinition, type RuntimeDimensions } from './runtime-definition.ts';
+import type { RuntimeResourceMap } from './resource-definition-shape.ts';
+declare const runtimeMatrixDefinitionBrand: unique symbol;
+declare const composedRuntimeGraphBrand: unique symbol;
+type RuntimeMatrixVariantValue<Shared, Dimensions extends RuntimeDimensions, Resources extends RuntimeResourceMap> = RuntimeMatrixVariantValueOptions<Shared, Dimensions, Resources>[keyof RuntimeMatrixVariantValueOptions<Shared, Dimensions, Resources>];
+type RuntimeMatrixVariantValueOptions<Shared, Dimensions extends RuntimeDimensions, Resources extends RuntimeResourceMap> = {
+    readonly factory: (shared: Shared) => RuntimeDefinition<string, Dimensions, Resources>;
+    readonly runtime: RuntimeDefinition<string, Dimensions, Resources>;
+};
+type RuntimeVariantFactoryResult<Variant, Shared> = Variant extends (shared: Shared) => infer Runtime ? Runtime : never;
+type ResolvedRuntimeVariant<Variant, Shared> = Extract<RuntimeVariantFactoryResult<Variant, Shared> | Variant, RuntimeDefinition>;
+export type RuntimeMatrixVariant<VariantId extends string = string, Runtime extends RuntimeDefinition = RuntimeDefinition> = {
+    readonly id: VariantId;
+    readonly runtime: Runtime;
+};
+type RuntimeMatrixVariantMap = Readonly<Record<string, RuntimeMatrixVariant>>;
+type ResolvedRuntimeMatrixVariants<Variants extends Readonly<Record<string, RuntimeMatrixVariantValue<Shared, RuntimeDimensions, RuntimeResourceMap>>>, Shared> = {
+    readonly [VariantId in keyof Variants]: RuntimeMatrixVariant<VariantId & string, ResolvedRuntimeVariant<Variants[VariantId], Shared>>;
+};
+export type RuntimeMatrixDefinition<Name extends string = string, Variants extends RuntimeMatrixVariantMap = RuntimeMatrixVariantMap> = {
+    readonly kind: 'runtime-matrix';
+    readonly name: Name;
+    readonly variants: Variants;
+    readonly [runtimeMatrixDefinitionBrand]: true;
+};
+export type RuntimeGraphLeaf = RuntimeDefinition | RuntimeMatrixDefinition;
+export type ComposedRuntimeGraph<Runtimes extends readonly RuntimeGraphLeaf[] = readonly RuntimeGraphLeaf[]> = {
+    readonly kind: 'composed-runtimes';
+    readonly runtimes: Runtimes;
+    readonly [composedRuntimeGraphBrand]: true;
+};
+export type RuntimeGraph = ComposedRuntimeGraph | RuntimeGraphLeaf;
+type FlattenRuntimeGraph<Graph extends RuntimeGraph> = Graph extends ComposedRuntimeGraph<infer Runtimes> ? Runtimes[number] : Extract<Graph, RuntimeGraphLeaf>;
+type FlattenRuntimeGraphs<Graphs extends readonly RuntimeGraph[]> = {
+    readonly [Key in keyof Graphs]: FlattenRuntimeGraph<Graphs[Key]>;
+};
+export type RuntimeMatrixDefinitionInput<Name extends string, Variants extends Readonly<Record<string, RuntimeMatrixVariantValue<never, RuntimeDimensions, RuntimeResourceMap>>>> = {
+    readonly name: Name;
+    readonly variants: Variants;
+};
+export type SharedRuntimeMatrixDefinitionInput<Name extends string, Shared, Variants extends Readonly<Record<string, RuntimeMatrixVariantValue<Shared, RuntimeDimensions, RuntimeResourceMap>>>> = {
+    readonly name: Name;
+    readonly shared: Shared;
+    readonly variants: Variants;
+};
+export declare function defineRuntimeMatrix<const Name extends string, const Dimensions extends RuntimeDimensions, const Resources extends RuntimeResourceMap, const Variants extends Readonly<Record<string, RuntimeDefinition<string, Dimensions, Resources>>>>(definition: RuntimeMatrixDefinitionInput<Name, Variants>): RuntimeMatrixDefinition<Name, ResolvedRuntimeMatrixVariants<Variants, never>>;
+export declare function defineRuntimeMatrix<const Name extends string, Shared, const Dimensions extends RuntimeDimensions, const Resources extends RuntimeResourceMap, const Variants extends Readonly<Record<string, RuntimeMatrixVariantValue<Shared, Dimensions, Resources>>>>(definition: SharedRuntimeMatrixDefinitionInput<Name, Shared, Variants>): RuntimeMatrixDefinition<Name, ResolvedRuntimeMatrixVariants<Variants, Shared>>;
+export declare function isDefinedRuntimeMatrix(runtime: unknown): runtime is RuntimeMatrixDefinition;
+export declare function runtimeGraphLeaves(runtime: RuntimeGraph): readonly RuntimeGraphLeaf[];
+export declare function composeRuntimes<const Runtimes extends readonly [RuntimeGraph, ...RuntimeGraph[]]>(...runtimes: Runtimes): ComposedRuntimeGraph<FlattenRuntimeGraphs<Runtimes>>;
+export declare function isComposedRuntimeGraph(runtime: unknown): runtime is ComposedRuntimeGraph;
+export {};
+//# sourceMappingURL=runtime-matrix-definition.d.ts.map

package/resources/runtime-matrix-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-matrix-definition.d.ts","sourceRoot":"","sources":["../../../../source/resources/runtime-matrix-definition.ts"],"names":[],"mappings":"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"}

package/resources/runtime-matrix-definition.js

@@ -0,0 +1,159 @@
+import { isDefinedRuntime } from "./runtime-definition.js";
+const runtimeMatrixDefinitionBrand = Symbol('overkill.runtimeMatrixDefinition');
+const composedRuntimeGraphBrand = Symbol('overkill.composedRuntimeGraph');
+const descriptorNamePattern = /^[A-Za-z0-9._-]+$/u;
+function assertDescriptorName(kind, name) {
+    if (!descriptorNamePattern.test(name)) {
+        throw new TypeError(`${kind} "${name}" must match ${descriptorNamePattern.source}.`);
+    }
+}
+function compareStrings(left, right) {
+    return left.localeCompare(right);
+}
+function sortedKeys(record) {
+    return Object.keys(record).toSorted(compareStrings);
+}
+function sameStringItems(left, right) {
+    return left.length === right.length && left.every(function itemMatches(item, index) {
+        return item === right[index];
+    });
+}
+function dimensionIdentity(dimensions) {
+    return JSON.stringify(sortedKeys(dimensions).map(function toEntry(key) {
+        return [key, dimensions[key]];
+    }));
+}
+function resolveMatrixRuntime(variant, shared) {
+    return typeof variant === 'function' ? variant(shared) : variant;
+}
+function assertMatrixVariantRuntime(variantId, runtime) {
+    if (!isDefinedRuntime(runtime)) {
+        throw new TypeError(`Runtime matrix variant "${variantId}" must resolve to a runtime descriptor.`);
+    }
+}
+function assertSameShape(matrixName, variantId, runtime, state) {
+    if (!sameStringItems(sortedKeys(runtime.dimensions), state.dimensionKeys)) {
+        throw new TypeError(`Runtime matrix "${matrixName}" variant "${variantId}" has different dimension keys.`);
+    }
+    if (!sameStringItems(sortedKeys(runtime.resources), state.resourceKeys)) {
+        throw new TypeError(`Runtime matrix "${matrixName}" variant "${variantId}" has different resource keys.`);
+    }
+}
+function nextVariantState(matrixName, variantId, runtime, state) {
+    const key = dimensionIdentity(runtime.dimensions);
+    if (state.dimensionIdentities.has(key)) {
+        throw new TypeError(`Runtime matrix "${matrixName}" variant "${variantId}" duplicates another dimension tuple.`);
+    }
+    return {
+        ...state,
+        dimensionIdentities: new Set([...state.dimensionIdentities, key])
+    };
+}
+function runtimeMatrixVariant(variantId, runtime) {
+    return Object.freeze({
+        id: variantId,
+        runtime
+    });
+}
+function readShared(definition) {
+    return Object.hasOwn(definition, 'shared') ? Reflect.get(definition, 'shared') : undefined;
+}
+function initialVariantState(runtime) {
+    return {
+        dimensionIdentities: new Set(),
+        dimensionKeys: sortedKeys(runtime.dimensions),
+        resourceKeys: sortedKeys(runtime.resources)
+    };
+}
+function runtimeMatrixEntries(definition) {
+    const variantEntries = Object.entries(definition.variants);
+    const firstVariant = variantEntries[0];
+    if (firstVariant === undefined) {
+        throw new TypeError(`Runtime matrix "${definition.name}" requires at least one variant.`);
+    }
+    return [firstVariant, ...variantEntries.slice(1)];
+}
+function firstRuntime(variantId, variantInput, shared) {
+    assertDescriptorName('Runtime matrix variant', variantId);
+    const runtime = resolveMatrixRuntime(variantInput, shared);
+    assertMatrixVariantRuntime(variantId, runtime);
+    return runtime;
+}
+function matrixVariantEntry(matrixName, variantId, runtime, state) {
+    assertDescriptorName('Runtime matrix variant', variantId);
+    assertMatrixVariantRuntime(variantId, runtime);
+    assertSameShape(matrixName, variantId, runtime, state);
+    return [
+        variantId,
+        runtimeMatrixVariant(variantId, runtime),
+        nextVariantState(matrixName, variantId, runtime, state)
+    ];
+}
+function variantRecord(entries) {
+    const variants = Object.fromEntries(entries);
+    return Object.freeze(variants);
+}
+function runtimeMatrixVariants(definition) {
+    const variantEntries = runtimeMatrixEntries(definition);
+    const shared = readShared(definition);
+    const [firstVariantId, firstVariantInput] = variantEntries[0];
+    const firstRuntimeValue = firstRuntime(firstVariantId, firstVariantInput, shared);
+    let state = initialVariantState(firstRuntimeValue);
+    const variants = variantEntries.map(function matrixVariant([variantId, variantInput]) {
+        const runtime = variantId === firstVariantId ? firstRuntimeValue : resolveMatrixRuntime(variantInput, shared);
+        const [key, variant, nextState] = matrixVariantEntry(definition.name, variantId, runtime, state);
+        state = nextState;
+        return [key, variant];
+    });
+    return variantRecord(variants);
+}
+export function defineRuntimeMatrix(definition) {
+    assertDescriptorName('Runtime matrix', definition.name);
+    return Object.freeze({
+        kind: 'runtime-matrix',
+        name: definition.name,
+        variants: runtimeMatrixVariants(definition),
+        [runtimeMatrixDefinitionBrand]: true
+    });
+}
+export function isDefinedRuntimeMatrix(runtime) {
+    return typeof runtime === 'object' &&
+        runtime !== null &&
+        Reflect.get(runtime, runtimeMatrixDefinitionBrand) === true;
+}
+export function runtimeGraphLeaves(runtime) {
+    return runtime.kind === 'composed-runtimes' ? runtime.runtimes : [runtime];
+}
+function duplicateRuntimeName(name) {
+    return new TypeError(`Runtime scope "${name}" is attached multiple times.`);
+}
+function assertUniqueRuntimeNames(runtimes) {
+    const names = new Set();
+    for (const runtime of runtimes) {
+        if (names.has(runtime.name)) {
+            throw duplicateRuntimeName(runtime.name);
+        }
+        names.add(runtime.name);
+    }
+}
+function flattenRuntimeGraphs(runtimes) {
+    return runtimes.flatMap(runtimeGraphLeaves);
+}
+export function composeRuntimes(...runtimes) {
+    if (runtimes.length === 0) {
+        throw new TypeError('composeRuntimes() requires at least one runtime graph.');
+    }
+    const flattened = flattenRuntimeGraphs(runtimes);
+    assertUniqueRuntimeNames(flattened);
+    return Object.freeze({
+        kind: 'composed-runtimes',
+        runtimes: Object.freeze(Array.from(flattened)),
+        [composedRuntimeGraphBrand]: true
+    });
+}
+export function isComposedRuntimeGraph(runtime) {
+    return typeof runtime === 'object' &&
+        runtime !== null &&
+        Reflect.get(runtime, composedRuntimeGraphBrand) === true;
+}
+//# sourceMappingURL=runtime-matrix-definition.js.map

package/resources/runtime-matrix-definition.js.map

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

package/sbom.cdx.json

@@ -0,0 +1,30 @@
+{
+    "$schema": "http://cyclonedx.org/schema/bom-1.6.schema.json",
+    "bomFormat": "CycloneDX",
+    "specVersion": "1.6",
+    "version": 1,
+    "metadata": {
+        "tools": {
+            "components": [
+                {
+                    "type": "application",
+                    "name": "packtory",
+                    "version": "0.0.97"
+                }
+            ]
+        },
+        "component": {
+            "type": "library",
+            "name": "@overkill-dev/resources",
+            "version": "0.0.2",
+            "bom-ref": "pkg:npm/@overkill-dev/resources@0.0.2",
+            "purl": "pkg:npm/@overkill-dev/resources@0.0.2"
+        }
+    },
+    "components": [],
+    "dependencies": [
+        {
+            "ref": "pkg:npm/@overkill-dev/resources@0.0.2"
+        }
+    ]
+}