@adminide-stack/core 13.5.3-alpha.58 → 13.5.3-alpha.64

package/lib/index.js

@@ -1 +1 @@
-export{AUTH_RETURN_TO_PARAM,NATS_HEMERA_ADMINIDE_WORKSPACE,NATS_HEMERA_ADMINIDE_WORKSPACE_UPDATER}from'./constants/constants.js';export{ALL_COUNTRIES_LIMIT,COMMON_COUNTRIES,getCommonCountriesCriteria}from'./constants/countries.js';export{DEFAULT_CPU,DEFAULT_HDD,DEFAULT_RAM}from'./constants/default-workspace-config.js';export{DEFAULT_CONTRIBUTION_TENANT_ID,DEFAULT_TENANT_ID,GLOBAL_CONFIGURATION_FILE,OVERRIDE_IDENTIFIER_PATTERN,OVERRIDE_PATTERN_WITH_SUBSTITUTION,OVERRIDE_PROPERTY,OVERRIDE_PROPERTY_PATTERN,SETTINGS_OVERRRIDE_NODE_ID,USER_CONFIGURATION_FILE}from'./constants/configuration.js';export{ASANA_WEBHOOK_ENDPOINT,ORG_BASE_PATH,ORG_STD_ROUTES}from'./constants/urls.js';export{IntegrationConfigurationRoute,hasOrganizationContext}from'./constants/routes.js';export{BillingPlan}from'./constants/billing-plan.js';export{DEFAULT_ADDON_CATEGORY_TAG_TYPE_ID,DEFAULT_ANONYMOUS_ACCOUNT_ID,DEFAULT_ANONYMOUS_EMAIL,DEFAULT_ANONYMOUS_PUBLISHER_DISPLAY_NAME,DEFAULT_ANONYMOUS_PUBLISHER_ID,DEFAULT_ANONYMOUS_PUBLISHER_NAME,DEFAULT_ANONYMOUS_USERNAME,DEFAULT_APP_ID,DEFAULT_APP_TENANT_ID,DEFAULT_DEVELOPMENT_TAG_ID,DEFAULT_ENVIRONMENT_TAG_TYPE_ID,DEFAULT_ISSUE_TAG_TYPE_ID,DEFAULT_PRODUCTION_TAG_ID,DEFAULT_STAGING_TAG_ID,DEFAULT_SYSTEM_ACCOUNT_ID,DEFAULT_SYSTEM_EMAIL,DEFAULT_SYSTEM_USERNAME,VAULT_DEFAULT_DIR}from'./constants/defaultIds.js';export{LOCAL_MACHINE_SCOPES,ORGANIZATION_SCOPES,REMOTE_MACHINE_SCOPES,RESOURCE_SCOPES,USER_SCOPES}from'./interfaces/configuration/configuration.js';export{ApplicationState,IOrganizationContext,IOrganizationResource}from'./interfaces/organization/organization-context.js';export{Extensions}from'@workbench-stack/core/lib/constants/extensions.js';export{LifecyclePhase,ShutdownReason,StartupKind}from'@workbench-stack/core/lib/interfaces/lifecycle/lifecycle.js';export{PermissionBehavior}from'./interfaces/permissions.js';export*from'common/lib/generated/generated-models.js';export{getFilteredRoutes,getFilteredTabs,getTtl}from'./utils/utils.js';export{configureForCurrentBranch,configureForUpcomingBranch,convertToResourceUri,createDirectResourceUri,createStandardResourceUri,generateHashId,normalizeResourceUri,resourcePath,setupResourceUriConfiguration,strictConvertToResourceUri}from'./utils/resourceUriConversion.js';export{generateApplicationUri,generateMachineUri,generateOrgUri,generateOrgUriById,generateProxyUserUri,generateResourceUri,generateUri,generateUserUri}from'./utils/generate-uri.js';export{RESERVED_CDECODE_PARAMS,determineConfigurationTarget,formatResourceIdWithIdField,generateCdecodeUri,isReservedCdecodeParam,parseCdecodeUri,parseResourceIdWithIdField,validateUserQueryParams}from'./utils/cdecodeUri.js';export{generateApplicationRoleResource,generateRegisteredRoleURI}from'./utils/roles-utils.js';export{getScopes}from'./utils/configuration-utils.js';export{omitDeep}from'./utils/omit-deep.js';export{generateSettingsId}from'./utils/generated-settings-id.js';export{validateEmail}from'./utils/validations.js';export{toMilliSeconds}from'./utils/date-utils.js';export{expand,flatten,flattenObject}from'./utils/flatten-utils.js';export{generateUserAlias}from'./utils/generateUserAlias.js';export{getUserAlias}from'./utils/getUserAlias.js';export{getLogger}from'./utils/getLogger.js';export{FileNameToTarget,SettingsFileName,determineSchemaFromUri,extractExtensionNameFromFragment,extractExtensionNameFromPathSegments,extractFileNameFromPath,generateDefaultConfigurationUri,generateEffectiveExtensionsUri,generateInstalledExtensionsUri,generatePublicExtensionsUri,generateSystemDefaultsUri,getDefaultSettingsURI,getEditableSettingsURI,getOpenSettings,getSettingsFileName,getTargetFromFileName,getTargetFromSettingsUri,isDefaultSettingsUri,mapAuthorityToSchemaId,mapFragmentToSchemaId,mapSchemaIdToAuthority,mapStringToSchemaId,parseDefaultConfigurationUri,parseExtensionFromDefaultSettingsUri}from'./utils/preferenceUri.js';export{reviveUri}from'./utils/reviveUri.js';export{buildExtensionNodeContext,buildExtensionSettingsNodeContext,buildNodeContext,buildPermissionNodeContext,buildPolicyNodeContext,buildRoleNodeContext,buildUiLayoutNodeContext,isSystemContribution}from'./utils/nodeContext.js';export{splitCdecodeUri,splitOrgUri}from'./utils/splitCdecodeUri.js';export{generatePath}from'./utils/generatePath.js';export{resolveContextPlaceholders,resolvePlaceholdersSync,resolveResourceParamsPlaceholders}from'./utils/resolveContextPlaceholders.js';export{SLUG_REGEX,SLUG_VALIDATION_MESSAGE,SLUG_VALIDATOR_CONFIG,getSlugValidationMessage,isValidSlug,slugValidator,slugify}from'./utils/slug-utils.js';export{pubSub}from'./utils/pubsub-utility.js';export{Disposable,DisposableCollection}from'./core/disposable.js';export{BaseDisposable}from'./core/BaseDisposable.js';export{Emitter,Event,WaitUntilEvent}from'./core/event.js';export{Path}from'./core/path.js';export{OrganizationContext,OrganizationResource,toOrganizationResource,toOrganizationResources,toUri}from'./core/organization/organization.js';export{OrganizationConfiguration}from'./core/organization/configuration.js';export{isOrganizationIdentifier,isRawFileOrganizationResource,isRawUriOrganizationResource,isSingleResourceOrganizationIdentifier,isSingleResourceOrganizationInitializationPayload}from'./core/organization/helpers/organization-helpers.js';export{ConfigurationTargetConfigurationMapper,ConfigurationTargetToString,SettingsTypeToConfiguraitonTarget,addToValueTree,getConfigurationValue,getMigratedSettingValue,isConfigurationOverrides,keyFromOverrideIdentifier,merge,overrideIdentifierFromKey,removeFromValueTree,toValuesTree}from'./core/configurations/helpers/configuration.js';export{ConfigurationModel}from'./core/configurations/models/ConfigurationModel.js';export{EnhancedConfigurationModel}from'./core/configurations/models/ConfigurationModelWrapper.js';export{Configuration,OVERRIDE_PROPERTY_REGEX,compare,overrideIdentifiersFromKey}from'./core/configurations/configuration.js';export{ConfigurationChangeEvent}from'./core/configurations/events/ConfigurationChangeEvent.js';export{parseConfiguration}from'./core/configurations/parser/configurationParser.js';export{createConfigurationModel,extractConfiguration,extractConfigurationWithModel,extractIdentifiersFromKey,getBaseKeys,getOverrideByIdentifier,getOverrideKeys,hasOverrides,isBracketKey,removeOverrideKeys}from'./core/configurations/utils/configurationExtractor.js';export{CdeCodeProvider}from'./core/in-memory-providers/cde-code-provider.js';export{AuthError}from'./errors/auth-error.js';export{AbstractOrganizationContextService}from'./services/abstract-organization-context-service.js';export{AbstractOrganizationConfigurationClientService}from'./services/abstract-configuration.js';export{PreDefineAccountPermissions}from'./modules/account-api/enums/index.js';export{BillingModules,PreDefineBillingPermissions}from'./modules/billing-api/enums/index.js';export{URI,uriToFsPath}from'@vscode-alt/monaco-editor/esm/vs/base/common/uri.js';export{ConfigurationScope}from'common';//# sourceMappingURL=index.js.map
+export{AUTH_RETURN_TO_PARAM,NATS_HEMERA_ADMINIDE_WORKSPACE,NATS_HEMERA_ADMINIDE_WORKSPACE_UPDATER}from'./constants/constants.js';export{ALL_COUNTRIES_LIMIT,COMMON_COUNTRIES,getCommonCountriesCriteria}from'./constants/countries.js';export{DEFAULT_CPU,DEFAULT_HDD,DEFAULT_RAM}from'./constants/default-workspace-config.js';export{DEFAULT_CONTRIBUTION_TENANT_ID,DEFAULT_TENANT_ID,GLOBAL_CONFIGURATION_FILE,OVERRIDE_IDENTIFIER_PATTERN,OVERRIDE_PATTERN_WITH_SUBSTITUTION,OVERRIDE_PROPERTY,OVERRIDE_PROPERTY_PATTERN,SETTINGS_OVERRRIDE_NODE_ID,USER_CONFIGURATION_FILE}from'./constants/configuration.js';export{ASANA_WEBHOOK_ENDPOINT,ORG_BASE_PATH,ORG_STD_ROUTES}from'./constants/urls.js';export{IntegrationConfigurationRoute,hasOrganizationContext}from'./constants/routes.js';export{BillingPlan}from'./constants/billing-plan.js';export{DEFAULT_ADDON_CATEGORY_TAG_TYPE_ID,DEFAULT_ANONYMOUS_ACCOUNT_ID,DEFAULT_ANONYMOUS_EMAIL,DEFAULT_ANONYMOUS_PUBLISHER_DISPLAY_NAME,DEFAULT_ANONYMOUS_PUBLISHER_ID,DEFAULT_ANONYMOUS_PUBLISHER_NAME,DEFAULT_ANONYMOUS_USERNAME,DEFAULT_APP_ID,DEFAULT_APP_TENANT_ID,DEFAULT_DEVELOPMENT_TAG_ID,DEFAULT_ENVIRONMENT_TAG_TYPE_ID,DEFAULT_ISSUE_TAG_TYPE_ID,DEFAULT_PRODUCTION_TAG_ID,DEFAULT_STAGING_TAG_ID,DEFAULT_SYSTEM_ACCOUNT_ID,DEFAULT_SYSTEM_EMAIL,DEFAULT_SYSTEM_USERNAME,VAULT_DEFAULT_DIR}from'./constants/defaultIds.js';export{LOCAL_MACHINE_SCOPES,ORGANIZATION_SCOPES,REMOTE_MACHINE_SCOPES,RESOURCE_SCOPES,USER_SCOPES}from'./interfaces/configuration/configuration.js';export{ApplicationState,IOrganizationContext,IOrganizationResource}from'./interfaces/organization/organization-context.js';export{Extensions}from'@workbench-stack/core/lib/constants/extensions.js';export{LifecyclePhase,ShutdownReason,StartupKind}from'@workbench-stack/core/lib/interfaces/lifecycle/lifecycle.js';export{PermissionBehavior}from'./interfaces/permissions.js';export*from'common/lib/generated/generated-models.js';export{getFilteredRoutes,getFilteredTabs,getTtl}from'./utils/utils.js';export{configureForCurrentBranch,configureForUpcomingBranch,convertToResourceUri,createDirectResourceUri,createStandardResourceUri,generateHashId,normalizeResourceUri,resourcePath,setupResourceUriConfiguration,strictConvertToResourceUri}from'./utils/resourceUriConversion.js';export{generateApplicationUri,generateMachineUri,generateOrgUri,generateOrgUriById,generateProxyUserUri,generateResourceUri,generateUri,generateUserUri}from'./utils/generate-uri.js';export{RESERVED_CDECODE_PARAMS,determineConfigurationTarget,formatResourceIdWithIdField,generateCdecodeUri,isReservedCdecodeParam,parseCdecodeUri,parseResourceIdWithIdField,validateUserQueryParams}from'./utils/cdecodeUri.js';export{generateApplicationRoleResource,generateRegisteredRoleURI}from'./utils/roles-utils.js';export{getScopes}from'./utils/configuration-utils.js';export{omitDeep}from'./utils/omit-deep.js';export{generateSettingsId}from'./utils/generated-settings-id.js';export{validateEmail}from'./utils/validations.js';export{toMilliSeconds}from'./utils/date-utils.js';export{expand,flatten,flattenObject}from'./utils/flatten-utils.js';export{generateUserAlias}from'./utils/generateUserAlias.js';export{getUserAlias}from'./utils/getUserAlias.js';export{getLogger}from'./utils/getLogger.js';export{FileNameToTarget,SettingsFileName,determineSchemaFromUri,extractExtensionNameFromFragment,extractExtensionNameFromPathSegments,extractFileNameFromPath,generateDefaultConfigurationUri,generateEffectiveExtensionsUri,generateInstalledExtensionsUri,generatePublicExtensionsUri,generateSystemDefaultsUri,getDefaultSettingsURI,getEditableSettingsURI,getOpenSettings,getSettingsFileName,getTargetFromFileName,getTargetFromSettingsUri,isDefaultSettingsUri,mapAuthorityToSchemaId,mapFragmentToSchemaId,mapSchemaIdToAuthority,mapStringToSchemaId,parseDefaultConfigurationUri,parseExtensionFromDefaultSettingsUri}from'./utils/preferenceUri.js';export{reviveUri}from'./utils/reviveUri.js';export{buildExtensionNodeContext,buildExtensionSettingsNodeContext,buildNodeContext,buildPermissionNodeContext,buildPolicyNodeContext,buildRoleNodeContext,buildUiLayoutNodeContext,isSystemContribution}from'./utils/nodeContext.js';export{CONTEXT_ROOT,configurationContextPath,contextPath}from'./utils/context-path.js';export{splitCdecodeUri,splitOrgUri}from'./utils/splitCdecodeUri.js';export{generatePath}from'./utils/generatePath.js';export{resolveContextPlaceholders,resolvePlaceholdersSync,resolveResourceParamsPlaceholders}from'./utils/resolveContextPlaceholders.js';export{SLUG_REGEX,SLUG_VALIDATION_MESSAGE,SLUG_VALIDATOR_CONFIG,getSlugValidationMessage,isValidSlug,slugValidator,slugify}from'./utils/slug-utils.js';export{pubSub}from'./utils/pubsub-utility.js';export{Disposable,DisposableCollection}from'./core/disposable.js';export{BaseDisposable}from'./core/BaseDisposable.js';export{Emitter,Event,WaitUntilEvent}from'./core/event.js';export{Path}from'./core/path.js';export{OrganizationContext,OrganizationResource,toOrganizationResource,toOrganizationResources,toUri}from'./core/organization/organization.js';export{OrganizationConfiguration}from'./core/organization/configuration.js';export{isOrganizationIdentifier,isRawFileOrganizationResource,isRawUriOrganizationResource,isSingleResourceOrganizationIdentifier,isSingleResourceOrganizationInitializationPayload}from'./core/organization/helpers/organization-helpers.js';export{ConfigurationTargetConfigurationMapper,ConfigurationTargetToString,SettingsTypeToConfiguraitonTarget,addToValueTree,getConfigurationValue,getMigratedSettingValue,isConfigurationOverrides,keyFromOverrideIdentifier,merge,overrideIdentifierFromKey,removeFromValueTree,toValuesTree}from'./core/configurations/helpers/configuration.js';export{ConfigurationModel}from'./core/configurations/models/ConfigurationModel.js';export{EnhancedConfigurationModel}from'./core/configurations/models/ConfigurationModelWrapper.js';export{Configuration,OVERRIDE_PROPERTY_REGEX,compare,overrideIdentifiersFromKey}from'./core/configurations/configuration.js';export{ConfigurationChangeEvent}from'./core/configurations/events/ConfigurationChangeEvent.js';export{parseConfiguration}from'./core/configurations/parser/configurationParser.js';export{createConfigurationModel,extractConfiguration,extractConfigurationWithModel,extractIdentifiersFromKey,getBaseKeys,getOverrideByIdentifier,getOverrideKeys,hasOverrides,isBracketKey,removeOverrideKeys}from'./core/configurations/utils/configurationExtractor.js';export{CdeCodeProvider}from'./core/in-memory-providers/cde-code-provider.js';export{AuthError}from'./errors/auth-error.js';export{AbstractOrganizationContextService}from'./services/abstract-organization-context-service.js';export{AbstractOrganizationConfigurationClientService}from'./services/abstract-configuration.js';export{PreDefineAccountPermissions}from'./modules/account-api/enums/index.js';export{BillingModules,PreDefineBillingPermissions}from'./modules/billing-api/enums/index.js';export{URI,uriToFsPath}from'@vscode-alt/monaco-editor/esm/vs/base/common/uri.js';export{ConfigurationScope}from'common';//# sourceMappingURL=index.js.map

package/lib/utils/context-path.d.ts

@@ -0,0 +1,37 @@
+import { ContributionSchemaId, IConfigurationsFlattenedKeys } from 'common';
+/**
+ * Helpers for building `$context?.…` placeholder strings used by SSR loader
+ * `resourceParams` (e.g. in route `compute` specs). These placeholders are
+ * resolved at load time against the resolved loader context.
+ *
+ * Hand-writing the dotted path as a raw string (e.g.
+ * `'$context?.configurationsBySchemaId?.configuration?.account?.default?.organization'`)
+ * is error-prone: a wrong segment (singular `configurationBySchemaId`, a renamed
+ * config key, etc.) silently resolves to `undefined` at runtime and breaks the
+ * dependent query. These helpers keep the structural segments correct and map the
+ * configuration key to {@link IConfigurationsFlattenedKeys}, so typos / renamed
+ * keys fail at compile time instead.
+ */
+/** Root token the loader resolves `$context?.…` placeholders against. */
+export declare const CONTEXT_ROOT = "$context";
+/**
+ * Join raw segments into a `$context?.a?.b?.c` placeholder (optional-chained).
+ * Each segment may itself be a dotted path and is split accordingly.
+ *
+ * Prefer {@link configurationContextPath} for configuration values — use this
+ * only for context paths outside the `configurationsBySchemaId` tree.
+ */
+export declare function contextPath(...segments: Array<string | number>): string;
+/**
+ * Build a type-safe `$context?.…` placeholder that resolves a configuration value
+ * from the loader context (`configurationsBySchemaId.<schemaId>.<key>`).
+ *
+ * `key` is constrained to {@link IConfigurationsFlattenedKeys} (the flattened keys
+ * of `IPreferences`), so a renamed/typo'd config key is a compile error rather than
+ * a runtime `undefined`.
+ *
+ * @example
+ *   configurationContextPath(ContributionSchemaId.Configuration, 'account.default.organization')
+ *   // => '$context?.configurationsBySchemaId?.configuration?.account?.default?.organization'
+ */
+export declare function configurationContextPath(schemaId: ContributionSchemaId, key: IConfigurationsFlattenedKeys): string;

package/lib/utils/context-path.js

@@ -0,0 +1,43 @@
+/**
+ * Helpers for building `$context?.…` placeholder strings used by SSR loader
+ * `resourceParams` (e.g. in route `compute` specs). These placeholders are
+ * resolved at load time against the resolved loader context.
+ *
+ * Hand-writing the dotted path as a raw string (e.g.
+ * `'$context?.configurationsBySchemaId?.configuration?.account?.default?.organization'`)
+ * is error-prone: a wrong segment (singular `configurationBySchemaId`, a renamed
+ * config key, etc.) silently resolves to `undefined` at runtime and breaks the
+ * dependent query. These helpers keep the structural segments correct and map the
+ * configuration key to {@link IConfigurationsFlattenedKeys}, so typos / renamed
+ * keys fail at compile time instead.
+ */
+/** Root token the loader resolves `$context?.…` placeholders against. */
+const CONTEXT_ROOT = '$context';
+/** Loader-context segment holding resolved configurations keyed by schemaId. */
+const CONFIGURATIONS_BY_SCHEMA_ID = 'configurationsBySchemaId';
+/**
+ * Join raw segments into a `$context?.a?.b?.c` placeholder (optional-chained).
+ * Each segment may itself be a dotted path and is split accordingly.
+ *
+ * Prefer {@link configurationContextPath} for configuration values — use this
+ * only for context paths outside the `configurationsBySchemaId` tree.
+ */
+function contextPath(...segments) {
+  const parts = segments.flatMap(segment => String(segment).split('.')).filter(Boolean);
+  return [CONTEXT_ROOT, ...parts].join('?.');
+}
+/**
+ * Build a type-safe `$context?.…` placeholder that resolves a configuration value
+ * from the loader context (`configurationsBySchemaId.<schemaId>.<key>`).
+ *
+ * `key` is constrained to {@link IConfigurationsFlattenedKeys} (the flattened keys
+ * of `IPreferences`), so a renamed/typo'd config key is a compile error rather than
+ * a runtime `undefined`.
+ *
+ * @example
+ *   configurationContextPath(ContributionSchemaId.Configuration, 'account.default.organization')
+ *   // => '$context?.configurationsBySchemaId?.configuration?.account?.default?.organization'
+ */
+function configurationContextPath(schemaId, key) {
+  return contextPath(CONFIGURATIONS_BY_SCHEMA_ID, schemaId, key);
+}export{CONTEXT_ROOT,configurationContextPath,contextPath};//# sourceMappingURL=context-path.js.map

package/lib/utils/context-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-path.js","sources":["../../src/utils/context-path.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEA;;;;;;;;;;;;AAYG;AAEH;AACO,MAAM,YAAY,GAAG;AAE5B;AACA,MAAM,2BAA2B,GAAG,0BAA0B;AAE9D;;;;;;AAMG;AACG,SAAU,WAAW,CAAC,GAAG,QAAgC,EAAA;QAC3D,KAAM,GAAK,QAAG,CAAA,OAAS,CAAA,OAAS,IAAO,MAAK,CAAA,cAAgB,CAAA,GAAK,CAAC,CAAA,CAAA,MAAM,CAAA,OAAO,CAAA;SAC/E,CAAA,YAAQ,EAAY,GAAE,KAAG,CAAA,CAAK,IAAE,CAAA,IAAK,CAAA;AACzC;AAEA;;;;;;;;;;;AAWG;AACG,SAAU,wBAAwB,CAAC,QAA8B,EAAE,GAAiC,EAAA;SACtG,WAAO,CAAA,2BAAY,EAA2B,UAAU,GAAE,CAAA;AAC9D"}

package/lib/utils/context-path.test.d.ts

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

package/lib/utils/index.d.ts

@@ -15,6 +15,7 @@ export * from './getLogger';
 export * from './preferenceUri';
 export * from './reviveUri';
 export * from './nodeContext';
+export * from './context-path';
 export * from './splitCdecodeUri';
 export * from './generatePath';
 export * from './resolveContextPlaceholders';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@adminide-stack/core",
-    "version": "13.5.3-alpha.58",
+    "version": "13.5.3-alpha.64",
     "description": "AdminIDE core for higher packages to depend on",
     "license": "UNLICENSED",
     "author": "adminide-stack-user",
@@ -30,13 +30,13 @@
         "vscode-uri": "^3.0.8"
     },
     "devDependencies": {
-        "common": "13.5.3-alpha.58"
+        "common": "13.5.3-alpha.63"
     },
     "peerDependencies": {
         "@common-stack/server-core": ">=0.5.21",
         "vscode-uri": "*"
     },
-    "gitHead": "ee5fa901ef77e58da96eda74947c2f0eaa0bfda3",
+    "gitHead": "812d820eee990545fdc84157083d93b1403497d7",
     "typescript": {
         "definition": "lib/index.d.ts"
     }