@edumalin/platform 3.0.0

package/dist/esm/environment/error/invalid-platform-environment-region-error-properties.d.ts

@@ -0,0 +1,3 @@
+export interface InvalidPlatformEnvironmentRegionErrorProperties {
+    readonly value: unknown;
+}

package/dist/esm/environment/error/invalid-platform-environment-region-error-properties.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/environment/error/invalid-platform-environment-type-error-properties.d.ts

@@ -0,0 +1,3 @@
+export interface InvalidPlatformEnvironmentTypeErrorProperties {
+    readonly value: unknown;
+}

package/dist/esm/environment/error/invalid-platform-environment-type-error-properties.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/environment/id/as-platform-environment-id.d.ts

@@ -0,0 +1,2 @@
+import { type PlatformEnvironmentId } from './platform-environment-id.js';
+export declare function asPlatformEnvironmentId(value: unknown): PlatformEnvironmentId;

package/dist/esm/environment/id/as-platform-environment-id.js

@@ -0,0 +1,5 @@
+import { validatePlatformEnvironmentId } from './validate-platform-environment-id.js';
+export function asPlatformEnvironmentId(value) {
+    validatePlatformEnvironmentId(value);
+    return value;
+}

package/dist/esm/environment/id/is-platform-environment-id.d.ts

@@ -0,0 +1,2 @@
+import { type PlatformEnvironmentId } from './platform-environment-id.js';
+export declare function isPlatformEnvironmentId(value: unknown): value is PlatformEnvironmentId;

package/dist/esm/environment/id/is-platform-environment-id.js

@@ -0,0 +1,3 @@
+export function isPlatformEnvironmentId(value) {
+    return typeof value === 'string' && /^[a-z-]{2,24}$/.test(value);
+}

package/dist/esm/environment/id/platform-environment-id.d.ts

@@ -0,0 +1,3 @@
+export type PlatformEnvironmentId = string & {
+    readonly __tag_platformEnvironmentId: unique symbol;
+};

package/dist/esm/environment/id/platform-environment-id.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/environment/id/validate-platform-environment-id.d.ts

@@ -0,0 +1,2 @@
+import { type PlatformEnvironmentId } from './platform-environment-id.js';
+export declare function validatePlatformEnvironmentId(value: unknown): asserts value is PlatformEnvironmentId;

package/dist/esm/environment/id/validate-platform-environment-id.js

@@ -0,0 +1,7 @@
+import { environmentError } from '../environment.error.js';
+import { isPlatformEnvironmentId } from './is-platform-environment-id.js';
+export function validatePlatformEnvironmentId(value) {
+    if (!isPlatformEnvironmentId(value)) {
+        throw environmentError.invalidPlatformEnvironmentId({ value });
+    }
+}

package/dist/esm/environment/index.d.ts

@@ -0,0 +1,25 @@
+export { asPlatformEnvironmentId } from './id/as-platform-environment-id.js';
+export { asPlatformEnvironmentProvider } from './provider/as-platform-environment-provider.js';
+export { asPlatformEnvironmentRegion } from './region/as-platform-environment-region.js';
+export { asPlatformEnvironmentType } from './type/as-platform-environment-type.js';
+export { type EnvironmentVariables } from './variable/environment-variables.js';
+export { environmentVariablesToPlatformEnvironment } from './variable/environment-variables-to-platform-environment.js';
+export { environmentVariablesToValue } from './variable/environment-variables-to-value.js';
+export { environmentVariablesToValues } from './variable/environment-variables-to-values.js';
+export { isPlatformEnvironmentId } from './id/is-platform-environment-id.js';
+export { isPlatformEnvironmentProvider } from './provider/is-platform-environment-provider.js';
+export { isPlatformEnvironmentRegion } from './region/is-platform-environment-region.js';
+export { isPlatformEnvironmentType } from './type/is-platform-environment-type.js';
+export { type PlatformEnvironment } from './platform-environment.js';
+export { type PlatformEnvironmentId } from './id/platform-environment-id.js';
+export { type PlatformEnvironmentProvider } from './provider/platform-environment-provider.js';
+export { platformEnvironmentProviders } from './provider/platform-environment-providers.js';
+export { type PlatformEnvironmentRegion } from './region/platform-environment-region.js';
+export { platformEnvironmentRegions } from './region/platform-environment-regions.js';
+export { platformEnvironmentToEnvironmentVariables } from './variable/platform-environment-to-environment-variables.js';
+export { type PlatformEnvironmentType } from './type/platform-environment-type.js';
+export { platformEnvironmentTypes } from './type/platform-environment-types.js';
+export { validatePlatformEnvironmentId } from './id/validate-platform-environment-id.js';
+export { validatePlatformEnvironmentProvider } from './provider/validate-platform-environment-provider.js';
+export { validatePlatformEnvironmentRegion } from './region/validate-platform-environment-region.js';
+export { validatePlatformEnvironmentType } from './type/validate-platform-environment-type.js';

package/dist/esm/environment/index.js

@@ -0,0 +1,19 @@
+export { asPlatformEnvironmentId } from './id/as-platform-environment-id.js';
+export { asPlatformEnvironmentProvider } from './provider/as-platform-environment-provider.js';
+export { asPlatformEnvironmentRegion } from './region/as-platform-environment-region.js';
+export { asPlatformEnvironmentType } from './type/as-platform-environment-type.js';
+export { environmentVariablesToPlatformEnvironment } from './variable/environment-variables-to-platform-environment.js';
+export { environmentVariablesToValue } from './variable/environment-variables-to-value.js';
+export { environmentVariablesToValues } from './variable/environment-variables-to-values.js';
+export { isPlatformEnvironmentId } from './id/is-platform-environment-id.js';
+export { isPlatformEnvironmentProvider } from './provider/is-platform-environment-provider.js';
+export { isPlatformEnvironmentRegion } from './region/is-platform-environment-region.js';
+export { isPlatformEnvironmentType } from './type/is-platform-environment-type.js';
+export { platformEnvironmentProviders } from './provider/platform-environment-providers.js';
+export { platformEnvironmentRegions } from './region/platform-environment-regions.js';
+export { platformEnvironmentToEnvironmentVariables } from './variable/platform-environment-to-environment-variables.js';
+export { platformEnvironmentTypes } from './type/platform-environment-types.js';
+export { validatePlatformEnvironmentId } from './id/validate-platform-environment-id.js';
+export { validatePlatformEnvironmentProvider } from './provider/validate-platform-environment-provider.js';
+export { validatePlatformEnvironmentRegion } from './region/validate-platform-environment-region.js';
+export { validatePlatformEnvironmentType } from './type/validate-platform-environment-type.js';

package/dist/esm/environment/platform-environment.d.ts

@@ -0,0 +1,11 @@
+import { type PlatformEnvironmentId } from './id/platform-environment-id';
+import { type PlatformEnvironmentProvider } from './provider/platform-environment-provider';
+import { type PlatformEnvironmentRegion } from './region/platform-environment-region';
+import { type PlatformEnvironmentType } from './type/platform-environment-type';
+export interface PlatformEnvironment {
+    readonly id: PlatformEnvironmentId;
+    readonly name: string;
+    readonly provider: PlatformEnvironmentProvider;
+    readonly region: PlatformEnvironmentRegion;
+    readonly type: PlatformEnvironmentType;
+}

package/dist/esm/environment/platform-environment.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/environment/provider/as-platform-environment-provider.d.ts

@@ -0,0 +1,2 @@
+import { type PlatformEnvironmentProvider } from './platform-environment-provider.js';
+export declare function asPlatformEnvironmentProvider(value: unknown): PlatformEnvironmentProvider;

package/dist/esm/environment/provider/as-platform-environment-provider.js

@@ -0,0 +1,5 @@
+import { validatePlatformEnvironmentProvider } from './validate-platform-environment-provider.js';
+export function asPlatformEnvironmentProvider(value) {
+    validatePlatformEnvironmentProvider(value);
+    return value;
+}

package/dist/esm/environment/provider/is-platform-environment-provider.d.ts

@@ -0,0 +1,2 @@
+import { type PlatformEnvironmentProvider } from './platform-environment-provider.js';
+export declare function isPlatformEnvironmentProvider(value: unknown): value is PlatformEnvironmentProvider;

package/dist/esm/environment/provider/is-platform-environment-provider.js

@@ -0,0 +1,5 @@
+import { platformEnvironmentProviders } from './platform-environment-providers.js';
+export function isPlatformEnvironmentProvider(value) {
+    return typeof value === 'string' && set.has(value);
+}
+const set = new Set(platformEnvironmentProviders);

package/dist/esm/environment/provider/platform-environment-provider.d.ts

@@ -0,0 +1,2 @@
+import { type platformEnvironmentProviders } from './platform-environment-providers.js';
+export type PlatformEnvironmentProvider = (typeof platformEnvironmentProviders)[number];

package/dist/esm/environment/provider/platform-environment-provider.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/environment/provider/platform-environment-providers.d.ts

@@ -0,0 +1 @@
+export declare const platformEnvironmentProviders: readonly ["aws", "azure", "gcp", "local", "scaleway"];

package/dist/esm/environment/provider/platform-environment-providers.js

@@ -0,0 +1 @@
+export const platformEnvironmentProviders = ['aws', 'azure', 'gcp', 'local', 'scaleway'];

package/dist/esm/environment/provider/validate-platform-environment-provider.d.ts

@@ -0,0 +1,2 @@
+import { type PlatformEnvironmentProvider } from './platform-environment-provider.js';
+export declare function validatePlatformEnvironmentProvider(value: unknown): asserts value is PlatformEnvironmentProvider;

package/dist/esm/environment/provider/validate-platform-environment-provider.js

@@ -0,0 +1,7 @@
+import { environmentError } from '../environment.error.js';
+import { isPlatformEnvironmentProvider } from './is-platform-environment-provider.js';
+export function validatePlatformEnvironmentProvider(value) {
+    if (!isPlatformEnvironmentProvider(value)) {
+        throw environmentError.invalidPlatformEnvironmentProvider({ value });
+    }
+}

package/dist/esm/environment/region/as-platform-environment-region.d.ts

@@ -0,0 +1,2 @@
+import { type PlatformEnvironmentRegion } from './platform-environment-region.js';
+export declare function asPlatformEnvironmentRegion(value: unknown): PlatformEnvironmentRegion;

package/dist/esm/environment/region/as-platform-environment-region.js

@@ -0,0 +1,5 @@
+import { validatePlatformEnvironmentRegion } from './validate-platform-environment-region.js';
+export function asPlatformEnvironmentRegion(value) {
+    validatePlatformEnvironmentRegion(value);
+    return value;
+}

package/dist/esm/environment/region/is-platform-environment-region.d.ts

@@ -0,0 +1,2 @@
+import { type PlatformEnvironmentRegion } from './platform-environment-region.js';
+export declare function isPlatformEnvironmentRegion(value: unknown): value is PlatformEnvironmentRegion;

package/dist/esm/environment/region/is-platform-environment-region.js

@@ -0,0 +1,5 @@
+import { platformEnvironmentRegions } from './platform-environment-regions.js';
+export function isPlatformEnvironmentRegion(value) {
+    return typeof value === 'string' && regions.has(value);
+}
+const regions = new Set(platformEnvironmentRegions);

package/dist/esm/environment/region/platform-environment-region.d.ts

@@ -0,0 +1,2 @@
+import { type platformEnvironmentRegions } from './platform-environment-regions.js';
+export type PlatformEnvironmentRegion = (typeof platformEnvironmentRegions)[number];

package/dist/esm/environment/region/platform-environment-region.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/environment/region/platform-environment-regions.d.ts

@@ -0,0 +1 @@
+export declare const platformEnvironmentRegions: readonly ["af-paas", "as-paas", "eu-france", "eu-paas", "na-paas", "local", "sa-paas"];

package/dist/esm/environment/region/platform-environment-regions.js

@@ -0,0 +1,9 @@
+export const platformEnvironmentRegions = [
+    'af-paas',
+    'as-paas',
+    'eu-france',
+    'eu-paas',
+    'na-paas',
+    'local',
+    'sa-paas',
+];

package/dist/esm/environment/region/validate-platform-environment-region.d.ts

@@ -0,0 +1,2 @@
+import { type PlatformEnvironmentRegion } from './platform-environment-region.js';
+export declare function validatePlatformEnvironmentRegion(value: unknown): asserts value is PlatformEnvironmentRegion;

package/dist/esm/environment/region/validate-platform-environment-region.js

@@ -0,0 +1,7 @@
+import { environmentError } from '../environment.error.js';
+import { isPlatformEnvironmentRegion } from './is-platform-environment-region.js';
+export function validatePlatformEnvironmentRegion(value) {
+    if (!isPlatformEnvironmentRegion(value)) {
+        throw environmentError.invalidPlatformEnvironmentRegion({ value });
+    }
+}

package/dist/esm/environment/type/as-platform-environment-type.d.ts

@@ -0,0 +1,2 @@
+import { type PlatformEnvironmentType } from './platform-environment-type.js';
+export declare function asPlatformEnvironmentType(value: unknown): PlatformEnvironmentType;

package/dist/esm/environment/type/as-platform-environment-type.js

@@ -0,0 +1,5 @@
+import { validatePlatformEnvironmentType } from './validate-platform-environment-type.js';
+export function asPlatformEnvironmentType(value) {
+    validatePlatformEnvironmentType(value);
+    return value;
+}

package/dist/esm/environment/type/is-platform-environment-type.d.ts

@@ -0,0 +1,2 @@
+import { type PlatformEnvironmentType } from './platform-environment-type.js';
+export declare function isPlatformEnvironmentType(value: unknown): value is PlatformEnvironmentType;

package/dist/esm/environment/type/is-platform-environment-type.js

@@ -0,0 +1,5 @@
+import { platformEnvironmentTypes } from './platform-environment-types.js';
+export function isPlatformEnvironmentType(value) {
+    return typeof value === 'string' && set.has(value);
+}
+const set = new Set(platformEnvironmentTypes);

package/dist/esm/environment/type/platform-environment-type.d.ts

@@ -0,0 +1,2 @@
+import { type platformEnvironmentTypes } from './platform-environment-types.js';
+export type PlatformEnvironmentType = (typeof platformEnvironmentTypes)[number];

package/dist/esm/environment/type/platform-environment-type.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/environment/type/platform-environment-types.d.ts

@@ -0,0 +1 @@
+export declare const platformEnvironmentTypes: readonly ["development", "local", "production", "staging"];

package/dist/esm/environment/type/platform-environment-types.js

@@ -0,0 +1 @@
+export const platformEnvironmentTypes = ['development', 'local', 'production', 'staging'];

package/dist/esm/environment/type/validate-platform-environment-type.d.ts

@@ -0,0 +1,2 @@
+import { type PlatformEnvironmentType } from './platform-environment-type.js';
+export declare function validatePlatformEnvironmentType(value: unknown): asserts value is PlatformEnvironmentType;

package/dist/esm/environment/type/validate-platform-environment-type.js

@@ -0,0 +1,7 @@
+import { environmentError } from '../environment.error.js';
+import { isPlatformEnvironmentType } from './is-platform-environment-type.js';
+export function validatePlatformEnvironmentType(value) {
+    if (!isPlatformEnvironmentType(value)) {
+        throw environmentError.invalidPlatformEnvironmentType({ value });
+    }
+}

package/dist/esm/environment/variable/definition/environment-variable-definition-to-resolver.d.ts

@@ -0,0 +1,3 @@
+import { type EnvironmentVariableDefinition } from './environment-variable-definition.js';
+import { type EnvironmentVariableResolver } from './environment-variable-resolver.js';
+export declare function environmentVariableDefinitionToResolver<T, Optional extends boolean>(environmentVariableDefinition: EnvironmentVariableDefinition<T, Optional>): EnvironmentVariableResolver<T>;

package/dist/esm/environment/variable/definition/environment-variable-definition-to-resolver.js

@@ -0,0 +1,11 @@
+import { identity } from '@edumalin/platform/functional';
+export function environmentVariableDefinitionToResolver(environmentVariableDefinition) {
+    const { defaultValue, description, optional = false, parse = identity } = environmentVariableDefinition;
+    return (variableValue, name) => {
+        const value = variableValue !== undefined ? parse(variableValue) : defaultValue;
+        if (value === undefined && !optional) {
+            throw new Error(`missing environment variable "${name}" (${description})`);
+        }
+        return value;
+    };
+}

package/dist/esm/environment/variable/definition/environment-variable-definition-type.d.ts

@@ -0,0 +1,3 @@
+import { type ReadonlyRecord } from '@edumalin/platform/typescript';
+import { type EnvironmentVariableDefinition } from './environment-variable-definition.js';
+export type EnvironmentVariableDefinitionType<T extends ReadonlyRecord<string, EnvironmentVariableDefinition<unknown, boolean>>> = T extends ReadonlyRecord<string, infer DefinitionType> ? DefinitionType : never;

package/dist/esm/environment/variable/definition/environment-variable-definition-type.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/environment/variable/definition/environment-variable-definition.d.ts

@@ -0,0 +1,7 @@
+export interface EnvironmentVariableDefinition<T = string, Optional extends boolean = false> {
+    readonly defaultValue?: T;
+    readonly description: string;
+    readonly name: string;
+    readonly optional?: Optional;
+    readonly parse?: (variableValue: string) => T;
+}

package/dist/esm/environment/variable/definition/environment-variable-definition.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/environment/variable/definition/environment-variable-definitions-to-resolvers.d.ts

@@ -0,0 +1,4 @@
+import { type ReadonlyRecord } from '@edumalin/platform/typescript';
+import { type EnvironmentVariableDefinition } from './environment-variable-definition.js';
+import { type EnvironmentVariableEntry } from './environment-variable-entry.js';
+export declare function environmentVariableDefinitionsToResolvers<VariableDefinitions extends ReadonlyRecord<string, EnvironmentVariableDefinition<unknown, boolean>>>(definitions: VariableDefinitions): ReadonlyArray<EnvironmentVariableEntry<VariableDefinitions>>;

package/dist/esm/environment/variable/definition/environment-variable-definitions-to-resolvers.js

@@ -0,0 +1,8 @@
+import { objectToEntries } from '@edumalin/platform/functional';
+import { environmentVariableDefinitionToResolver } from './environment-variable-definition-to-resolver.js';
+export function environmentVariableDefinitionsToResolvers(definitions) {
+    return objectToEntries(definitions).map(([propertyKey, variableDefinition]) => {
+        const variableResolver = environmentVariableDefinitionToResolver(variableDefinition);
+        return [propertyKey, variableDefinition, variableResolver];
+    });
+}

package/dist/esm/environment/variable/definition/environment-variable-entries-to-object.d.ts

@@ -0,0 +1,6 @@
+import { type ReadonlyRecord } from '@edumalin/platform/typescript';
+import { type EnvironmentVariables } from '../environment-variables.js';
+import { type EnvironmentVariableDefinition } from './environment-variable-definition.js';
+import { type EnvironmentVariableDefinitionType } from './environment-variable-definition-type.js';
+import { type EnvironmentVariableEntry } from './environment-variable-entry.js';
+export declare function environmentVariableEntriesToObject<VariableDefinitions extends ReadonlyRecord<string, EnvironmentVariableDefinition<unknown, boolean>>>(environmentVariables: EnvironmentVariables, variableNameResolver: (definition: EnvironmentVariableDefinitionType<VariableDefinitions>, propertyKey: keyof VariableDefinitions) => string): (obj: ReadonlyRecord<keyof VariableDefinitions, unknown>, environmentVariableEntry: EnvironmentVariableEntry<VariableDefinitions>) => ReadonlyRecord<keyof VariableDefinitions, unknown>;

package/dist/esm/environment/variable/definition/environment-variable-entries-to-object.js

@@ -0,0 +1,11 @@
+export function environmentVariableEntriesToObject(environmentVariables, variableNameResolver) {
+    return (obj, [propertyKey, definition, resolver]) => {
+        const variableName = variableNameResolver(definition, propertyKey);
+        const variableString = environmentVariables[variableName];
+        const propertyValue = resolver(variableString, variableName);
+        return {
+            ...obj,
+            [propertyKey]: propertyValue,
+        };
+    };
+}

package/dist/esm/environment/variable/definition/environment-variable-entry.d.ts

@@ -0,0 +1,9 @@
+import { type ReadonlyRecord } from '@edumalin/platform/typescript';
+import { type EnvironmentVariableDefinition } from './environment-variable-definition.js';
+import { type EnvironmentVariableDefinitionType } from './environment-variable-definition-type.js';
+import { type EnvironmentVariableResolver } from './environment-variable-resolver.js';
+export type EnvironmentVariableEntry<VariableDefinitions extends ReadonlyRecord<string, EnvironmentVariableDefinition<unknown, boolean>>> = readonly [
+    propertyKey: keyof VariableDefinitions,
+    variableDefinition: EnvironmentVariableDefinitionType<VariableDefinitions>,
+    resolver: EnvironmentVariableResolver<unknown>
+];

package/dist/esm/environment/variable/definition/environment-variable-entry.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/environment/variable/definition/environment-variable-object-property-type.d.ts

@@ -0,0 +1,4 @@
+import { type EnvironmentVariableDefinition } from './environment-variable-definition.js';
+export type EnvironmentVariableObjectPropertyType<VariableDefinition extends EnvironmentVariableDefinition<any, boolean>> = VariableDefinition extends {
+    readonly parse: (variableValue: string) => infer T;
+} ? T : string;

package/dist/esm/environment/variable/definition/environment-variable-object-property-type.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/environment/variable/definition/environment-variable-object-property.d.ts

@@ -0,0 +1,5 @@
+import { type EnvironmentVariableDefinition } from './environment-variable-definition.js';
+import { type EnvironmentVariableObjectPropertyType } from './environment-variable-object-property-type.js';
+export type EnvironmentVariableObjectProperty<VariableDefinition extends EnvironmentVariableDefinition<unknown, boolean>> = VariableDefinition extends {
+    readonly optional: true;
+} ? EnvironmentVariableObjectPropertyType<VariableDefinition> | undefined : EnvironmentVariableObjectPropertyType<VariableDefinition>;

package/dist/esm/environment/variable/definition/environment-variable-object-property.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/environment/variable/definition/environment-variable-object.d.ts

@@ -0,0 +1,6 @@
+import { type Expand, type ReadonlyRecord } from '@edumalin/platform/typescript';
+import { type EnvironmentVariableDefinition } from './environment-variable-definition.js';
+import { type EnvironmentVariableObjectProperty } from './environment-variable-object-property.js';
+export type EnvironmentVariableObject<VariableDefinitions extends ReadonlyRecord<string, EnvironmentVariableDefinition<unknown, boolean>>> = Expand<{
+    readonly [K in keyof VariableDefinitions]: EnvironmentVariableObjectProperty<VariableDefinitions[K]>;
+}>;

package/dist/esm/environment/variable/definition/environment-variable-object.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/environment/variable/definition/environment-variable-resolver.d.ts

@@ -0,0 +1,3 @@
+export interface EnvironmentVariableResolver<T> {
+    (value: string | undefined, name: string): T;
+}

package/dist/esm/environment/variable/definition/environment-variable-resolver.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/environment/variable/environment-variables-to-platform-environment.d.ts

@@ -0,0 +1,3 @@
+import { type PlatformEnvironment } from '../platform-environment.js';
+import { type EnvironmentVariables } from './environment-variables.js';
+export declare function environmentVariablesToPlatformEnvironment(): (environmentVariables: EnvironmentVariables) => PlatformEnvironment;

package/dist/esm/environment/variable/environment-variables-to-platform-environment.js

@@ -0,0 +1,33 @@
+import { asPlatformEnvironmentId } from '../id/as-platform-environment-id';
+import { asPlatformEnvironmentProvider } from '../provider/as-platform-environment-provider';
+import { asPlatformEnvironmentRegion } from '../region/as-platform-environment-region.js';
+import { asPlatformEnvironmentType } from '../type/as-platform-environment-type.js';
+import { environmentVariablesToValue } from './environment-variables-to-value.js';
+export function environmentVariablesToPlatformEnvironment() {
+    return environmentVariablesToValue({
+        id: {
+            description: 'Edumalin platform environment identifier',
+            name: 'EDU_ENV_ID',
+            parse: asPlatformEnvironmentId,
+        },
+        name: {
+            description: 'Edumalin platform environment name',
+            name: 'EDU_ENV_NAME',
+        },
+        provider: {
+            description: 'Edumalin platform environment provider',
+            name: 'EDU_ENV_PROVIDER',
+            parse: asPlatformEnvironmentProvider,
+        },
+        region: {
+            description: 'Edumalin platform environment region',
+            name: 'EDU_ENV_REGION',
+            parse: asPlatformEnvironmentRegion,
+        },
+        type: {
+            description: 'Edumalin platform environment type',
+            name: 'EDU_ENV_TYPE',
+            parse: asPlatformEnvironmentType,
+        },
+    });
+}

package/dist/esm/environment/variable/environment-variables-to-value.d.ts

@@ -0,0 +1,5 @@
+import { type ReadonlyRecord } from '@edumalin/platform/typescript';
+import { type EnvironmentVariableDefinition } from './definition/environment-variable-definition.js';
+import { type EnvironmentVariableObject } from './definition/environment-variable-object.js';
+import { type EnvironmentVariables } from './environment-variables.js';
+export declare function environmentVariablesToValue<VariableDefinitions extends ReadonlyRecord<string, EnvironmentVariableDefinition<any, boolean>>>(definitions: VariableDefinitions): (environmentVariables: EnvironmentVariables) => EnvironmentVariableObject<VariableDefinitions>;

package/dist/esm/environment/variable/environment-variables-to-value.js

@@ -0,0 +1,9 @@
+import { environmentVariableDefinitionsToResolvers } from './definition/environment-variable-definitions-to-resolvers.js';
+import { environmentVariableEntriesToObject } from './definition/environment-variable-entries-to-object.js';
+export function environmentVariablesToValue(definitions) {
+    return environmentVariables => {
+        const variableResolvers = environmentVariableDefinitionsToResolvers(definitions);
+        const object = variableResolvers.reduce(environmentVariableEntriesToObject(environmentVariables, definition => definition.name), {});
+        return object;
+    };
+}

package/dist/esm/environment/variable/environment-variables-to-values.d.ts

@@ -0,0 +1,7 @@
+import { type ReadonlyRecord } from '@edumalin/platform/typescript';
+import { type EnvironmentVariableDefinition } from './definition/environment-variable-definition.js';
+import { type EnvironmentVariableObject } from './definition/environment-variable-object.js';
+import { type EnvironmentVariables } from './environment-variables.js';
+import { type IndexedEnvironmentVariableDefinitions } from './indexed/indexed-environment-variable-definitions.js';
+export declare function environmentVariablesToValues<VariableDefinitions extends ReadonlyRecord<string, EnvironmentVariableDefinition<unknown, boolean>>>(definitions: IndexedEnvironmentVariableDefinitions<VariableDefinitions>): (environmentVariables: EnvironmentVariables) => ReadonlyArray<EnvironmentVariableObject<VariableDefinitions>>;
+export declare function environmentVariablesToValues<VariableDefinitions extends ReadonlyRecord<string, EnvironmentVariableDefinition<unknown, boolean>>, KeyType, ValueType>(definitions: IndexedEnvironmentVariableDefinitions<VariableDefinitions>, project: (variableObject: EnvironmentVariableObject<VariableDefinitions>) => readonly [key: KeyType, value: ValueType]): (environmentVariables: EnvironmentVariables) => ReadonlyMap<KeyType, ValueType>;

package/dist/esm/environment/variable/environment-variables-to-values.js

@@ -0,0 +1,12 @@
+import { getIndexedEnvironmentVariablesCount } from './indexed/get-indexed-environment-variables-count.js';
+import { indexToIndexedEnvironmentVariables } from './indexed/index-to-indexed-environment-variables.js';
+export function environmentVariablesToValues(definitions, project) {
+    return environmentVariables => {
+        const length = getIndexedEnvironmentVariablesCount(environmentVariables, definitions);
+        const toEnvironmentVariables = indexToIndexedEnvironmentVariables(environmentVariables, definitions);
+        const variableDefinitions = Array.from({ length })
+            .map((_, index) => index)
+            .map(toEnvironmentVariables);
+        return project !== undefined ? new Map(variableDefinitions.map(project)) : variableDefinitions;
+    };
+}

package/dist/esm/environment/variable/environment-variables.d.ts

@@ -0,0 +1,2 @@
+import { type ReadonlyRecord } from '@edumalin/platform/typescript';
+export type EnvironmentVariables = ReadonlyRecord<string, string | undefined>;

package/dist/esm/environment/variable/environment-variables.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/environment/variable/indexed/get-indexed-environment-variables-count.d.ts

@@ -0,0 +1,5 @@
+import { type ReadonlyRecord } from '@edumalin/platform/typescript';
+import { type EnvironmentVariableDefinition } from '../definition/environment-variable-definition.js';
+import { type EnvironmentVariables } from '../environment-variables.js';
+import { type IndexedEnvironmentVariableDefinitions } from './indexed-environment-variable-definitions.js';
+export declare function getIndexedEnvironmentVariablesCount<VariableDefinitions extends ReadonlyRecord<string, EnvironmentVariableDefinition<any, boolean>>>(environmentVariables: EnvironmentVariables, variableDefinitions: IndexedEnvironmentVariableDefinitions<VariableDefinitions>): number;

package/dist/esm/environment/variable/indexed/get-indexed-environment-variables-count.js

@@ -0,0 +1,18 @@
+export function getIndexedEnvironmentVariablesCount(environmentVariables, variableDefinitions) {
+    const { definitions, prefix } = variableDefinitions;
+    const requiredSuffixes = Object.values(definitions)
+        .filter(({ optional }) => optional !== true)
+        .map(({ name }) => name);
+    let count = 0;
+    let validIteration = false;
+    do {
+        const countString = count.toString();
+        const baseVariableName = `${prefix}_${countString}_`;
+        const variableNames = requiredSuffixes.map(suffix => baseVariableName + suffix);
+        validIteration = variableNames.every(variableName => environmentVariables[variableName] !== undefined);
+        if (validIteration) {
+            ++count;
+        }
+    } while (validIteration);
+    return count;
+}

package/dist/esm/environment/variable/indexed/index-to-indexed-environment-variables.d.ts

@@ -0,0 +1,6 @@
+import { type ReadonlyRecord } from '@edumalin/platform/typescript';
+import { type EnvironmentVariableDefinition } from '../definition/environment-variable-definition.js';
+import { type EnvironmentVariableObject } from '../definition/environment-variable-object.js';
+import { type EnvironmentVariables } from '../environment-variables.js';
+import { type IndexedEnvironmentVariableDefinitions } from './indexed-environment-variable-definitions.js';
+export declare function indexToIndexedEnvironmentVariables<VariableDefinitions extends ReadonlyRecord<string, EnvironmentVariableDefinition<any, boolean>>>(environmentVariables: EnvironmentVariables, variableDefinitions: IndexedEnvironmentVariableDefinitions<VariableDefinitions>): (index: number) => EnvironmentVariableObject<VariableDefinitions>;

package/dist/esm/environment/variable/indexed/index-to-indexed-environment-variables.js

@@ -0,0 +1,12 @@
+import { environmentVariableDefinitionsToResolvers } from '../definition/environment-variable-definitions-to-resolvers.js';
+import { environmentVariableEntriesToObject } from '../definition/environment-variable-entries-to-object.js';
+export function indexToIndexedEnvironmentVariables(environmentVariables, variableDefinitions) {
+    const { definitions } = variableDefinitions;
+    const variableResolvers = environmentVariableDefinitionsToResolvers(definitions);
+    return index => {
+        const indexString = index.toString();
+        const prefix = `${variableDefinitions.prefix}_${indexString}_`;
+        const object = variableResolvers.reduce(environmentVariableEntriesToObject(environmentVariables, definition => prefix + definition.name), {});
+        return object;
+    };
+}

package/dist/esm/environment/variable/indexed/indexed-environment-variable-definitions.d.ts

@@ -0,0 +1,6 @@
+import { type ReadonlyRecord } from '@edumalin/platform/typescript';
+import { type EnvironmentVariableDefinition } from '../definition/environment-variable-definition.js';
+export interface IndexedEnvironmentVariableDefinitions<VariableDefinitions extends ReadonlyRecord<string, EnvironmentVariableDefinition<any, boolean>>> {
+    readonly definitions: VariableDefinitions;
+    readonly prefix: string;
+}

package/dist/esm/environment/variable/indexed/indexed-environment-variable-definitions.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/environment/variable/platform-environment-to-environment-variables.d.ts

@@ -0,0 +1,3 @@
+import { type PlatformEnvironment } from '../platform-environment.js';
+import { type EnvironmentVariables } from './environment-variables.js';
+export declare function platformEnvironmentToEnvironmentVariables(platformEnvironment: PlatformEnvironment): EnvironmentVariables;

package/dist/esm/environment/variable/platform-environment-to-environment-variables.js

@@ -0,0 +1,10 @@
+export function platformEnvironmentToEnvironmentVariables(platformEnvironment) {
+    const { id, name, provider, region, type } = platformEnvironment;
+    return {
+        EDU_ENV_ID: id,
+        EDU_ENV_NAME: name,
+        EDU_ENV_PROVIDER: provider,
+        EDU_ENV_REGION: region,
+        EDU_ENV_TYPE: type,
+    };
+}

package/dist/esm/error/creator/error-creator.d.ts

@@ -0,0 +1,4 @@
+import { type TypeCreator } from '@edumalin/platform/typescript';
+export type ErrorCreator<ErrorCode extends string, TypeCreatorType extends TypeCreator<any, any>> = {
+    readonly code: ErrorCode;
+} & TypeCreatorType;