@fjall/util 2.3.0 → 2.4.1

package/dist/.minified

@@ -1 +1 @@
-57 files minified at 2026-05-25T21:30:39.744Z
+57 files minified at 2026-05-26T22:01:15.405Z

package/dist/environments.d.ts

@@ -17,7 +17,37 @@ export declare const STRUCTURAL_ENVIRONMENTS: {
     readonly ROOT: "root";
     readonly PLATFORM: "platform";
 };
+/**
+ * Wire-format environment list including the implicit "root" value.
+ * Use this for schemas and validators that accept a system-assigned root
+ * environment (e.g. quick-create when called after `fjall create org`,
+ * and the public org-config API). User-facing pickers should still use
+ * STANDARD_ENVIRONMENTS — "root" is set by context, not chosen.
+ */
+export declare const STANDARD_ENVIRONMENTS_WITH_ROOT: readonly ["production", "staging", "development", "platform", "compliance", "root"];
+export type StandardEnvironmentWithRoot = (typeof STANDARD_ENVIRONMENTS_WITH_ROOT)[number];
 /** Human-readable labels for each standard environment. */
 export declare const ENVIRONMENT_LABELS: Record<StandardEnvironment, string>;
 /** Returns the human-readable label for an environment, with capitalised fallback. */
 export declare function getEnvironmentLabel(env: string): string;
+/**
+ * AWS account roles in the wire format used across the CLI, webapp API
+ * responses, and the Prisma `AccountRole` enum. This is the SINGLE SOURCE
+ * for the literal values — the webapp's
+ * `app/.server/types/database-enums.ts` rebinds `AccountRole` to these
+ * values, and `database-enums-parity.test.ts` then enforces that the
+ * resulting set matches the Prisma migration SQL CHECK constraint. Adding
+ * a new role here without updating Prisma fails the parity test; renaming
+ * a value here propagates structurally to the webapp.
+ *
+ * Coupling: `environment` and `role` move together via
+ * `environmentToRole`/`roleToEnvironment` in
+ * `webapp/app/.server/utils/orgConfigHelpers.ts`. See
+ * [[STRUCTURAL_ENVIRONMENTS]] for the env-side equivalent.
+ */
+export declare const ACCOUNT_ROLES: {
+    readonly ORGANISATION: "organisation";
+    readonly PLATFORM: "platform";
+    readonly ACCOUNT: "account";
+};
+export type AccountRole = (typeof ACCOUNT_ROLES)[keyof typeof ACCOUNT_ROLES];

package/dist/environments.js

@@ -1 +1 @@
-const o=["production","staging","development","platform","compliance"];function n(t){return o.includes(t)}const r={ROOT:"root",PLATFORM:"platform"},e={production:"Production",staging:"Staging",development:"Development",platform:"Platform",compliance:"Compliance"};function i(t){return n(t)?e[t]:t.charAt(0).toUpperCase()+t.slice(1)}export{e as ENVIRONMENT_LABELS,o as STANDARD_ENVIRONMENTS,r as STRUCTURAL_ENVIRONMENTS,i as getEnvironmentLabel,n as isValidEnvironment};
+const t=["production","staging","development","platform","compliance"];function n(o){return t.includes(o)}const e={ROOT:"root",PLATFORM:"platform"},p=[...t,e.ROOT],r={production:"Production",staging:"Staging",development:"Development",platform:"Platform",compliance:"Compliance"};function c(o){return n(o)?r[o]:o.charAt(0).toUpperCase()+o.slice(1)}const i={ORGANISATION:"organisation",PLATFORM:"platform",ACCOUNT:"account"};export{i as ACCOUNT_ROLES,r as ENVIRONMENT_LABELS,t as STANDARD_ENVIRONMENTS,p as STANDARD_ENVIRONMENTS_WITH_ROOT,e as STRUCTURAL_ENVIRONMENTS,c as getEnvironmentLabel,n as isValidEnvironment};

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { normaliseError, getErrorMessage, hasErrorCode, getErrorCode, getErrorSt
 export { singleton } from "./singleton.js";
 export { DANGEROUS_ENV_VARS, filterDangerousEnvVars, maskSensitiveOutput, parseShellArgs } from "./securityHelpers.js";
 export { sleep } from "./sleep.js";
-export { STANDARD_ENVIRONMENTS, STRUCTURAL_ENVIRONMENTS, type StandardEnvironment, isValidEnvironment, ENVIRONMENT_LABELS, getEnvironmentLabel } from "./environments.js";
+export { STANDARD_ENVIRONMENTS, STANDARD_ENVIRONMENTS_WITH_ROOT, STRUCTURAL_ENVIRONMENTS, type StandardEnvironment, type StandardEnvironmentWithRoot, isValidEnvironment, ENVIRONMENT_LABELS, getEnvironmentLabel, ACCOUNT_ROLES, type AccountRole } from "./environments.js";
 export { RESOURCE_CATEGORIES, type ResourceCategory, categoriseResource, getExpectedDuration, getFriendlyResourceType } from "./resourceCategorisation.js";
 export { parseGitRemoteUrl, type GitProvider, type ParsedGitRemote } from "./gitRemoteParser.js";
 export { abbreviateRegion } from "./regions.js";

package/dist/index.js

@@ -1 +1 @@
-import{DNS_APEX as o,getDomainExportNames as t}from"./domainExports.js";import{toPascalCase as a,toKebab as i,toValidDatabaseName as S,toScreamingSnake as n,capitalise as _,getSafeZoneName as N}from"./caseConversion.js";import{normaliseError as s,getErrorMessage as R,hasErrorCode as p,getErrorCode as f,getErrorStack as A,formatErrorString as g}from"./errorUtils.js";import{singleton as I}from"./singleton.js";import{DANGEROUS_ENV_VARS as x,filterDangerousEnvVars as O,maskSensitiveOutput as d,parseShellArgs as V}from"./securityHelpers.js";import{sleep as M}from"./sleep.js";import{STANDARD_ENVIRONMENTS as P,STRUCTURAL_ENVIRONMENTS as u,isValidEnvironment as c,ENVIRONMENT_LABELS as v,getEnvironmentLabel as H}from"./environments.js";import{RESOURCE_CATEGORIES as b,categoriseResource as L,getExpectedDuration as h,getFriendlyResourceType as G}from"./resourceCategorisation.js";import{parseGitRemoteUrl as X}from"./gitRemoteParser.js";import{abbreviateRegion as y}from"./regions.js";import{SCOPE_VALUES as B}from"./tokenScopes.js";import{deriveRegionsFromOrgConfig as Z,deriveTargets as j,deriveAllTargets as q,findTarget as w,generateTargetName as z}from"./targets.js";import{buildAppConfigPath as Q}from"./appPath.js";import{findInfrastructurePaths as $,findBoundaryPath as ee,isInfrastructureFile as re}from"./findInfrastructurePaths.js";import{inferContainerFromCandidates as te}from"./inferContainerFromCandidates.js";import{RESERVED_APP_NAMES as ae,isReservedAppName as ie}from"./reservedAppNames.js";import{deriveContentHashTag as ne}from"./deriveContentHashTag.js";import{MIGRATION_SNAPSHOT_NAME_PREFIX as Ne,EXPECTED_SCHEMA_VERSION_ENV as me,EXPECTED_SCHEMA_VERSION_TOOL_ENV as se,EXPECTED_CH_SCHEMA_VERSION_ENV as Re,SCHEMA_ADMIN_USER_ENV as pe,SCHEMA_ADMIN_PASSWORD_ENV as fe,PRISMA_MIGRATION_DIR_RE as Ae,CLICKHOUSE_MIGRATION_SKIP_RE as ge}from"./migration/constants.js";export{ge as CLICKHOUSE_MIGRATION_SKIP_RE,x as DANGEROUS_ENV_VARS,o as DNS_APEX,v as ENVIRONMENT_LABELS,Re as EXPECTED_CH_SCHEMA_VERSION_ENV,me as EXPECTED_SCHEMA_VERSION_ENV,se as EXPECTED_SCHEMA_VERSION_TOOL_ENV,Ne as MIGRATION_SNAPSHOT_NAME_PREFIX,Ae as PRISMA_MIGRATION_DIR_RE,ae as RESERVED_APP_NAMES,b as RESOURCE_CATEGORIES,fe as SCHEMA_ADMIN_PASSWORD_ENV,pe as SCHEMA_ADMIN_USER_ENV,B as SCOPE_VALUES,P as STANDARD_ENVIRONMENTS,u as STRUCTURAL_ENVIRONMENTS,y as abbreviateRegion,Q as buildAppConfigPath,_ as capitalise,L as categoriseResource,q as deriveAllTargets,ne as deriveContentHashTag,Z as deriveRegionsFromOrgConfig,j as deriveTargets,O as filterDangerousEnvVars,ee as findBoundaryPath,$ as findInfrastructurePaths,w as findTarget,g as formatErrorString,z as generateTargetName,t as getDomainExportNames,H as getEnvironmentLabel,f as getErrorCode,R as getErrorMessage,A as getErrorStack,h as getExpectedDuration,G as getFriendlyResourceType,N as getSafeZoneName,p as hasErrorCode,te as inferContainerFromCandidates,re as isInfrastructureFile,ie as isReservedAppName,c as isValidEnvironment,d as maskSensitiveOutput,s as normaliseError,X as parseGitRemoteUrl,V as parseShellArgs,I as singleton,M as sleep,i as toKebab,a as toPascalCase,n as toScreamingSnake,S as toValidDatabaseName};
+import{DNS_APEX as o,getDomainExportNames as t}from"./domainExports.js";import{toPascalCase as a,toKebab as S,toValidDatabaseName as _,toScreamingSnake as N,capitalise as i,getSafeZoneName as n}from"./caseConversion.js";import{normaliseError as m,getErrorMessage as s,hasErrorCode as A,getErrorCode as p,getErrorStack as f,formatErrorString as g}from"./errorUtils.js";import{singleton as C}from"./singleton.js";import{DANGEROUS_ENV_VARS as I,filterDangerousEnvVars as x,maskSensitiveOutput as V,parseShellArgs as d}from"./securityHelpers.js";import{sleep as M}from"./sleep.js";import{STANDARD_ENVIRONMENTS as P,STANDARD_ENVIRONMENTS_WITH_ROOT as u,STRUCTURAL_ENVIRONMENTS as c,isValidEnvironment as v,ENVIRONMENT_LABELS as H,getEnvironmentLabel as U,ACCOUNT_ROLES as L}from"./environments.js";import{RESOURCE_CATEGORIES as h,categoriseResource as G,getExpectedDuration as F,getFriendlyResourceType as X}from"./resourceCategorisation.js";import{parseGitRemoteUrl as y}from"./gitRemoteParser.js";import{abbreviateRegion as B}from"./regions.js";import{SCOPE_VALUES as Z}from"./tokenScopes.js";import{deriveRegionsFromOrgConfig as q,deriveTargets as w,deriveAllTargets as z,findTarget as J,generateTargetName as Q}from"./targets.js";import{buildAppConfigPath as $}from"./appPath.js";import{findInfrastructurePaths as re,findBoundaryPath as oe,isInfrastructureFile as te}from"./findInfrastructurePaths.js";import{inferContainerFromCandidates as ae}from"./inferContainerFromCandidates.js";import{RESERVED_APP_NAMES as _e,isReservedAppName as Ne}from"./reservedAppNames.js";import{deriveContentHashTag as ne}from"./deriveContentHashTag.js";import{MIGRATION_SNAPSHOT_NAME_PREFIX as me,EXPECTED_SCHEMA_VERSION_ENV as se,EXPECTED_SCHEMA_VERSION_TOOL_ENV as Ae,EXPECTED_CH_SCHEMA_VERSION_ENV as pe,SCHEMA_ADMIN_USER_ENV as fe,SCHEMA_ADMIN_PASSWORD_ENV as ge,PRISMA_MIGRATION_DIR_RE as Te,CLICKHOUSE_MIGRATION_SKIP_RE as Ce}from"./migration/constants.js";export{L as ACCOUNT_ROLES,Ce as CLICKHOUSE_MIGRATION_SKIP_RE,I as DANGEROUS_ENV_VARS,o as DNS_APEX,H as ENVIRONMENT_LABELS,pe as EXPECTED_CH_SCHEMA_VERSION_ENV,se as EXPECTED_SCHEMA_VERSION_ENV,Ae as EXPECTED_SCHEMA_VERSION_TOOL_ENV,me as MIGRATION_SNAPSHOT_NAME_PREFIX,Te as PRISMA_MIGRATION_DIR_RE,_e as RESERVED_APP_NAMES,h as RESOURCE_CATEGORIES,ge as SCHEMA_ADMIN_PASSWORD_ENV,fe as SCHEMA_ADMIN_USER_ENV,Z as SCOPE_VALUES,P as STANDARD_ENVIRONMENTS,u as STANDARD_ENVIRONMENTS_WITH_ROOT,c as STRUCTURAL_ENVIRONMENTS,B as abbreviateRegion,$ as buildAppConfigPath,i as capitalise,G as categoriseResource,z as deriveAllTargets,ne as deriveContentHashTag,q as deriveRegionsFromOrgConfig,w as deriveTargets,x as filterDangerousEnvVars,oe as findBoundaryPath,re as findInfrastructurePaths,J as findTarget,g as formatErrorString,Q as generateTargetName,t as getDomainExportNames,U as getEnvironmentLabel,p as getErrorCode,s as getErrorMessage,f as getErrorStack,F as getExpectedDuration,X as getFriendlyResourceType,n as getSafeZoneName,A as hasErrorCode,ae as inferContainerFromCandidates,te as isInfrastructureFile,Ne as isReservedAppName,v as isValidEnvironment,V as maskSensitiveOutput,m as normaliseError,y as parseGitRemoteUrl,d as parseShellArgs,C as singleton,M as sleep,S as toKebab,a as toPascalCase,N as toScreamingSnake,_ as toValidDatabaseName};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fjall/util",
-  "version": "2.3.0",
+  "version": "2.4.1",
   "description": "Common utility methods",
   "type": "module",
   "main": "dist/index.js",
@@ -117,5 +117,5 @@
   "engines": {
     "node": ">=22.0.0"
   },
-  "gitHead": "ddb5678e345fe2e480ab2573c2bc0f52c2b2eb16"
+  "gitHead": "164e50a0f9097678d2eb8f03c7a192652de0b0a2"
 }