@fjall/util 0.88.3 → 0.89.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fjall
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/src/Config.d.ts

@@ -1,35 +1,18 @@
-import type { Account } from "@aws-sdk/client-organizations";
-export type { Account } from "@aws-sdk/client-organizations";
-export type ServiceConfig = {
-    id: string;
-    type?: string;
-    version?: number;
-    options?: object;
-    dockerConfig?: {
-        dockerfilePath: string;
-        containerPort: number;
-    };
-    apiApplicationId?: string;
-};
+import { z } from "zod";
 export type ProviderAccount = {
     id: string;
     name: string;
     environment: string;
     managed?: boolean;
 };
-export type OidcConnection = {
-    roleArn: string;
-    externalId: string;
-};
 export type Profile = {
-    type: "iam" | "sso" | "oidc";
+    type: "sso" | "oidc";
     region: string;
     ssoAccountId?: string;
     ssoRoleName?: string;
     ssoSession?: string;
     oidcRoleArn?: string;
     oidcProviderArn?: string;
-    credentialSource?: string;
     roleArn?: string;
     roleSessionName?: string;
 };
@@ -37,73 +20,69 @@ export type SSOSession = {
     ssoRegion: string;
     ssoStartUrl: string;
 };
-type RootConfig = {
-    version?: number;
-    development?: boolean;
-    services?: {
-        [key: string]: ServiceConfig;
-    };
-    providerAccounts?: ProviderAccount[];
-    primaryRegion?: string;
-    secondaryRegions?: string[];
-    disasterRecoveryRegion?: string;
-    currentProfile?: string;
-    profiles?: {
-        [key: string]: Profile;
-    };
-    ssoSessions?: {
-        [key: string]: SSOSession;
-    };
-    organisationId?: string;
-    organisationName?: string;
-    organisationEmail?: string;
-    oidcIssuerUrl?: string;
-    oidcConnections?: {
-        [accountId: string]: OidcConnection;
-    };
-    rootOidcRoleArn?: string;
-};
-type CostAllocationTags = {
-    TagKey: string;
-    Status: string;
-};
+declare const DeployStageSchema: z.ZodObject<{
+    account: z.ZodString;
+    regions: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type DeployStage = z.infer<typeof DeployStageSchema>;
+declare const DomainConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        apex: "apex";
+        delegated: "delegated";
+    }>;
+    parentDomain: z.ZodOptional<z.ZodString>;
+    account: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type DomainConfig = z.infer<typeof DomainConfigSchema>;
+declare const RootConfigSchema: z.ZodObject<{
+    version: z.ZodOptional<z.ZodNumber>;
+    generatorVersion: z.ZodOptional<z.ZodString>;
+    deploy: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        account: z.ZodString;
+        regions: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>>;
+    activeStage: z.ZodOptional<z.ZodString>;
+    domains: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            apex: "apex";
+            delegated: "delegated";
+        }>;
+        parentDomain: z.ZodOptional<z.ZodString>;
+        account: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+type RootConfig = z.infer<typeof RootConfigSchema>;
 /**
- * Config class for loading and saving fjall-config.json file
+ * Config class for loading and saving per-app fjall-config.json files.
+ * Each app has its own config at fjall/<app>/fjall-config.json.
+ * Stores deploy mapping, active stage, domains, and generator version.
+ * Org-level config (accounts, regions, OIDC) is served by OrgConfigClient from the API.
  */
-export type OrgLevelConfig = {
-    primaryRegion?: string;
-    secondaryRegions?: string[];
-    disasterRecoveryRegion?: string;
-    providerAccounts?: ProviderAccount[];
-    ssoSessions?: {
-        [key: string]: SSOSession;
-    };
-    rootOidcRoleArn?: string;
-};
 export declare class Config {
     rootConfig: RootConfig;
-    existingAccountsConfig: Account[];
-    costAllocationTagsConfig: CostAllocationTags[];
-    constructor(rootConfig?: RootConfig, existingAccountsConfig?: Account[], costAllocationTagsConfig?: CostAllocationTags[]);
-    isDevelopment(): boolean;
+    private configPath;
+    constructor(rootConfig?: RootConfig, configPath?: string);
     /**
-     * Find the fjall config directory by walking up the directory tree
-     * @returns The path to the fjall config directory or null if not found
+     * Find the fjall directory by walking up the directory tree
+     */
+    private static findFjallDirectory;
+    /**
+     * Find the config directory for a specific app or the legacy root config.
+     * When appName is provided, looks for fjall/<appName>/fjall-config.json.
+     * When omitted, falls back to legacy fjall/fjall-config.json or direct fjall-config.json.
      */
     private static findConfigDirectory;
     /**
      * Load config file into memory as a raw JSON string
-     * @param configFile - Path to the config file
-     * @returns Config as JSON string or NULL if no config file accessible
      */
     private static loadConfigFile;
     /**
-     * Load configuration from file
-     *
-     * @returns Loaded configuration
-     * @throws Error if config file cannot be parsed or fails schema validation
+     * Load configuration from file.
+     * @param appName - Optional app name to load config for a specific app
      */
-    static loadConfig(): Config;
+    static loadConfig(appName?: string): Config;
     /**
      * Format a Zod error into a readable error message
      */
@@ -111,83 +90,25 @@ export declare class Config {
     /**
      * Save configuration to file
      */
-    saveConfig(): void;
-    /**
-     * Add a new service to the config file
-     * @param serviceKey Name/key of the service
-     * @param config Service configuration properties
-     */
-    addService(serviceKey: string, config: ServiceConfig): void;
-    getServiceConfig(serviceKey: string): ServiceConfig | null;
-    addProviderAccount(account: ProviderAccount): void;
-    getProviderAccount(accountName: string): ProviderAccount | undefined;
-    getProviderAccountById(accountId: string): ProviderAccount | undefined;
-    /**
-     * Get provider account by environment type
-     * @param environment The environment type (e.g., 'platform', 'staging', 'production')
-     * @returns The provider account with the specified environment or undefined if not found
-     */
-    getAccountByEnvironment(environment: string): ProviderAccount | undefined;
-    /**
-     * Sets the existing accounts list. This should be called by AccountService
-     * after it fetches the accounts from AWS.
-     * @param accounts List of AWS accounts from Organizations API
-     */
-    setExistingAccountsList(accounts: Account[]): void;
-    getExistingAccounts(): Account[];
-    setPrimaryRegion(region: string): void;
-    setSecondaryRegions(regions: string[]): void;
-    setDisasterRecoveryRegion(region: string): void;
-    getPrimaryRegion(): string | undefined;
-    getSecondaryRegions(): string[] | undefined;
-    getDisasterRecoveryRegion(): string | undefined;
-    getAllRegions(): string[];
-    /**
-     * Sets the cost allocation tags list. This should be called by AccountService
-     * after it fetches the tags from AWS Cost Explorer.
-     * @param tags List of cost allocation tags
-     */
-    setCostAllocationTagsList(tags: CostAllocationTags[]): void;
-    getCostAllocationTags(): CostAllocationTags[];
+    saveConfig(appName?: string): void;
     /**
      * Get the fjall config directory path
-     * @returns The path to the fjall config directory or null if not found
-     */
-    static getConfigDirectory(): string | null;
-    /**
-     * Profile management methods
-     */
-    /**
-     * Gets the name of the currently active profile.
-     * @returns The current profile name, or undefined if no profile is set
-     */
-    getCurrentProfile(): string | undefined;
-    /**
-     * Sets the currently active profile.
-     * @param name The name of the profile to set as current
      */
-    setCurrentProfile(name: string): void;
+    static getConfigDirectory(appName?: string): string | null;
     /**
-     * Retrieves a profile by name.
-     * @param name The name of the profile to retrieve
-     * @returns The profile configuration, or undefined if not found
+     * Discover all app names by scanning fjall/<app>/fjall-config.json
      */
-    getProfile(name: string): Profile | undefined;
-    getAllProfileNames(): string[];
-    addProfile(name: string, profile: Profile): void;
-    removeProfile(name: string): void;
-    getSSOSession(name: string): SSOSession | undefined;
-    addSSOSession(name: string, session: SSOSession): void;
-    getOrgLevelConfig(): OrgLevelConfig;
-    getOrganisationId(): string | undefined;
-    setOrganisationId(id: string): void;
-    getOrganisationName(): string | undefined;
-    setOrganisationName(name: string): void;
-    getOrganisationEmail(): string | undefined;
-    setOrganisationEmail(email: string): void;
-    getOidcIssuerUrl(): string | undefined;
-    setOidcIssuerUrl(url: string): void;
-    getOidcConnection(accountId: string): OidcConnection | undefined;
-    setOidcConnection(accountId: string, connection: OidcConnection): void;
-    setOrgLevelConfig(config: OrgLevelConfig): void;
+    static discoverApps(): string[];
+    getDeployStages(): Record<string, DeployStage>;
+    getDeployStage(name: string): DeployStage | undefined;
+    setDeployStage(name: string, stage: DeployStage): void;
+    removeDeployStage(name: string): boolean;
+    getActiveStage(): string | undefined;
+    setActiveStage(name: string): void;
+    getDomains(): DomainConfig[];
+    setDomains(domains: DomainConfig[]): void;
+    addDomain(domain: DomainConfig): void;
+    getDomain(name: string): DomainConfig | undefined;
+    removeDomain(name: string): boolean;
 }
+export {};