@camunda/ccma-shared-types 7.5.0 → 7.7.0

package/dist/types/C8ClusterComponentVersions.type.d.ts

@@ -21,5 +21,15 @@ export interface MutableZeebeClusterVersionsDto {
     connectorBridgeEnvVars?: string;
     gatewayEnvVars?: string;
 }
+/**
+ * The mutable versions that are image references.
+ *
+ * The approval use case `change-generation-versions` writes these two and
+ * never an env var field. An env var text can hold a secret, and the payload
+ * of a request is a row that every approver reads and that the table keeps.
+ * The env var fields change on the direct Edit, as before.
+ */
+export declare const GENERATION_IMAGE_VERSION_KEYS: readonly ["zeebeAnalytics", "elasticSearchCurator"];
+export type GenerationImageVersionsDto = Pick<MutableZeebeClusterVersionsDto, (typeof GENERATION_IMAGE_VERSION_KEYS)[number]>;
 export declare const MutableThings: string[];
 export declare const AllThings: string[];

package/dist/types/C8ClusterComponentVersions.type.js

@@ -6,6 +6,10 @@ const ImmutableThings = [
   "optimize",
   "connectorBridge"
 ];
+const GENERATION_IMAGE_VERSION_KEYS = [
+  "zeebeAnalytics",
+  "elasticSearchCurator"
+];
 const MutableThings = [
   "zeebeAnalytics",
   "elasticSearchCurator",
@@ -21,6 +25,7 @@ const MutableThings = [
 const AllThings = ImmutableThings.concat(MutableThings);
 export {
   AllThings,
+  GENERATION_IMAGE_VERSION_KEYS,
   ImmutableThings,
   MutableThings
 };

package/dist/types/C8ClusterComponentVersions.type.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/types/C8ClusterComponentVersions.type.ts"],
-  "sourcesContent": ["/*\n * Copyright Camunda Services GmbH and/or licensed to Camunda Services GmbH\n * under one or more contributor license agreements. Licensed under a commercial license.\n * You may not use this file except in compliance with the commercial license.\n */\n\nexport interface ZeebeClusterVersionsDto\n  extends MutableZeebeClusterVersionsDto,\n    ImmutableZeebeClusterVersionsDto {}\n\nexport interface ImmutableZeebeClusterVersionsDto {\n  // make sure if you modify something here to also modify ImmutableThings\n  elasticSearchOss: string\n  // Optional on 8.9+ generations where tasklist + operate run inside the\n  // zeebe gateway pod and no longer ship as standalone images.\n  operate?: string\n  zeebe: string\n  // Optional on 8.9+ generations \u2014 see operate above.\n  tasklist?: string\n  optimize: string\n  connectorBridge?: string\n}\nexport const ImmutableThings: string[] = [\n  'elasticSearchOss',\n  'operate',\n  'zeebe',\n  'tasklist',\n  'optimize',\n  'connectorBridge',\n]\n\nexport interface MutableZeebeClusterVersionsDto {\n  // make sure if you modify something here to also modify MutableThings\n  zeebeAnalytics?: string\n  elasticSearchCurator?: string\n  operateEnvVars?: string\n  zeebeBrokerEnvVars?: string\n  zeebeGatewayEnvVars?: string\n  tasklistEnvVars?: string\n  optimizeEnvVars?: string\n  zeebeAnalyticsEnvVars?: string\n  connectorBridgeEnvVars?: string\n  gatewayEnvVars?: string\n}\nexport const MutableThings: string[] = [\n  'zeebeAnalytics',\n  'elasticSearchCurator',\n  'operateEnvVars',\n  'zeebeBrokerEnvVars',\n  'zeebeGatewayEnvVars',\n  'tasklistEnvVars',\n  'optimizeEnvVars',\n  'zeebeAnalyticsEnvVars',\n  'connectorBridgeEnvVars',\n  'gatewayEnvVars',\n]\nexport const AllThings: string[] = ImmutableThings.concat(MutableThings)\n"],
-  "mappings": "AAsBO,MAAM,kBAA4B;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAeO,MAAM,gBAA0B;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AACO,MAAM,YAAsB,gBAAgB,OAAO,aAAa;",
+  "sourcesContent": ["/*\n * Copyright Camunda Services GmbH and/or licensed to Camunda Services GmbH\n * under one or more contributor license agreements. Licensed under a commercial license.\n * You may not use this file except in compliance with the commercial license.\n */\n\nexport interface ZeebeClusterVersionsDto\n  extends MutableZeebeClusterVersionsDto,\n    ImmutableZeebeClusterVersionsDto {}\n\nexport interface ImmutableZeebeClusterVersionsDto {\n  // make sure if you modify something here to also modify ImmutableThings\n  elasticSearchOss: string\n  // Optional on 8.9+ generations where tasklist + operate run inside the\n  // zeebe gateway pod and no longer ship as standalone images.\n  operate?: string\n  zeebe: string\n  // Optional on 8.9+ generations \u2014 see operate above.\n  tasklist?: string\n  optimize: string\n  connectorBridge?: string\n}\nexport const ImmutableThings: string[] = [\n  'elasticSearchOss',\n  'operate',\n  'zeebe',\n  'tasklist',\n  'optimize',\n  'connectorBridge',\n]\n\nexport interface MutableZeebeClusterVersionsDto {\n  // make sure if you modify something here to also modify MutableThings\n  zeebeAnalytics?: string\n  elasticSearchCurator?: string\n  operateEnvVars?: string\n  zeebeBrokerEnvVars?: string\n  zeebeGatewayEnvVars?: string\n  tasklistEnvVars?: string\n  optimizeEnvVars?: string\n  zeebeAnalyticsEnvVars?: string\n  connectorBridgeEnvVars?: string\n  gatewayEnvVars?: string\n}\n/**\n * The mutable versions that are image references.\n *\n * The approval use case `change-generation-versions` writes these two and\n * never an env var field. An env var text can hold a secret, and the payload\n * of a request is a row that every approver reads and that the table keeps.\n * The env var fields change on the direct Edit, as before.\n */\nexport const GENERATION_IMAGE_VERSION_KEYS = [\n  'zeebeAnalytics',\n  'elasticSearchCurator',\n] as const\n\nexport type GenerationImageVersionsDto = Pick<\n  MutableZeebeClusterVersionsDto,\n  (typeof GENERATION_IMAGE_VERSION_KEYS)[number]\n>\n\nexport const MutableThings: string[] = [\n  'zeebeAnalytics',\n  'elasticSearchCurator',\n  'operateEnvVars',\n  'zeebeBrokerEnvVars',\n  'zeebeGatewayEnvVars',\n  'tasklistEnvVars',\n  'optimizeEnvVars',\n  'zeebeAnalyticsEnvVars',\n  'connectorBridgeEnvVars',\n  'gatewayEnvVars',\n]\nexport const AllThings: string[] = ImmutableThings.concat(MutableThings)\n"],
+  "mappings": "AAsBO,MAAM,kBAA4B;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAuBO,MAAM,gCAAgC;AAAA,EAC3C;AAAA,EACA;AACF;AAOO,MAAM,gBAA0B;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AACO,MAAM,YAAsB,gBAAgB,OAAO,aAAa;",
   "names": []
 }

package/dist/types/ClusterUsageMetrics.type.d.ts

@@ -28,6 +28,28 @@ export interface ClusterUsageMetricsData {
     generalUsers?: number;
     deployedModels?: number;
 }
+/**
+ * One row of the usage metadata of an organization: the unique task users
+ * and the deployed models that console counted for one billing period
+ * (`GET api/orgs/:orgId/clusters/usage/value-metrics-metadata`).
+ *
+ * `startTimestamp` is the start of the contract period that the row belongs
+ * to. A row is the whole period, so the list of an organization holds one
+ * row for each period that console counted.
+ */
+export interface ClusterUsageMetadataDto {
+    id: number;
+    orgId: string;
+    startTimestamp: string | Date;
+    taskUsers: {
+        clusterId: string;
+        identifier: string;
+    }[];
+    deployedModels: {
+        clusterId: string;
+        count: number;
+    }[];
+}
 export interface ClusterUsageDataRequest {
     orgStartDateMap: Map<string, {
         startDate: Date;

package/dist/utils/jvmOptions.d.ts

@@ -0,0 +1,80 @@
+/**
+ * JVM_OPTION_PATTERN is the syntax of one flag that the CRD accepts. It is not
+ * the full check: parseJvmOption also refuses a flag that the Camunda launcher
+ * sets, for example `-XX:+ExitOnOutOfMemoryError`.
+ */
+export declare const JVM_OPTION_PATTERN: RegExp;
+/** JVM_OPTION_MAX_LENGTH is the `items:MaxLength` of `jvm.options` in the CRD. */
+export declare const JVM_OPTION_MAX_LENGTH = 256;
+/** JVM_OPTIONS_MAX_ITEMS is the `MaxItems` of `jvm.options` in the CRD. */
+export declare const JVM_OPTIONS_MAX_ITEMS = 64;
+/** JVM_OPTIONS_MODIFICATION_KEYS are the cluster modification keys that hold a list of JVM flags. */
+export declare const JVM_OPTIONS_MODIFICATION_KEYS: readonly ["zeebe.broker.jvm.options", "gateway.jvm.options"];
+/** JvmOptionsModificationKey is one of JVM_OPTIONS_MODIFICATION_KEYS. */
+export type JvmOptionsModificationKey = (typeof JVM_OPTIONS_MODIFICATION_KEYS)[number];
+/** JVM_OPTIONS_TARGETS names the ZeebeCluster spec component whose `jvm.options` each key sets. */
+export declare const JVM_OPTIONS_TARGETS: {
+    readonly 'zeebe.broker.jvm.options': "zeebeBroker";
+    readonly 'gateway.jvm.options': "gateway";
+};
+/** ParsedJvmOption is a valid flag with the key that names its setting. */
+export type ParsedJvmOption = {
+    key: string;
+    arg: string;
+};
+/** isJvmOptionsModificationKey tells if `key` is in JVM_OPTIONS_MODIFICATION_KEYS. */
+export declare function isJvmOptionsModificationKey(key: string): key is JvmOptionsModificationKey;
+/**
+ * isUnderJvmSpec tells if `key` names a `jvm` object of the spec, or a path in
+ * it, for example `zeebe.broker.jvm.options.0`. Only the keys of
+ * JVM_OPTIONS_MODIFICATION_KEYS may set it: the plan overlay turns any other
+ * such key into a list or an object in the spec.
+ */
+export declare function isUnderJvmSpec(key: string): boolean;
+/**
+ * requiresEnvVarsOverride tells if only a caller with `canOverrideEnvVars` can
+ * set the modification key `key`: an `envVars` key, the JVM options keys, and
+ * every key under them, because the plan overlay turns a key such as
+ * `zeebe.broker.envVars.0` into the same field. The operator merges the JVM
+ * options into `JAVA_TOOL_OPTIONS`, and replaces matching flags in
+ * `JAVA_OPTS`, so they act like the env vars.
+ */
+export declare function requiresEnvVarsOverride(key: string): boolean;
+type PlanModificationEntry = {
+    key: string;
+    value?: unknown;
+};
+/**
+ * addsEnvVarsOverrideValue tells if `after` holds an entry with a key that
+ * needs `canOverrideEnvVars`, whose key and value are not in `allowed`. A
+ * caller without the permission can keep or remove such an entry, but cannot
+ * add one or change its value. A removal needs no check, because the
+ * activation of a config without the entry removes it too.
+ */
+export declare function addsEnvVarsOverrideValue(allowed: ReadonlyArray<PlanModificationEntry> | undefined, after: ReadonlyArray<PlanModificationEntry> | undefined): boolean;
+/**
+ * parseJvmOption returns the key and the flag, or an error message when `arg`
+ * is too long, does not match JVM_OPTION_PATTERN, or names a flag that the
+ * Camunda launcher sets. Two flags with the same key set the same setting.
+ */
+export declare function parseJvmOption(arg: string): ParsedJvmOption | {
+    error: string;
+};
+/** splitJvmOptions splits a stored value on any white space and drops empty tokens. */
+export declare function splitJvmOptions(value: string | undefined): string[];
+/** joinJvmOptions returns the stored form of a list: the flags joined by a space. */
+export declare function joinJvmOptions(options: string[]): string;
+/**
+ * validateJvmOptions returns one message per problem of `options`, or an empty
+ * array when `options` is valid. `existing` holds the flags that come before
+ * `options` in the list. They count for duplicates and for the maximum number
+ * of flags, but their own problems are not reported.
+ */
+export declare function validateJvmOptions(options: string[], existing?: string[]): string[];
+/**
+ * validateJvmOptionsValue returns one message per problem of the stored value
+ * of a JVM options key, or an empty array when the value is valid. The stored
+ * value is a string of flags separated by white space.
+ */
+export declare function validateJvmOptionsValue(value: unknown): string[];
+export {};

package/dist/utils/jvmOptions.js

@@ -0,0 +1,120 @@
+const JVM_OPTION_PATTERN = /^(-XX:([+-][A-Za-z][A-Za-z0-9_]*|[A-Za-z][A-Za-z0-9_]*=[\x21\x23\x25\x26\x28-\x5b\x5d-\x7e]+)|-X(mx|ms|ss)[0-9]+[kKmMgGtT]?)$/;
+const JVM_OPTION_MAX_LENGTH = 256;
+const JVM_OPTIONS_MAX_ITEMS = 64;
+const JVM_OPTIONS_MODIFICATION_KEYS = [
+  "zeebe.broker.jvm.options",
+  "gateway.jvm.options"
+];
+const JVM_OPTIONS_TARGETS = {
+  "zeebe.broker.jvm.options": "zeebeBroker",
+  "gateway.jvm.options": "gateway"
+};
+const SIZE_FLAG_KEYS = {
+  "-Xmx": "XX:MaxHeapSize",
+  "-Xms": "XX:InitialHeapSize",
+  "-Xss": "XX:ThreadStackSize"
+};
+const LAUNCHER_KEYS = ["XX:ExitOnOutOfMemoryError"];
+function isJvmOptionsModificationKey(key) {
+  return JVM_OPTIONS_MODIFICATION_KEYS.includes(key);
+}
+const JVM_SPEC_PATHS = JVM_OPTIONS_MODIFICATION_KEYS.map(
+  (key) => key.slice(0, -".options".length)
+);
+function isUnderJvmSpec(key) {
+  return JVM_SPEC_PATHS.some(
+    (path) => key === path || key.startsWith(`${path}.`)
+  );
+}
+function requiresEnvVarsOverride(key) {
+  return key.split(".").includes("envVars") || isUnderJvmSpec(key);
+}
+function envVarsOverrideEntries(modifications) {
+  return (modifications ?? []).filter(({ key }) => requiresEnvVarsOverride(key)).map(({ key, value }) => JSON.stringify([key, String(value)]));
+}
+function addsEnvVarsOverrideValue(allowed, after) {
+  const known = new Set(envVarsOverrideEntries(allowed));
+  return envVarsOverrideEntries(after).some((entry) => !known.has(entry));
+}
+function keyOf(arg) {
+  if (arg.startsWith("-XX:")) {
+    const name = arg.slice("-XX:".length).replace(/^[+-]+/, "").split("=")[0];
+    return name === "" ? "" : `XX:${name}`;
+  }
+  return SIZE_FLAG_KEYS[arg.slice(0, 4)] ?? "";
+}
+function parseJvmOption(arg) {
+  if (arg.length > JVM_OPTION_MAX_LENGTH) {
+    return {
+      error: `"${arg}" is longer than ${JVM_OPTION_MAX_LENGTH} characters`
+    };
+  }
+  if (!JVM_OPTION_PATTERN.test(arg)) {
+    return {
+      error: `"${arg}" is not a JVM flag of the form -XX:+Name, -XX:-Name, -XX:Name=value or -Xmx, -Xms, -Xss with a size, where a value is printable ASCII without spaces, quotes, $ or backslashes`
+    };
+  }
+  const key = keyOf(arg);
+  if (LAUNCHER_KEYS.includes(key)) {
+    return {
+      error: `"${arg}" cannot be changed, because the Camunda launcher sets it on the command line`
+    };
+  }
+  return { key, arg };
+}
+function splitJvmOptions(value) {
+  return value?.split(/\s+/).filter(Boolean) ?? [];
+}
+function joinJvmOptions(options) {
+  return options.join(" ");
+}
+function validateJvmOptions(options, existing = []) {
+  const errors = [];
+  const firstByKey = /* @__PURE__ */ new Map();
+  for (const arg of existing) {
+    const parsed = parseJvmOption(arg);
+    if (!("error" in parsed) && !firstByKey.has(parsed.key)) {
+      firstByKey.set(parsed.key, arg);
+    }
+  }
+  for (const arg of options) {
+    const parsed = parseJvmOption(arg);
+    if ("error" in parsed) {
+      errors.push(parsed.error);
+      continue;
+    }
+    const first = firstByKey.get(parsed.key);
+    if (first === void 0) {
+      firstByKey.set(parsed.key, arg);
+    } else {
+      errors.push(`"${arg}" sets the same flag as "${first}"`);
+    }
+  }
+  if (existing.length + options.length > JVM_OPTIONS_MAX_ITEMS) {
+    errors.push(`Use at most ${JVM_OPTIONS_MAX_ITEMS} JVM flags`);
+  }
+  return errors;
+}
+function validateJvmOptionsValue(value) {
+  if (typeof value !== "string") {
+    return ["JVM options must be a string of flags"];
+  }
+  return validateJvmOptions(splitJvmOptions(value));
+}
+export {
+  JVM_OPTIONS_MAX_ITEMS,
+  JVM_OPTIONS_MODIFICATION_KEYS,
+  JVM_OPTIONS_TARGETS,
+  JVM_OPTION_MAX_LENGTH,
+  JVM_OPTION_PATTERN,
+  addsEnvVarsOverrideValue,
+  isJvmOptionsModificationKey,
+  isUnderJvmSpec,
+  joinJvmOptions,
+  parseJvmOption,
+  requiresEnvVarsOverride,
+  splitJvmOptions,
+  validateJvmOptions,
+  validateJvmOptionsValue
+};
+//# sourceMappingURL=jvmOptions.js.map

package/dist/utils/jvmOptions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/jvmOptions.ts"],
+  "sourcesContent": ["/*\n * Copyright Camunda Services GmbH and/or licensed to Camunda Services GmbH\n * under one or more contributor license agreements. Licensed under a commercial license.\n * You may not use this file except in compliance with the commercial license.\n */\n\n// Port of the parsing rules in pkg/jvm/options.go and of the limits in the\n// JVMSpec kubebuilder markers in api/cloud/v1alpha1/zeebecluster_types.go, both\n// in camunda/camunda-operator. The operator rejects flags that do not match, so\n// change both files together.\n\n/**\n * JVM_OPTION_PATTERN is the syntax of one flag that the CRD accepts. It is not\n * the full check: parseJvmOption also refuses a flag that the Camunda launcher\n * sets, for example `-XX:+ExitOnOutOfMemoryError`.\n */\nexport const JVM_OPTION_PATTERN =\n  /^(-XX:([+-][A-Za-z][A-Za-z0-9_]*|[A-Za-z][A-Za-z0-9_]*=[\\x21\\x23\\x25\\x26\\x28-\\x5b\\x5d-\\x7e]+)|-X(mx|ms|ss)[0-9]+[kKmMgGtT]?)$/\n\n/** JVM_OPTION_MAX_LENGTH is the `items:MaxLength` of `jvm.options` in the CRD. */\nexport const JVM_OPTION_MAX_LENGTH = 256\n\n/** JVM_OPTIONS_MAX_ITEMS is the `MaxItems` of `jvm.options` in the CRD. */\nexport const JVM_OPTIONS_MAX_ITEMS = 64\n\n/** JVM_OPTIONS_MODIFICATION_KEYS are the cluster modification keys that hold a list of JVM flags. */\nexport const JVM_OPTIONS_MODIFICATION_KEYS = [\n  'zeebe.broker.jvm.options',\n  'gateway.jvm.options',\n] as const\n\n/** JvmOptionsModificationKey is one of JVM_OPTIONS_MODIFICATION_KEYS. */\nexport type JvmOptionsModificationKey =\n  (typeof JVM_OPTIONS_MODIFICATION_KEYS)[number]\n\n/** JVM_OPTIONS_TARGETS names the ZeebeCluster spec component whose `jvm.options` each key sets. */\nexport const JVM_OPTIONS_TARGETS = {\n  'zeebe.broker.jvm.options': 'zeebeBroker',\n  'gateway.jvm.options': 'gateway',\n} as const satisfies Record<\n  JvmOptionsModificationKey,\n  'zeebeBroker' | 'gateway'\n>\n\n// -Xmx, -Xms and -Xss set the same setting as their -XX spelling\nconst SIZE_FLAG_KEYS: Record<string, string> = {\n  '-Xmx': 'XX:MaxHeapSize',\n  '-Xms': 'XX:InitialHeapSize',\n  '-Xss': 'XX:ThreadStackSize',\n}\n\n// the Camunda launcher passes these after JAVA_OPTS, so no option can change them\nconst LAUNCHER_KEYS = ['XX:ExitOnOutOfMemoryError']\n\n/** ParsedJvmOption is a valid flag with the key that names its setting. */\nexport type ParsedJvmOption = { key: string; arg: string }\n\n/** isJvmOptionsModificationKey tells if `key` is in JVM_OPTIONS_MODIFICATION_KEYS. */\nexport function isJvmOptionsModificationKey(\n  key: string,\n): key is JvmOptionsModificationKey {\n  return (JVM_OPTIONS_MODIFICATION_KEYS as readonly string[]).includes(key)\n}\n\n// The `jvm` objects of the spec that JVM_OPTIONS_MODIFICATION_KEYS set a list in.\nconst JVM_SPEC_PATHS = JVM_OPTIONS_MODIFICATION_KEYS.map((key) =>\n  key.slice(0, -'.options'.length),\n)\n\n/**\n * isUnderJvmSpec tells if `key` names a `jvm` object of the spec, or a path in\n * it, for example `zeebe.broker.jvm.options.0`. Only the keys of\n * JVM_OPTIONS_MODIFICATION_KEYS may set it: the plan overlay turns any other\n * such key into a list or an object in the spec.\n */\nexport function isUnderJvmSpec(key: string): boolean {\n  return JVM_SPEC_PATHS.some(\n    (path) => key === path || key.startsWith(`${path}.`),\n  )\n}\n\n/**\n * requiresEnvVarsOverride tells if only a caller with `canOverrideEnvVars` can\n * set the modification key `key`: an `envVars` key, the JVM options keys, and\n * every key under them, because the plan overlay turns a key such as\n * `zeebe.broker.envVars.0` into the same field. The operator merges the JVM\n * options into `JAVA_TOOL_OPTIONS`, and replaces matching flags in\n * `JAVA_OPTS`, so they act like the env vars.\n */\nexport function requiresEnvVarsOverride(key: string): boolean {\n  return key.split('.').includes('envVars') || isUnderJvmSpec(key)\n}\n\ntype PlanModificationEntry = { key: string; value?: unknown }\n\n// One string for each entry with a key that requiresEnvVarsOverride names, so\n// that a Set compares the key and the value together.\nfunction envVarsOverrideEntries(\n  modifications: ReadonlyArray<PlanModificationEntry> | undefined,\n): string[] {\n  return (modifications ?? [])\n    .filter(({ key }) => requiresEnvVarsOverride(key))\n    .map(({ key, value }) => JSON.stringify([key, String(value)]))\n}\n\n/**\n * addsEnvVarsOverrideValue tells if `after` holds an entry with a key that\n * needs `canOverrideEnvVars`, whose key and value are not in `allowed`. A\n * caller without the permission can keep or remove such an entry, but cannot\n * add one or change its value. A removal needs no check, because the\n * activation of a config without the entry removes it too.\n */\nexport function addsEnvVarsOverrideValue(\n  allowed: ReadonlyArray<PlanModificationEntry> | undefined,\n  after: ReadonlyArray<PlanModificationEntry> | undefined,\n): boolean {\n  const known = new Set(envVarsOverrideEntries(allowed))\n  return envVarsOverrideEntries(after).some((entry) => !known.has(entry))\n}\n\nfunction keyOf(arg: string): string {\n  if (arg.startsWith('-XX:')) {\n    const name = arg\n      .slice('-XX:'.length)\n      .replace(/^[+-]+/, '')\n      .split('=')[0]\n    return name === '' ? '' : `XX:${name}`\n  }\n  return SIZE_FLAG_KEYS[arg.slice(0, 4)] ?? ''\n}\n\n/**\n * parseJvmOption returns the key and the flag, or an error message when `arg`\n * is too long, does not match JVM_OPTION_PATTERN, or names a flag that the\n * Camunda launcher sets. Two flags with the same key set the same setting.\n */\nexport function parseJvmOption(\n  arg: string,\n): ParsedJvmOption | { error: string } {\n  if (arg.length > JVM_OPTION_MAX_LENGTH) {\n    return {\n      error: `\"${arg}\" is longer than ${JVM_OPTION_MAX_LENGTH} characters`,\n    }\n  }\n\n  if (!JVM_OPTION_PATTERN.test(arg)) {\n    return {\n      error: `\"${arg}\" is not a JVM flag of the form -XX:+Name, -XX:-Name, -XX:Name=value or -Xmx, -Xms, -Xss with a size, where a value is printable ASCII without spaces, quotes, $ or backslashes`,\n    }\n  }\n\n  const key = keyOf(arg)\n  if (LAUNCHER_KEYS.includes(key)) {\n    return {\n      error: `\"${arg}\" cannot be changed, because the Camunda launcher sets it on the command line`,\n    }\n  }\n\n  return { key, arg }\n}\n\n/** splitJvmOptions splits a stored value on any white space and drops empty tokens. */\nexport function splitJvmOptions(value: string | undefined): string[] {\n  return value?.split(/\\s+/).filter(Boolean) ?? []\n}\n\n/** joinJvmOptions returns the stored form of a list: the flags joined by a space. */\nexport function joinJvmOptions(options: string[]): string {\n  return options.join(' ')\n}\n\n/**\n * validateJvmOptions returns one message per problem of `options`, or an empty\n * array when `options` is valid. `existing` holds the flags that come before\n * `options` in the list. They count for duplicates and for the maximum number\n * of flags, but their own problems are not reported.\n */\nexport function validateJvmOptions(\n  options: string[],\n  existing: string[] = [],\n): string[] {\n  const errors: string[] = []\n  const firstByKey = new Map<string, string>()\n\n  for (const arg of existing) {\n    const parsed = parseJvmOption(arg)\n    if (!('error' in parsed) && !firstByKey.has(parsed.key)) {\n      firstByKey.set(parsed.key, arg)\n    }\n  }\n\n  for (const arg of options) {\n    const parsed = parseJvmOption(arg)\n    if ('error' in parsed) {\n      errors.push(parsed.error)\n      continue\n    }\n\n    const first = firstByKey.get(parsed.key)\n    if (first === undefined) {\n      firstByKey.set(parsed.key, arg)\n    } else {\n      errors.push(`\"${arg}\" sets the same flag as \"${first}\"`)\n    }\n  }\n\n  if (existing.length + options.length > JVM_OPTIONS_MAX_ITEMS) {\n    errors.push(`Use at most ${JVM_OPTIONS_MAX_ITEMS} JVM flags`)\n  }\n\n  return errors\n}\n\n/**\n * validateJvmOptionsValue returns one message per problem of the stored value\n * of a JVM options key, or an empty array when the value is valid. The stored\n * value is a string of flags separated by white space.\n */\nexport function validateJvmOptionsValue(value: unknown): string[] {\n  if (typeof value !== 'string') {\n    return ['JVM options must be a string of flags']\n  }\n  return validateJvmOptions(splitJvmOptions(value))\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camunda/ccma-shared-types",
-  "version": "7.5.0",
+  "version": "7.7.0",
   "description": "Shared TypeScript types for Camunda Cloud Management Apps",
   "bugs": {
     "url": "https://github.com/camunda/camunda-cloud-management-apps/issues"