@backstage/frontend-plugin-api 0.7.0-next.2 → 0.7.0

package/dist/index.esm.js

@@ -6,6 +6,17 @@ export { componentsApiRef, useComponentRef } from './apis/definitions/Components
 export { iconsApiRef } from './apis/definitions/IconsApi.esm.js';
 export { routeResolutionApiRef } from './apis/definitions/RouteResolutionApi.esm.js';
 export { analyticsApiRef } from './apis/definitions/AnalyticsApi.esm.js';
+export { ApiBlueprint } from './blueprints/ApiBlueprint.esm.js';
+export { AppRootElementBlueprint } from './blueprints/AppRootElementBlueprint.esm.js';
+export { AppRootWrapperBlueprint } from './blueprints/AppRootWrapperBlueprint.esm.js';
+export { IconBundleBlueprint } from './blueprints/IconBundleBlueprint.esm.js';
+export { NavItemBlueprint } from './blueprints/NavItemBlueprint.esm.js';
+export { NavLogoBlueprint } from './blueprints/NavLogoBlueprint.esm.js';
+export { PageBlueprint } from './blueprints/PageBlueprint.esm.js';
+export { RouterBlueprint } from './blueprints/RouterBlueprint.esm.js';
+export { SignInPageBlueprint } from './blueprints/SignInPageBlueprint.esm.js';
+export { ThemeBlueprint } from './blueprints/ThemeBlueprint.esm.js';
+export { TranslationBlueprint } from './blueprints/TranslationBlueprint.esm.js';
 export { ExtensionBoundary } from './components/ExtensionBoundary.esm.js';
 export { coreComponentRefs } from './components/coreComponentRefs.esm.js';
 export { createComponentRef } from './components/createComponentRef.esm.js';
@@ -20,7 +31,6 @@ export { createSignInPageExtension } from './extensions/createSignInPageExtensio
 export { createThemeExtension } from './extensions/createThemeExtension.esm.js';
 export { createComponentExtension } from './extensions/createComponentExtension.esm.js';
 export { createTranslationExtension } from './extensions/createTranslationExtension.esm.js';
-export { IconBundleBlueprint } from './extensions/IconBundleBlueprint.esm.js';
 export { createRouteRef } from './routing/RouteRef.esm.js';
 export { createSubRouteRef } from './routing/SubRouteRef.esm.js';
 export { createExternalRouteRef } from './routing/ExternalRouteRef.esm.js';
@@ -32,7 +42,7 @@ export { coreExtensionData } from './wiring/coreExtensionData.esm.js';
 export { createExtension } from './wiring/createExtension.esm.js';
 export { createExtensionInput } from './wiring/createExtensionInput.esm.js';
 export { createExtensionDataRef } from './wiring/createExtensionDataRef.esm.js';
-export { createPlugin } from './wiring/createPlugin.esm.js';
+export { createFrontendPlugin, createPlugin } from './wiring/createFrontendPlugin.esm.js';
 export { createExtensionOverrides } from './wiring/createExtensionOverrides.esm.js';
 export { createExtensionBlueprint } from './wiring/createExtensionBlueprint.esm.js';
 //# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/wiring/createExtension.esm.js

@@ -1,4 +1,6 @@
 import { createSchemaFromZod } from '../schema/createSchemaFromZod.esm.js';
+import { resolveInputOverrides } from './resolveInputOverrides.esm.js';
+import { createExtensionDataContainer } from './createExtensionDataContainer.esm.js';
 
 function toInternalExtensionDefinition(overrides) {
   const internal = overrides;
@@ -16,17 +18,23 @@ function toInternalExtensionDefinition(overrides) {
   return internal;
 }
 function createExtension(options) {
-  const newConfigSchema = options.config?.schema;
-  if (newConfigSchema && options.configSchema) {
+  if ("configSchema" in options && "config" in options) {
     throw new Error(`Cannot provide both configSchema and config.schema`);
   }
-  const configSchema = newConfigSchema ? createSchemaFromZod(
-    (innerZ) => innerZ.object(
-      Object.fromEntries(
-        Object.entries(newConfigSchema).map(([k, v]) => [k, v(innerZ)])
+  let configSchema;
+  if ("configSchema" in options) {
+    configSchema = options.configSchema;
+  }
+  if ("config" in options) {
+    const newConfigSchema = options.config?.schema;
+    configSchema = newConfigSchema && createSchemaFromZod(
+      (innerZ) => innerZ.object(
+        Object.fromEntries(
+          Object.entries(newConfigSchema).map(([k, v]) => [k, v(innerZ)])
+        )
       )
-    )
-  ) : options.configSchema;
+    );
+  }
   return {
     $$type: "@backstage/ExtensionDefinition",
     version: Symbol.iterator in options.output ? "v2" : "v1",
@@ -52,6 +60,65 @@ function createExtension(options) {
       }
       parts.push(`attachTo=${options.attachTo.id}@${options.attachTo.input}`);
       return `ExtensionDefinition{${parts.join(",")}}`;
+    },
+    override: (overrideOptions) => {
+      if (!Array.isArray(options.output)) {
+        throw new Error(
+          "Cannot override an extension that is not declared using the new format with outputs as an array"
+        );
+      }
+      const newOptions = options;
+      const overrideNewConfigSchema = overrideOptions.config?.schema;
+      const schema = {
+        ...newOptions.config?.schema,
+        ...overrideNewConfigSchema
+      };
+      return createExtension({
+        kind: newOptions.kind,
+        namespace: newOptions.namespace,
+        name: newOptions.name,
+        attachTo: overrideOptions.attachTo ?? newOptions.attachTo,
+        disabled: overrideOptions.disabled ?? newOptions.disabled,
+        inputs: { ...overrideOptions.inputs, ...newOptions.inputs },
+        output: overrideOptions.output ?? newOptions.output,
+        config: Object.keys(schema).length === 0 ? void 0 : { schema },
+        factory: ({ node, config, inputs }) => {
+          if (!overrideOptions.factory) {
+            return newOptions.factory({
+              node,
+              config,
+              inputs
+            });
+          }
+          const parentResult = overrideOptions.factory(
+            (innerContext) => {
+              return createExtensionDataContainer(
+                newOptions.factory({
+                  node,
+                  config: innerContext?.config ?? config,
+                  inputs: resolveInputOverrides(
+                    newOptions.inputs,
+                    inputs,
+                    innerContext?.inputs
+                  )
+                  // TODO: Might be able to improve this once legacy inputs are gone
+                }),
+                newOptions.output
+              );
+            },
+            {
+              node,
+              config,
+              inputs
+            }
+          );
+          const deduplicatedResult = /* @__PURE__ */ new Map();
+          for (const item of parentResult) {
+            deduplicatedResult.set(item.id, item);
+          }
+          return deduplicatedResult.values();
+        }
+      });
     }
   };
 }

package/dist/wiring/createExtension.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"createExtension.esm.js","sources":["../../src/wiring/createExtension.ts"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { AppNode } from '../apis';\nimport { PortableSchema, createSchemaFromZod } from '../schema';\nimport { Expand } from '../types';\nimport {\n  AnyExtensionDataRef,\n  ExtensionDataRef,\n  ExtensionDataValue,\n} from './createExtensionDataRef';\nimport { ExtensionInput, LegacyExtensionInput } from './createExtensionInput';\nimport { z } from 'zod';\n\n/**\n * @public\n * @deprecated Extension data maps will be removed.\n */\nexport type AnyExtensionDataMap = {\n  [name in string]: AnyExtensionDataRef;\n};\n\n/**\n * @public\n * @deprecated This type will be removed.\n */\nexport type AnyExtensionInputMap = {\n  [inputName in string]: LegacyExtensionInput<\n    AnyExtensionDataMap,\n    { optional: boolean; singleton: boolean }\n  >;\n};\n\n/**\n * Converts an extension data map into the matching concrete data values type.\n * @public\n * @deprecated Extension data maps will be removed.\n */\nexport type ExtensionDataValues<TExtensionData extends AnyExtensionDataMap> = {\n  [DataName in keyof TExtensionData as TExtensionData[DataName]['config'] extends {\n    optional: true;\n  }\n    ? never\n    : DataName]: TExtensionData[DataName]['T'];\n} & {\n  [DataName in keyof TExtensionData as TExtensionData[DataName]['config'] extends {\n    optional: true;\n  }\n    ? DataName\n    : never]?: TExtensionData[DataName]['T'];\n};\n\n/** @public */\nexport type ExtensionDataContainer<UExtensionData extends AnyExtensionDataRef> =\n  {\n    get<TId extends UExtensionData['id']>(\n      ref: ExtensionDataRef<any, TId, any>,\n    ): UExtensionData extends ExtensionDataRef<infer IData, TId, infer IConfig>\n      ? IConfig['optional'] extends true\n        ? IData | undefined\n        : IData\n      : never;\n  };\n\n/**\n * Convert a single extension input into a matching resolved input.\n * @public\n */\nexport type ResolvedExtensionInput<\n  TExtensionInput extends ExtensionInput<any, any>,\n> = TExtensionInput['extensionData'] extends Array<AnyExtensionDataRef>\n  ? {\n      node: AppNode;\n    } & ExtensionDataContainer<TExtensionInput['extensionData'][number]>\n  : TExtensionInput['extensionData'] extends AnyExtensionDataMap\n  ? {\n      node: AppNode;\n      output: ExtensionDataValues<TExtensionInput['extensionData']>;\n    }\n  : never;\n\n/**\n * Converts an extension input map into a matching collection of resolved inputs.\n * @public\n */\nexport type ResolvedExtensionInputs<\n  TInputs extends {\n    [name in string]: ExtensionInput<any, any> | LegacyExtensionInput<any, any>;\n  },\n> = {\n  [InputName in keyof TInputs]: false extends TInputs[InputName]['config']['singleton']\n    ? Array<Expand<ResolvedExtensionInput<TInputs[InputName]>>>\n    : false extends TInputs[InputName]['config']['optional']\n    ? Expand<ResolvedExtensionInput<TInputs[InputName]>>\n    : Expand<ResolvedExtensionInput<TInputs[InputName]> | undefined>;\n};\n\n/**\n * @public\n * @deprecated This way of structuring the options is deprecated, this type will be removed in the future\n */\nexport interface LegacyCreateExtensionOptions<\n  TOutput extends AnyExtensionDataMap,\n  TInputs extends AnyExtensionInputMap,\n  TConfig,\n  TConfigInput,\n  TConfigSchema extends { [key: string]: (zImpl: typeof z) => z.ZodType },\n> {\n  kind?: string;\n  namespace?: string;\n  name?: string;\n  attachTo: { id: string; input: string };\n  disabled?: boolean;\n  inputs?: TInputs;\n  output: TOutput;\n  /** @deprecated - use `config.schema` instead */\n  configSchema?: PortableSchema<TConfig, TConfigInput>;\n  config?: {\n    schema: TConfigSchema;\n  };\n  factory(context: {\n    node: AppNode;\n    config: TConfig &\n      (string extends keyof TConfigSchema\n        ? {}\n        : {\n            [key in keyof TConfigSchema]: z.infer<\n              ReturnType<TConfigSchema[key]>\n            >;\n          });\n    inputs: Expand<ResolvedExtensionInputs<TInputs>>;\n  }): Expand<ExtensionDataValues<TOutput>>;\n}\n\n/** @ignore */\nexport type VerifyExtensionFactoryOutput<\n  UDeclaredOutput extends AnyExtensionDataRef,\n  UFactoryOutput extends ExtensionDataValue<any, any>,\n> = (\n  UDeclaredOutput extends any\n    ? UDeclaredOutput['config']['optional'] extends true\n      ? never\n      : UDeclaredOutput['id']\n    : never\n) extends infer IRequiredOutputIds\n  ? [IRequiredOutputIds] extends [UFactoryOutput['id']]\n    ? [UFactoryOutput['id']] extends [UDeclaredOutput['id']]\n      ? {}\n      : {\n          'Error: The extension factory has undeclared output(s)': Exclude<\n            UFactoryOutput['id'],\n            UDeclaredOutput['id']\n          >;\n        }\n    : {\n        'Error: The extension factory is missing the following output(s)': Exclude<\n          IRequiredOutputIds,\n          UFactoryOutput['id']\n        >;\n      }\n  : never;\n\n/** @public */\nexport type CreateExtensionOptions<\n  UOutput extends AnyExtensionDataRef,\n  TInputs extends {\n    [inputName in string]: ExtensionInput<\n      AnyExtensionDataRef,\n      { optional: boolean; singleton: boolean }\n    >;\n  },\n  TConfig,\n  TConfigInput,\n  TConfigSchema extends { [key: string]: (zImpl: typeof z) => z.ZodType },\n  UFactoryOutput extends ExtensionDataValue<any, any>,\n> = {\n  kind?: string;\n  namespace?: string;\n  name?: string;\n  attachTo: { id: string; input: string };\n  disabled?: boolean;\n  inputs?: TInputs;\n  output: Array<UOutput>;\n  /** @deprecated - use `config.schema` instead */\n  configSchema?: PortableSchema<TConfig, TConfigInput>;\n  config?: {\n    schema: TConfigSchema;\n  };\n  factory(context: {\n    node: AppNode;\n    config: TConfig &\n      (string extends keyof TConfigSchema\n        ? {}\n        : {\n            [key in keyof TConfigSchema]: z.infer<\n              ReturnType<TConfigSchema[key]>\n            >;\n          });\n    inputs: Expand<ResolvedExtensionInputs<TInputs>>;\n  }): Iterable<UFactoryOutput>;\n} & VerifyExtensionFactoryOutput<UOutput, UFactoryOutput>;\n\n/** @public */\nexport interface ExtensionDefinition<TConfig, TConfigInput = TConfig> {\n  $$type: '@backstage/ExtensionDefinition';\n  readonly kind?: string;\n  readonly namespace?: string;\n  readonly name?: string;\n  readonly attachTo: { id: string; input: string };\n  readonly disabled: boolean;\n  readonly configSchema?: PortableSchema<TConfig, TConfigInput>;\n}\n\n/** @internal */\nexport type InternalExtensionDefinition<TConfig, TConfigInput> =\n  ExtensionDefinition<TConfig, TConfigInput> &\n    (\n      | {\n          readonly version: 'v1';\n          readonly inputs: AnyExtensionInputMap;\n          readonly output: AnyExtensionDataMap;\n          factory(context: {\n            node: AppNode;\n            config: TConfig;\n            inputs: ResolvedExtensionInputs<AnyExtensionInputMap>;\n          }): ExtensionDataValues<any>;\n        }\n      | {\n          readonly version: 'v2';\n          readonly inputs: {\n            [inputName in string]: ExtensionInput<\n              AnyExtensionDataRef,\n              { optional: boolean; singleton: boolean }\n            >;\n          };\n          readonly output: Array<AnyExtensionDataRef>;\n          factory(context: {\n            node: AppNode;\n            config: TConfig;\n            inputs: ResolvedExtensionInputs<{\n              [inputName in string]: ExtensionInput<\n                AnyExtensionDataRef,\n                { optional: boolean; singleton: boolean }\n              >;\n            }>;\n          }): Iterable<ExtensionDataValue<any, any>>;\n        }\n    );\n\n/** @internal */\nexport function toInternalExtensionDefinition<TConfig, TConfigInput>(\n  overrides: ExtensionDefinition<TConfig, TConfigInput>,\n): InternalExtensionDefinition<TConfig, TConfigInput> {\n  const internal = overrides as InternalExtensionDefinition<\n    TConfig,\n    TConfigInput\n  >;\n  if (internal.$$type !== '@backstage/ExtensionDefinition') {\n    throw new Error(\n      `Invalid extension definition instance, bad type '${internal.$$type}'`,\n    );\n  }\n  const version = internal.version;\n  if (version !== 'v1' && version !== 'v2') {\n    throw new Error(\n      `Invalid extension definition instance, bad version '${version}'`,\n    );\n  }\n  return internal;\n}\n\n/** @public */\nexport function createExtension<\n  UOutput extends AnyExtensionDataRef,\n  TInputs extends {\n    [inputName in string]: ExtensionInput<\n      AnyExtensionDataRef,\n      { optional: boolean; singleton: boolean }\n    >;\n  },\n  TConfig,\n  TConfigInput,\n  TConfigSchema extends { [key: string]: (zImpl: typeof z) => z.ZodType },\n  UFactoryOutput extends ExtensionDataValue<any, any>,\n>(\n  options: CreateExtensionOptions<\n    UOutput,\n    TInputs,\n    TConfig,\n    TConfigInput,\n    TConfigSchema,\n    UFactoryOutput\n  >,\n): ExtensionDefinition<\n  TConfig &\n    (string extends keyof TConfigSchema\n      ? {}\n      : {\n          [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;\n        }),\n  TConfigInput &\n    (string extends keyof TConfigSchema\n      ? {}\n      : z.input<\n          z.ZodObject<{\n            [key in keyof TConfigSchema]: ReturnType<TConfigSchema[key]>;\n          }>\n        >)\n>;\n/**\n * @public\n * @deprecated - use the array format of `output` instead, see TODO-doc-link\n */\nexport function createExtension<\n  TOutput extends AnyExtensionDataMap,\n  TInputs extends AnyExtensionInputMap,\n  TConfig,\n  TConfigInput,\n  TConfigSchema extends { [key: string]: (zImpl: typeof z) => z.ZodType },\n>(\n  options: LegacyCreateExtensionOptions<\n    TOutput,\n    TInputs,\n    TConfig,\n    TConfigInput,\n    TConfigSchema\n  >,\n): ExtensionDefinition<\n  TConfig &\n    (string extends keyof TConfigSchema\n      ? {}\n      : {\n          [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;\n        }),\n  TConfigInput &\n    (string extends keyof TConfigSchema\n      ? {}\n      : z.input<\n          z.ZodObject<{\n            [key in keyof TConfigSchema]: ReturnType<TConfigSchema[key]>;\n          }>\n        >)\n>;\nexport function createExtension<\n  UOutput extends AnyExtensionDataRef,\n  TInputs extends {\n    [inputName in string]: ExtensionInput<\n      AnyExtensionDataRef,\n      { optional: boolean; singleton: boolean }\n    >;\n  },\n  TLegacyInputs extends AnyExtensionInputMap,\n  TConfig,\n  TConfigInput,\n  TConfigSchema extends { [key: string]: (zImpl: typeof z) => z.ZodType },\n  UFactoryOutput extends ExtensionDataValue<any, any>,\n>(\n  options:\n    | CreateExtensionOptions<\n        UOutput,\n        TInputs,\n        TConfig,\n        TConfigInput,\n        TConfigSchema,\n        UFactoryOutput\n      >\n    | LegacyCreateExtensionOptions<\n        AnyExtensionDataMap,\n        TLegacyInputs,\n        TConfig,\n        TConfigInput,\n        TConfigSchema\n      >,\n): ExtensionDefinition<\n  TConfig &\n    (string extends keyof TConfigSchema\n      ? {}\n      : {\n          [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;\n        }),\n  TConfigInput &\n    (string extends keyof TConfigSchema\n      ? {}\n      : z.input<\n          z.ZodObject<{\n            [key in keyof TConfigSchema]: ReturnType<TConfigSchema[key]>;\n          }>\n        >)\n> {\n  const newConfigSchema = options.config?.schema;\n  if (newConfigSchema && options.configSchema) {\n    throw new Error(`Cannot provide both configSchema and config.schema`);\n  }\n  const configSchema = newConfigSchema\n    ? createSchemaFromZod(innerZ =>\n        innerZ.object(\n          Object.fromEntries(\n            Object.entries(newConfigSchema).map(([k, v]) => [k, v(innerZ)]),\n          ),\n        ),\n      )\n    : options.configSchema;\n\n  return {\n    $$type: '@backstage/ExtensionDefinition',\n    version: Symbol.iterator in options.output ? 'v2' : 'v1',\n    kind: options.kind,\n    namespace: options.namespace,\n    name: options.name,\n    attachTo: options.attachTo,\n    disabled: options.disabled ?? false,\n    inputs: options.inputs ?? {},\n    output: options.output,\n    configSchema,\n    factory: options.factory,\n    toString() {\n      const parts: string[] = [];\n      if (options.kind) {\n        parts.push(`kind=${options.kind}`);\n      }\n      if (options.namespace) {\n        parts.push(`namespace=${options.namespace}`);\n      }\n      if (options.name) {\n        parts.push(`name=${options.name}`);\n      }\n      parts.push(`attachTo=${options.attachTo.id}@${options.attachTo.input}`);\n      return `ExtensionDefinition{${parts.join(',')}}`;\n    },\n  } as InternalExtensionDefinition<\n    TConfig &\n      (string extends keyof TConfigSchema\n        ? {}\n        : {\n            [key in keyof TConfigSchema]: z.infer<\n              ReturnType<TConfigSchema[key]>\n            >;\n          }),\n    TConfigInput &\n      (string extends keyof TConfigSchema\n        ? {}\n        : z.input<\n            z.ZodObject<{\n              [key in keyof TConfigSchema]: ReturnType<TConfigSchema[key]>;\n            }>\n          >)\n  >;\n}\n"],"names":[],"mappings":";;AAuQO,SAAS,8BACd,SACoD,EAAA;AACpD,EAAA,MAAM,QAAW,GAAA,SAAA,CAAA;AAIjB,EAAI,IAAA,QAAA,CAAS,WAAW,gCAAkC,EAAA;AACxD,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,iDAAA,EAAoD,SAAS,MAAM,CAAA,CAAA,CAAA;AAAA,KACrE,CAAA;AAAA,GACF;AACA,EAAA,MAAM,UAAU,QAAS,CAAA,OAAA,CAAA;AACzB,EAAI,IAAA,OAAA,KAAY,IAAQ,IAAA,OAAA,KAAY,IAAM,EAAA;AACxC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,uDAAuD,OAAO,CAAA,CAAA,CAAA;AAAA,KAChE,CAAA;AAAA,GACF;AACA,EAAO,OAAA,QAAA,CAAA;AACT,CAAA;AA0EO,SAAS,gBAcd,OA+BA,EAAA;AACA,EAAM,MAAA,eAAA,GAAkB,QAAQ,MAAQ,EAAA,MAAA,CAAA;AACxC,EAAI,IAAA,eAAA,IAAmB,QAAQ,YAAc,EAAA;AAC3C,IAAM,MAAA,IAAI,MAAM,CAAoD,kDAAA,CAAA,CAAA,CAAA;AAAA,GACtE;AACA,EAAA,MAAM,eAAe,eACjB,GAAA,mBAAA;AAAA,IAAoB,YAClB,MAAO,CAAA,MAAA;AAAA,MACL,MAAO,CAAA,WAAA;AAAA,QACL,MAAO,CAAA,OAAA,CAAQ,eAAe,CAAA,CAAE,IAAI,CAAC,CAAC,CAAG,EAAA,CAAC,MAAM,CAAC,CAAA,EAAG,CAAE,CAAA,MAAM,CAAC,CAAC,CAAA;AAAA,OAChE;AAAA,KACF;AAAA,MAEF,OAAQ,CAAA,YAAA,CAAA;AAEZ,EAAO,OAAA;AAAA,IACL,MAAQ,EAAA,gCAAA;AAAA,IACR,OAAS,EAAA,MAAA,CAAO,QAAY,IAAA,OAAA,CAAQ,SAAS,IAAO,GAAA,IAAA;AAAA,IACpD,MAAM,OAAQ,CAAA,IAAA;AAAA,IACd,WAAW,OAAQ,CAAA,SAAA;AAAA,IACnB,MAAM,OAAQ,CAAA,IAAA;AAAA,IACd,UAAU,OAAQ,CAAA,QAAA;AAAA,IAClB,QAAA,EAAU,QAAQ,QAAY,IAAA,KAAA;AAAA,IAC9B,MAAA,EAAQ,OAAQ,CAAA,MAAA,IAAU,EAAC;AAAA,IAC3B,QAAQ,OAAQ,CAAA,MAAA;AAAA,IAChB,YAAA;AAAA,IACA,SAAS,OAAQ,CAAA,OAAA;AAAA,IACjB,QAAW,GAAA;AACT,MAAA,MAAM,QAAkB,EAAC,CAAA;AACzB,MAAA,IAAI,QAAQ,IAAM,EAAA;AAChB,QAAA,KAAA,CAAM,IAAK,CAAA,CAAA,KAAA,EAAQ,OAAQ,CAAA,IAAI,CAAE,CAAA,CAAA,CAAA;AAAA,OACnC;AACA,MAAA,IAAI,QAAQ,SAAW,EAAA;AACrB,QAAA,KAAA,CAAM,IAAK,CAAA,CAAA,UAAA,EAAa,OAAQ,CAAA,SAAS,CAAE,CAAA,CAAA,CAAA;AAAA,OAC7C;AACA,MAAA,IAAI,QAAQ,IAAM,EAAA;AAChB,QAAA,KAAA,CAAM,IAAK,CAAA,CAAA,KAAA,EAAQ,OAAQ,CAAA,IAAI,CAAE,CAAA,CAAA,CAAA;AAAA,OACnC;AACA,MAAM,KAAA,CAAA,IAAA,CAAK,YAAY,OAAQ,CAAA,QAAA,CAAS,EAAE,CAAI,CAAA,EAAA,OAAA,CAAQ,QAAS,CAAA,KAAK,CAAE,CAAA,CAAA,CAAA;AACtE,MAAA,OAAO,CAAuB,oBAAA,EAAA,KAAA,CAAM,IAAK,CAAA,GAAG,CAAC,CAAA,CAAA,CAAA,CAAA;AAAA,KAC/C;AAAA,GACF,CAAA;AAkBF;;;;"}
+{"version":3,"file":"createExtension.esm.js","sources":["../../src/wiring/createExtension.ts"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { AppNode } from '../apis';\nimport { PortableSchema, createSchemaFromZod } from '../schema';\nimport { Expand } from '../types';\nimport {\n  ResolveInputValueOverrides,\n  resolveInputOverrides,\n} from './resolveInputOverrides';\nimport {\n  ExtensionDataContainer,\n  createExtensionDataContainer,\n} from './createExtensionDataContainer';\nimport {\n  AnyExtensionDataRef,\n  ExtensionDataValue,\n} from './createExtensionDataRef';\nimport { ExtensionInput, LegacyExtensionInput } from './createExtensionInput';\nimport { z } from 'zod';\n\n/**\n * @public\n * @deprecated Extension data maps will be removed.\n */\nexport type AnyExtensionDataMap = {\n  [name in string]: AnyExtensionDataRef;\n};\n\n/**\n * @public\n * @deprecated This type will be removed.\n */\nexport type AnyExtensionInputMap = {\n  [inputName in string]: LegacyExtensionInput<\n    AnyExtensionDataMap,\n    { optional: boolean; singleton: boolean }\n  >;\n};\n\n/**\n * Converts an extension data map into the matching concrete data values type.\n * @public\n * @deprecated Extension data maps will be removed.\n */\nexport type ExtensionDataValues<TExtensionData extends AnyExtensionDataMap> = {\n  [DataName in keyof TExtensionData as TExtensionData[DataName]['config'] extends {\n    optional: true;\n  }\n    ? never\n    : DataName]: TExtensionData[DataName]['T'];\n} & {\n  [DataName in keyof TExtensionData as TExtensionData[DataName]['config'] extends {\n    optional: true;\n  }\n    ? DataName\n    : never]?: TExtensionData[DataName]['T'];\n};\n\n/**\n * Convert a single extension input into a matching resolved input.\n * @public\n */\nexport type ResolvedExtensionInput<\n  TExtensionInput extends ExtensionInput<any, any>,\n> = TExtensionInput['extensionData'] extends Array<AnyExtensionDataRef>\n  ? {\n      node: AppNode;\n    } & ExtensionDataContainer<TExtensionInput['extensionData'][number]>\n  : TExtensionInput['extensionData'] extends AnyExtensionDataMap\n  ? {\n      node: AppNode;\n      output: ExtensionDataValues<TExtensionInput['extensionData']>;\n    }\n  : never;\n\n/**\n * Converts an extension input map into a matching collection of resolved inputs.\n * @public\n */\nexport type ResolvedExtensionInputs<\n  TInputs extends {\n    [name in string]: ExtensionInput<any, any> | LegacyExtensionInput<any, any>;\n  },\n> = {\n  [InputName in keyof TInputs]: false extends TInputs[InputName]['config']['singleton']\n    ? Array<Expand<ResolvedExtensionInput<TInputs[InputName]>>>\n    : false extends TInputs[InputName]['config']['optional']\n    ? Expand<ResolvedExtensionInput<TInputs[InputName]>>\n    : Expand<ResolvedExtensionInput<TInputs[InputName]> | undefined>;\n};\n\n/**\n * @public\n * @deprecated This way of structuring the options is deprecated, this type will be removed in the future\n */\nexport interface LegacyCreateExtensionOptions<\n  TOutput extends AnyExtensionDataMap,\n  TInputs extends AnyExtensionInputMap,\n  TConfig,\n  TConfigInput,\n> {\n  kind?: string;\n  namespace?: string;\n  name?: string;\n  attachTo: { id: string; input: string };\n  disabled?: boolean;\n  inputs?: TInputs;\n  output: TOutput;\n  configSchema?: PortableSchema<TConfig, TConfigInput>;\n  factory(context: {\n    node: AppNode;\n    config: TConfig;\n    inputs: Expand<ResolvedExtensionInputs<TInputs>>;\n  }): Expand<ExtensionDataValues<TOutput>>;\n}\n\ntype ToIntersection<U> = (U extends any ? (k: U) => void : never) extends (\n  k: infer I,\n) => void\n  ? I\n  : never;\n\ntype PopUnion<U> = ToIntersection<\n  U extends any ? () => U : never\n> extends () => infer R\n  ? [rest: Exclude<U, R>, next: R]\n  : undefined;\n\n/** @ignore */\ntype JoinStringUnion<\n  U,\n  TDiv extends string = ', ',\n  TResult extends string = '',\n> = PopUnion<U> extends [infer IRest extends string, infer INext extends string]\n  ? TResult extends ''\n    ? JoinStringUnion<IRest, TDiv, INext>\n    : JoinStringUnion<IRest, TDiv, `${TResult}${TDiv}${INext}`>\n  : TResult;\n\n/** @ignore */\nexport type VerifyExtensionFactoryOutput<\n  UDeclaredOutput extends AnyExtensionDataRef,\n  UFactoryOutput extends ExtensionDataValue<any, any>,\n> = (\n  UDeclaredOutput extends any\n    ? UDeclaredOutput['config']['optional'] extends true\n      ? never\n      : UDeclaredOutput['id']\n    : never\n) extends infer IRequiredOutputIds\n  ? [IRequiredOutputIds] extends [UFactoryOutput['id']]\n    ? [UFactoryOutput['id']] extends [UDeclaredOutput['id']]\n      ? {}\n      : `Error: The extension factory has undeclared output(s): ${JoinStringUnion<\n          Exclude<UFactoryOutput['id'], UDeclaredOutput['id']>\n        >}`\n    : `Error: The extension factory is missing the following output(s): ${JoinStringUnion<\n        Exclude<IRequiredOutputIds, UFactoryOutput['id']>\n      >}`\n  : never;\n\n/** @public */\nexport type CreateExtensionOptions<\n  TKind extends string | undefined,\n  TNamespace extends string | undefined,\n  TName extends string | undefined,\n  UOutput extends AnyExtensionDataRef,\n  TInputs extends {\n    [inputName in string]: ExtensionInput<\n      AnyExtensionDataRef,\n      { optional: boolean; singleton: boolean }\n    >;\n  },\n  TConfigSchema extends { [key: string]: (zImpl: typeof z) => z.ZodType },\n  UFactoryOutput extends ExtensionDataValue<any, any>,\n> = {\n  kind?: TKind;\n  namespace?: TNamespace;\n  name?: TName;\n  attachTo: { id: string; input: string };\n  disabled?: boolean;\n  inputs?: TInputs;\n  output: Array<UOutput>;\n  config?: {\n    schema: TConfigSchema;\n  };\n  factory(context: {\n    node: AppNode;\n    config: {\n      [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;\n    };\n    inputs: Expand<ResolvedExtensionInputs<TInputs>>;\n  }): Iterable<UFactoryOutput>;\n} & VerifyExtensionFactoryOutput<UOutput, UFactoryOutput>;\n\n/** @public */\nexport interface ExtensionDefinition<\n  TConfig,\n  TConfigInput = TConfig,\n  UOutput extends AnyExtensionDataRef = AnyExtensionDataRef,\n  TInputs extends {\n    [inputName in string]: ExtensionInput<\n      AnyExtensionDataRef,\n      { optional: boolean; singleton: boolean }\n    >;\n  } = {},\n  TIdParts extends {\n    kind?: string;\n    namespace?: string;\n    name?: string;\n  } = {\n    kind?: string;\n    namespace?: string;\n    name?: string;\n  },\n> {\n  $$type: '@backstage/ExtensionDefinition';\n  readonly kind?: TIdParts['kind'];\n  readonly namespace?: TIdParts['namespace'];\n  readonly name?: TIdParts['name'];\n  readonly attachTo: { id: string; input: string };\n  readonly disabled: boolean;\n  readonly configSchema?: PortableSchema<TConfig, TConfigInput>;\n\n  override<\n    TExtensionConfigSchema extends {\n      [key in string]: (zImpl: typeof z) => z.ZodType;\n    },\n    UFactoryOutput extends ExtensionDataValue<any, any>,\n    UNewOutput extends AnyExtensionDataRef,\n    TExtraInputs extends {\n      [inputName in string]: ExtensionInput<\n        AnyExtensionDataRef,\n        { optional: boolean; singleton: boolean }\n      >;\n    },\n  >(\n    args: {\n      attachTo?: { id: string; input: string };\n      disabled?: boolean;\n      inputs?: TExtraInputs & {\n        [KName in keyof TInputs]?: `Error: Input '${KName &\n          string}' is already defined in parent definition`;\n      };\n      output?: Array<UNewOutput>;\n      config?: {\n        schema: TExtensionConfigSchema & {\n          [KName in keyof TConfig]?: `Error: Config key '${KName &\n            string}' is already defined in parent schema`;\n        };\n      };\n      factory(\n        originalFactory: (context?: {\n          config?: TConfig;\n          inputs?: ResolveInputValueOverrides<TInputs>;\n        }) => ExtensionDataContainer<UOutput>,\n        context: {\n          node: AppNode;\n          config: TConfig & {\n            [key in keyof TExtensionConfigSchema]: z.infer<\n              ReturnType<TExtensionConfigSchema[key]>\n            >;\n          };\n          inputs: Expand<ResolvedExtensionInputs<TInputs & TExtraInputs>>;\n        },\n      ): Iterable<UFactoryOutput>;\n    } & VerifyExtensionFactoryOutput<\n      AnyExtensionDataRef extends UNewOutput ? UOutput : UNewOutput,\n      UFactoryOutput\n    >,\n  ): ExtensionDefinition<\n    {\n      [key in keyof TExtensionConfigSchema]: z.infer<\n        ReturnType<TExtensionConfigSchema[key]>\n      >;\n    } & TConfig,\n    z.input<\n      z.ZodObject<{\n        [key in keyof TExtensionConfigSchema]: ReturnType<\n          TExtensionConfigSchema[key]\n        >;\n      }>\n    > &\n      TConfigInput,\n    AnyExtensionDataRef extends UNewOutput ? UOutput : UNewOutput,\n    TInputs & TExtraInputs,\n    TIdParts\n  >;\n}\n\n/** @internal */\nexport type InternalExtensionDefinition<\n  TConfig,\n  TConfigInput = TConfig,\n  UOutput extends AnyExtensionDataRef = AnyExtensionDataRef,\n  TInputs extends {\n    [inputName in string]: ExtensionInput<\n      AnyExtensionDataRef,\n      { optional: boolean; singleton: boolean }\n    >;\n  } = {},\n  TIdParts extends {\n    kind?: string;\n    namespace?: string;\n    name?: string;\n  } = {\n    kind?: string;\n    namespace?: string;\n    name?: string;\n  },\n> = ExtensionDefinition<TConfig, TConfigInput, UOutput, TInputs, TIdParts> &\n  (\n    | {\n        readonly version: 'v1';\n        readonly inputs: AnyExtensionInputMap;\n        readonly output: AnyExtensionDataMap;\n        factory(context: {\n          node: AppNode;\n          config: TConfig;\n          inputs: ResolvedExtensionInputs<AnyExtensionInputMap>;\n        }): ExtensionDataValues<any>;\n      }\n    | {\n        readonly version: 'v2';\n        readonly inputs: {\n          [inputName in string]: ExtensionInput<\n            AnyExtensionDataRef,\n            { optional: boolean; singleton: boolean }\n          >;\n        };\n        readonly output: Array<AnyExtensionDataRef>;\n        factory(context: {\n          node: AppNode;\n          config: TConfig;\n          inputs: ResolvedExtensionInputs<{\n            [inputName in string]: ExtensionInput<\n              AnyExtensionDataRef,\n              { optional: boolean; singleton: boolean }\n            >;\n          }>;\n        }): Iterable<ExtensionDataValue<any, any>>;\n      }\n  );\n\n/** @internal */\nexport function toInternalExtensionDefinition<TConfig, TConfigInput>(\n  overrides: ExtensionDefinition<TConfig, TConfigInput>,\n): InternalExtensionDefinition<TConfig, TConfigInput> {\n  const internal = overrides as InternalExtensionDefinition<\n    TConfig,\n    TConfigInput\n  >;\n  if (internal.$$type !== '@backstage/ExtensionDefinition') {\n    throw new Error(\n      `Invalid extension definition instance, bad type '${internal.$$type}'`,\n    );\n  }\n  const version = internal.version;\n  if (version !== 'v1' && version !== 'v2') {\n    throw new Error(\n      `Invalid extension definition instance, bad version '${version}'`,\n    );\n  }\n  return internal;\n}\n\n/** @public */\nexport function createExtension<\n  UOutput extends AnyExtensionDataRef,\n  TInputs extends {\n    [inputName in string]: ExtensionInput<\n      AnyExtensionDataRef,\n      { optional: boolean; singleton: boolean }\n    >;\n  },\n  TConfigSchema extends { [key: string]: (zImpl: typeof z) => z.ZodType },\n  UFactoryOutput extends ExtensionDataValue<any, any>,\n  const TKind extends string | undefined = undefined,\n  const TNamespace extends string | undefined = undefined,\n  const TName extends string | undefined = undefined,\n>(\n  options: CreateExtensionOptions<\n    TKind,\n    TNamespace,\n    TName,\n    UOutput,\n    TInputs,\n    TConfigSchema,\n    UFactoryOutput\n  >,\n): ExtensionDefinition<\n  {\n    [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;\n  },\n  z.input<\n    z.ZodObject<{\n      [key in keyof TConfigSchema]: ReturnType<TConfigSchema[key]>;\n    }>\n  >,\n  UOutput,\n  TInputs,\n  {\n    kind: string | undefined extends TKind ? undefined : TKind;\n    namespace: string | undefined extends TNamespace ? undefined : TNamespace;\n    name: string | undefined extends TName ? undefined : TName;\n  }\n>;\n/**\n * @public\n * @deprecated - use the array format of `output` instead, see TODO-doc-link\n */\nexport function createExtension<\n  TOutput extends AnyExtensionDataMap,\n  TInputs extends AnyExtensionInputMap,\n  TConfig,\n  TConfigInput,\n>(\n  options: LegacyCreateExtensionOptions<\n    TOutput,\n    TInputs,\n    TConfig,\n    TConfigInput\n  >,\n): ExtensionDefinition<TConfig, TConfigInput, never, never>;\nexport function createExtension<\n  const TKind extends string | undefined,\n  const TNamespace extends string | undefined,\n  const TName extends string | undefined,\n  UOutput extends AnyExtensionDataRef,\n  TInputs extends {\n    [inputName in string]: ExtensionInput<\n      AnyExtensionDataRef,\n      { optional: boolean; singleton: boolean }\n    >;\n  },\n  TLegacyInputs extends AnyExtensionInputMap,\n  TConfig,\n  TConfigInput,\n  TConfigSchema extends { [key: string]: (zImpl: typeof z) => z.ZodType },\n  UFactoryOutput extends ExtensionDataValue<any, any>,\n>(\n  options:\n    | CreateExtensionOptions<\n        TKind,\n        TNamespace,\n        TName,\n        UOutput,\n        TInputs,\n        TConfigSchema,\n        UFactoryOutput\n      >\n    | LegacyCreateExtensionOptions<\n        AnyExtensionDataMap,\n        TLegacyInputs,\n        TConfig,\n        TConfigInput\n      >,\n): ExtensionDefinition<\n  TConfig &\n    (string extends keyof TConfigSchema\n      ? {}\n      : {\n          [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;\n        }),\n  TConfigInput &\n    (string extends keyof TConfigSchema\n      ? {}\n      : z.input<\n          z.ZodObject<{\n            [key in keyof TConfigSchema]: ReturnType<TConfigSchema[key]>;\n          }>\n        >),\n  UOutput,\n  TInputs,\n  {\n    kind: TKind;\n    namespace: TNamespace;\n    name: TName;\n  }\n> {\n  if ('configSchema' in options && 'config' in options) {\n    throw new Error(`Cannot provide both configSchema and config.schema`);\n  }\n  let configSchema: PortableSchema<any, any> | undefined;\n  if ('configSchema' in options) {\n    configSchema = options.configSchema;\n  }\n  if ('config' in options) {\n    const newConfigSchema = options.config?.schema;\n    configSchema =\n      newConfigSchema &&\n      createSchemaFromZod(innerZ =>\n        innerZ.object(\n          Object.fromEntries(\n            Object.entries(newConfigSchema).map(([k, v]) => [k, v(innerZ)]),\n          ),\n        ),\n      );\n  }\n\n  return {\n    $$type: '@backstage/ExtensionDefinition',\n    version: Symbol.iterator in options.output ? 'v2' : 'v1',\n    kind: options.kind,\n    namespace: options.namespace,\n    name: options.name,\n    attachTo: options.attachTo,\n    disabled: options.disabled ?? false,\n    inputs: options.inputs ?? {},\n    output: options.output,\n    configSchema,\n    factory: options.factory,\n    toString() {\n      const parts: string[] = [];\n      if (options.kind) {\n        parts.push(`kind=${options.kind}`);\n      }\n      if (options.namespace) {\n        parts.push(`namespace=${options.namespace}`);\n      }\n      if (options.name) {\n        parts.push(`name=${options.name}`);\n      }\n      parts.push(`attachTo=${options.attachTo.id}@${options.attachTo.input}`);\n      return `ExtensionDefinition{${parts.join(',')}}`;\n    },\n    override: <\n      TExtensionConfigSchema extends {\n        [key in string]: (zImpl: typeof z) => z.ZodType;\n      },\n      UOverrideFactoryOutput extends ExtensionDataValue<any, any>,\n      UNewOutput extends AnyExtensionDataRef,\n      TExtraInputs extends {\n        [inputName in string]: ExtensionInput<\n          AnyExtensionDataRef,\n          { optional: boolean; singleton: boolean }\n        >;\n      },\n    >(overrideOptions: {\n      attachTo?: { id: string; input: string };\n      disabled?: boolean;\n      inputs?: TExtraInputs;\n      output?: Array<UNewOutput>;\n      config?: {\n        schema: TExtensionConfigSchema;\n      };\n      factory(\n        originalFactory: (context?: {\n          config?: {\n            [key in keyof TConfigSchema]: z.infer<\n              ReturnType<TConfigSchema[key]>\n            >;\n          };\n          inputs?: ResolveInputValueOverrides<TInputs>;\n        }) => ExtensionDataContainer<UOutput>,\n        context: {\n          node: AppNode;\n          config: {\n            [key in keyof TExtensionConfigSchema]: z.infer<\n              ReturnType<TExtensionConfigSchema[key]>\n            >;\n          } & {\n            [key in keyof TConfigSchema]: z.infer<\n              ReturnType<TConfigSchema[key]>\n            >;\n          };\n          inputs: Expand<ResolvedExtensionInputs<TInputs & TExtraInputs>>;\n        },\n      ): Iterable<UOverrideFactoryOutput>;\n    }): ExtensionDefinition<\n      {\n        [key in keyof TExtensionConfigSchema]: z.infer<\n          ReturnType<TExtensionConfigSchema[key]>\n        >;\n      } & {\n        [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;\n      },\n      z.input<\n        z.ZodObject<\n          {\n            [key in keyof TExtensionConfigSchema]: ReturnType<\n              TExtensionConfigSchema[key]\n            >;\n          } & {\n            [key in keyof TConfigSchema]: ReturnType<TConfigSchema[key]>;\n          }\n        >\n      >,\n      AnyExtensionDataRef extends UNewOutput ? UOutput : UNewOutput,\n      TInputs & TExtraInputs,\n      {\n        kind: TKind;\n        namespace: TNamespace;\n        name: TName;\n      }\n    > => {\n      if (!Array.isArray(options.output)) {\n        throw new Error(\n          'Cannot override an extension that is not declared using the new format with outputs as an array',\n        );\n      }\n      const newOptions = options as CreateExtensionOptions<\n        TKind,\n        TNamespace,\n        TName,\n        UOutput,\n        TInputs,\n        TConfigSchema,\n        UFactoryOutput\n      >;\n      const overrideNewConfigSchema = overrideOptions.config?.schema;\n\n      const schema = {\n        ...newOptions.config?.schema,\n        ...overrideNewConfigSchema,\n      } as TConfigSchema & TExtensionConfigSchema;\n\n      return createExtension({\n        kind: newOptions.kind,\n        namespace: newOptions.namespace,\n        name: newOptions.name,\n        attachTo: overrideOptions.attachTo ?? newOptions.attachTo,\n        disabled: overrideOptions.disabled ?? newOptions.disabled,\n        inputs: { ...overrideOptions.inputs, ...newOptions.inputs },\n        output: overrideOptions.output ?? newOptions.output,\n        config: Object.keys(schema).length === 0 ? undefined : { schema },\n        factory: ({ node, config, inputs }) => {\n          if (!overrideOptions.factory) {\n            return newOptions.factory({\n              node,\n              config,\n              inputs: inputs as unknown as Expand<\n                ResolvedExtensionInputs<TInputs>\n              >,\n            });\n          }\n          const parentResult = overrideOptions.factory(\n            (innerContext?: {\n              config?: {\n                [key in keyof TConfigSchema]: z.infer<\n                  ReturnType<TConfigSchema[key]>\n                >;\n              };\n              inputs?: ResolveInputValueOverrides<TInputs>;\n            }): ExtensionDataContainer<UOutput> => {\n              return createExtensionDataContainer<UOutput>(\n                newOptions.factory({\n                  node,\n                  config: innerContext?.config ?? config,\n                  inputs: resolveInputOverrides(\n                    newOptions.inputs,\n                    inputs,\n                    innerContext?.inputs,\n                  ) as any, // TODO: Might be able to improve this once legacy inputs are gone\n                }) as Iterable<any>,\n                newOptions.output,\n              );\n            },\n            {\n              node,\n              config,\n              inputs,\n            },\n          );\n\n          const deduplicatedResult = new Map<string, UOverrideFactoryOutput>();\n          for (const item of parentResult) {\n            deduplicatedResult.set(item.id, item);\n          }\n\n          return deduplicatedResult.values() as Iterable<UOverrideFactoryOutput>;\n        },\n      } as CreateExtensionOptions<TKind, TNamespace, TName, AnyExtensionDataRef extends UNewOutput ? UOutput : UNewOutput, TInputs & TExtraInputs, TConfigSchema & TExtensionConfigSchema, UOverrideFactoryOutput>);\n    },\n  } as InternalExtensionDefinition<\n    TConfig &\n      (string extends keyof TConfigSchema\n        ? {}\n        : {\n            [key in keyof TConfigSchema]: z.infer<\n              ReturnType<TConfigSchema[key]>\n            >;\n          }),\n    TConfigInput &\n      (string extends keyof TConfigSchema\n        ? {}\n        : z.input<\n            z.ZodObject<{\n              [key in keyof TConfigSchema]: ReturnType<TConfigSchema[key]>;\n            }>\n          >),\n    UOutput,\n    TInputs,\n    {\n      kind: TKind;\n      namespace: TNamespace;\n      name: TName;\n    }\n  >;\n}\n"],"names":[],"mappings":"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"}

package/dist/wiring/createExtensionBlueprint.esm.js

@@ -1,4 +1,6 @@
 import { createExtension } from './createExtension.esm.js';
+import { createExtensionDataContainer } from './createExtensionDataContainer.esm.js';
+import { resolveInputOverrides } from './resolveInputOverrides.esm.js';
 
 class ExtensionBlueprintImpl {
   constructor(options) {
@@ -6,50 +8,59 @@ class ExtensionBlueprintImpl {
     this.dataRefs = options.dataRefs;
   }
   dataRefs;
-  make(args) {
-    const optionsSchema = typeof this.options.config?.schema === "function" ? this.options.config?.schema(args.params) : this.options.config?.schema;
+  makeWithOverrides(args) {
     const schema = {
-      ...optionsSchema,
+      ...this.options.config?.schema,
       ...args.config?.schema
     };
-    const namespace = typeof this.options.namespace === "function" ? this.options.namespace(args.params) : this.options.namespace;
-    const name = typeof this.options.name === "function" ? this.options.name(args.params) : this.options.name;
     return createExtension({
       kind: this.options.kind,
-      namespace: args.namespace ?? namespace,
-      name: args.name ?? name,
+      namespace: args.namespace ?? this.options.namespace,
+      name: args.name ?? this.options.name,
       attachTo: args.attachTo ?? this.options.attachTo,
       disabled: args.disabled ?? this.options.disabled,
-      inputs: args.inputs ?? this.options.inputs,
-      output: [...args.output ?? [], ...this.options.output],
+      inputs: { ...args.inputs, ...this.options.inputs },
+      output: args.output ?? this.options.output,
       config: Object.keys(schema).length === 0 ? void 0 : { schema },
       factory: ({ node, config, inputs }) => {
-        if (args.factory) {
-          return args.factory(
-            (innerParams, innerContext) => {
-              return this.options.factory(innerParams, {
+        return args.factory(
+          (innerParams, innerContext) => {
+            return createExtensionDataContainer(
+              this.options.factory(innerParams, {
                 node,
                 config: innerContext?.config ?? config,
-                inputs: innerContext?.inputs ?? inputs
-              });
-            },
-            {
-              node,
-              config,
-              inputs
-            }
-          );
-        } else if (args.params) {
-          return this.options.factory(args.params, {
+                inputs: resolveInputOverrides(
+                  this.options.inputs,
+                  inputs,
+                  innerContext?.inputs
+                )
+                // TODO: Might be able to improve this once legacy inputs are gone
+              }),
+              this.options.output
+            );
+          },
+          {
             node,
             config,
             inputs
-          });
-        }
-        throw new Error("Either params or factory must be provided");
+          }
+        );
       }
     });
   }
+  make(args) {
+    return createExtension({
+      kind: this.options.kind,
+      namespace: args.namespace ?? this.options.namespace,
+      name: args.name ?? this.options.name,
+      attachTo: args.attachTo ?? this.options.attachTo,
+      disabled: args.disabled ?? this.options.disabled,
+      inputs: this.options.inputs,
+      output: this.options.output,
+      config: this.options.config,
+      factory: (ctx) => this.options.factory(args.params, ctx)
+    });
+  }
 }
 function createExtensionBlueprint(options) {
   return new ExtensionBlueprintImpl(options);

package/dist/wiring/createExtensionBlueprint.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"createExtensionBlueprint.esm.js","sources":["../../src/wiring/createExtensionBlueprint.ts"],"sourcesContent":["/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { AppNode } from '../apis';\nimport { Expand } from '../types';\nimport {\n  CreateExtensionOptions,\n  ExtensionDefinition,\n  ResolvedExtensionInputs,\n  VerifyExtensionFactoryOutput,\n  createExtension,\n} from './createExtension';\nimport { z } from 'zod';\nimport { ExtensionInput } from './createExtensionInput';\nimport {\n  AnyExtensionDataRef,\n  ExtensionDataRefToValue,\n  ExtensionDataValue,\n} from './createExtensionDataRef';\n\n/**\n * @public\n */\nexport type CreateExtensionBlueprintOptions<\n  TParams,\n  UOutput extends AnyExtensionDataRef,\n  TInputs extends {\n    [inputName in string]: ExtensionInput<\n      AnyExtensionDataRef,\n      { optional: boolean; singleton: boolean }\n    >;\n  },\n  TConfigSchema extends { [key in string]: (zImpl: typeof z) => z.ZodType },\n  UFactoryOutput extends ExtensionDataValue<any, any>,\n  TDataRefs extends { [name in string]: AnyExtensionDataRef },\n> = {\n  kind: string;\n  namespace?: string | ((params: TParams) => string);\n  attachTo: { id: string; input: string };\n  disabled?: boolean;\n  inputs?: TInputs;\n  output: Array<UOutput>;\n  name?: string | ((params: TParams) => string);\n  config?: {\n    schema: TConfigSchema | ((params: TParams) => TConfigSchema);\n  };\n  factory(\n    params: TParams,\n    context: {\n      node: AppNode;\n      config: {\n        [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;\n      };\n      inputs: Expand<ResolvedExtensionInputs<TInputs>>;\n    },\n  ): Iterable<UFactoryOutput>;\n\n  dataRefs?: TDataRefs;\n} & VerifyExtensionFactoryOutput<UOutput, UFactoryOutput>;\n\n/**\n * @public\n */\nexport interface ExtensionBlueprint<\n  TParams,\n  UOutput extends AnyExtensionDataRef,\n  TInputs extends {\n    [inputName in string]: ExtensionInput<\n      AnyExtensionDataRef,\n      { optional: boolean; singleton: boolean }\n    >;\n  },\n  UExtraOutput extends AnyExtensionDataRef,\n  TConfig extends { [key in string]: unknown },\n  TConfigInput extends { [key in string]: unknown },\n  TDataRefs extends { [name in string]: AnyExtensionDataRef },\n> {\n  dataRefs: TDataRefs;\n\n  /**\n   * Creates a new extension from the blueprint.\n   *\n   * You must either pass `params` directly, or define a `factory` that can\n   * optionally call the original factory with the same params.\n   */\n  make<\n    TExtensionConfigSchema extends {\n      [key in string]: (zImpl: typeof z) => z.ZodType;\n    },\n    UFactoryOutput extends ExtensionDataValue<any, any>,\n  >(\n    args: {\n      namespace?: string;\n      name?: string;\n      attachTo?: { id: string; input: string };\n      disabled?: boolean;\n      inputs?: TInputs;\n      output?: Array<UExtraOutput>;\n      config?: {\n        schema: TExtensionConfigSchema & {\n          [KName in keyof TConfig]?: `Error: Config key '${KName &\n            string}' is already defined in parent schema`;\n        };\n      };\n    } & (\n      | ({\n          factory(\n            originalFactory: (\n              params: TParams,\n              context?: {\n                config?: TConfig;\n                inputs?: Expand<ResolvedExtensionInputs<TInputs>>;\n              },\n            ) => Iterable<ExtensionDataRefToValue<UOutput>>,\n            context: {\n              node: AppNode;\n              config: TConfig & {\n                [key in keyof TExtensionConfigSchema]: z.infer<\n                  ReturnType<TExtensionConfigSchema[key]>\n                >;\n              };\n              inputs: Expand<ResolvedExtensionInputs<TInputs>>;\n            },\n          ): Iterable<UFactoryOutput>;\n        } & VerifyExtensionFactoryOutput<\n          UOutput & UExtraOutput,\n          UFactoryOutput\n        >)\n      | {\n          params: TParams;\n        }\n    ),\n  ): ExtensionDefinition<\n    {\n      [key in keyof TExtensionConfigSchema]: z.infer<\n        ReturnType<TExtensionConfigSchema[key]>\n      >;\n    } & TConfig,\n    z.input<\n      z.ZodObject<{\n        [key in keyof TExtensionConfigSchema]: ReturnType<\n          TExtensionConfigSchema[key]\n        >;\n      }>\n    > &\n      TConfigInput\n  >;\n}\n\n/**\n * @internal\n */\nclass ExtensionBlueprintImpl<\n  TParams,\n  UOutput extends AnyExtensionDataRef,\n  TInputs extends {\n    [inputName in string]: ExtensionInput<\n      AnyExtensionDataRef,\n      { optional: boolean; singleton: boolean }\n    >;\n  },\n  UExtraOutput extends AnyExtensionDataRef,\n  TConfigSchema extends { [key in string]: (zImpl: typeof z) => z.ZodType },\n  TDataRefs extends { [name in string]: AnyExtensionDataRef },\n> {\n  constructor(\n    private readonly options: CreateExtensionBlueprintOptions<\n      TParams,\n      UOutput,\n      TInputs,\n      TConfigSchema,\n      any,\n      TDataRefs\n    >,\n  ) {\n    this.dataRefs = options.dataRefs!;\n  }\n\n  dataRefs: TDataRefs;\n\n  public make<\n    TExtensionConfigSchema extends {\n      [key in string]: (zImpl: typeof z) => z.ZodType;\n    },\n    UFactoryOutput extends ExtensionDataValue<any, any>,\n  >(args: {\n    namespace?: string;\n    name?: string;\n    attachTo?: { id: string; input: string };\n    disabled?: boolean;\n    inputs?: TInputs;\n    output?: Array<UExtraOutput>;\n    params?: TParams;\n    config?: {\n      schema: TExtensionConfigSchema;\n    };\n    factory?(\n      originalFactory: (\n        params: TParams,\n        context?: {\n          config?: {\n            [key in keyof TConfigSchema]: z.infer<\n              ReturnType<TConfigSchema[key]>\n            >;\n          };\n          inputs?: Expand<ResolvedExtensionInputs<TInputs>>;\n        },\n      ) => Iterable<ExtensionDataRefToValue<UOutput>>,\n      context: {\n        node: AppNode;\n        config: {\n          [key in keyof TExtensionConfigSchema]: z.infer<\n            ReturnType<TExtensionConfigSchema[key]>\n          >;\n        } & {\n          [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;\n        };\n        inputs: Expand<ResolvedExtensionInputs<TInputs>>;\n      },\n    ): Iterable<UFactoryOutput>;\n  }): ExtensionDefinition<\n    {\n      [key in keyof TExtensionConfigSchema]: z.infer<\n        ReturnType<TExtensionConfigSchema[key]>\n      >;\n    } & {\n      [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;\n    },\n    z.input<\n      z.ZodObject<\n        {\n          [key in keyof TExtensionConfigSchema]: ReturnType<\n            TExtensionConfigSchema[key]\n          >;\n        } & {\n          [key in keyof TConfigSchema]: ReturnType<TConfigSchema[key]>;\n        }\n      >\n    >\n  > {\n    const optionsSchema =\n      typeof this.options.config?.schema === 'function'\n        ? this.options.config?.schema(args.params!)\n        : this.options.config?.schema;\n\n    const schema = {\n      ...optionsSchema,\n      ...args.config?.schema,\n    } as TConfigSchema & TExtensionConfigSchema;\n\n    const namespace =\n      typeof this.options.namespace === 'function'\n        ? this.options.namespace(args.params!)\n        : this.options.namespace;\n\n    const name =\n      typeof this.options.name === 'function'\n        ? this.options.name(args.params!)\n        : this.options.name;\n\n    return createExtension({\n      kind: this.options.kind,\n      namespace: args.namespace ?? namespace,\n      name: args.name ?? name,\n      attachTo: args.attachTo ?? this.options.attachTo,\n      disabled: args.disabled ?? this.options.disabled,\n      inputs: args.inputs ?? this.options.inputs,\n      output: [...(args.output ?? []), ...this.options.output],\n      config: Object.keys(schema).length === 0 ? undefined : { schema },\n      factory: ({ node, config, inputs }) => {\n        if (args.factory) {\n          return args.factory(\n            (\n              innerParams: TParams,\n              innerContext?: {\n                config?: {\n                  [key in keyof TConfigSchema]: z.infer<\n                    ReturnType<TConfigSchema[key]>\n                  >;\n                };\n                inputs?: Expand<ResolvedExtensionInputs<TInputs>>;\n              },\n            ): Iterable<ExtensionDataRefToValue<UOutput>> => {\n              return this.options.factory(innerParams, {\n                node,\n                config: innerContext?.config ?? config,\n                inputs: innerContext?.inputs ?? inputs,\n              });\n            },\n            {\n              node,\n              config,\n              inputs,\n            },\n          );\n        } else if (args.params) {\n          return this.options.factory(args.params, {\n            node,\n            config,\n            inputs,\n          });\n        }\n        throw new Error('Either params or factory must be provided');\n      },\n    } as CreateExtensionOptions<\n      UOutput,\n      TInputs,\n      {\n        [key in keyof TExtensionConfigSchema]: z.infer<\n          ReturnType<TExtensionConfigSchema[key]>\n        >;\n      } & {\n        [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;\n      },\n      z.input<\n        z.ZodObject<\n          {\n            [key in keyof TExtensionConfigSchema]: ReturnType<\n              TExtensionConfigSchema[key]\n            >;\n          } & {\n            [key in keyof TConfigSchema]: ReturnType<TConfigSchema[key]>;\n          }\n        >\n      >,\n      TConfigSchema,\n      UFactoryOutput\n    >);\n  }\n}\n\n/**\n * A simpler replacement for wrapping up `createExtension` inside a kind or type. This allows for a cleaner API for creating\n * types and instances of those types.\n *\n * @public\n */\nexport function createExtensionBlueprint<\n  TParams,\n  UOutput extends AnyExtensionDataRef,\n  TInputs extends {\n    [inputName in string]: ExtensionInput<\n      AnyExtensionDataRef,\n      { optional: boolean; singleton: boolean }\n    >;\n  },\n  UExtraOutput extends AnyExtensionDataRef,\n  TConfigSchema extends { [key in string]: (zImpl: typeof z) => z.ZodType },\n  UFactoryOutput extends ExtensionDataValue<any, any>,\n  TDataRefs extends { [name in string]: AnyExtensionDataRef } = never,\n>(\n  options: CreateExtensionBlueprintOptions<\n    TParams,\n    UOutput,\n    TInputs,\n    TConfigSchema,\n    UFactoryOutput,\n    TDataRefs\n  >,\n): ExtensionBlueprint<\n  TParams,\n  UOutput,\n  TInputs,\n  UExtraOutput,\n  string extends keyof TConfigSchema\n    ? {}\n    : { [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>> },\n  string extends keyof TConfigSchema\n    ? {}\n    : z.input<\n        z.ZodObject<{\n          [key in keyof TConfigSchema]: ReturnType<TConfigSchema[key]>;\n        }>\n      >,\n  TDataRefs\n> {\n  return new ExtensionBlueprintImpl(options) as ExtensionBlueprint<\n    TParams,\n    UOutput,\n    TInputs,\n    UExtraOutput,\n    string extends keyof TConfigSchema\n      ? {}\n      : {\n          [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;\n        },\n    string extends keyof TConfigSchema\n      ? {}\n      : z.input<\n          z.ZodObject<{\n            [key in keyof TConfigSchema]: ReturnType<TConfigSchema[key]>;\n          }>\n        >,\n    TDataRefs\n  >;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"createExtensionBlueprint.esm.js","sources":["../../src/wiring/createExtensionBlueprint.ts"],"sourcesContent":["/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { AppNode } from '../apis';\nimport { Expand } from '../types';\nimport {\n  CreateExtensionOptions,\n  ExtensionDefinition,\n  ResolvedExtensionInputs,\n  VerifyExtensionFactoryOutput,\n  createExtension,\n} from './createExtension';\nimport { z } from 'zod';\nimport { ExtensionInput } from './createExtensionInput';\nimport {\n  AnyExtensionDataRef,\n  ExtensionDataValue,\n} from './createExtensionDataRef';\nimport {\n  ExtensionDataContainer,\n  createExtensionDataContainer,\n} from './createExtensionDataContainer';\nimport {\n  ResolveInputValueOverrides,\n  resolveInputOverrides,\n} from './resolveInputOverrides';\n\n/**\n * @public\n */\nexport type CreateExtensionBlueprintOptions<\n  TKind extends string,\n  TNamespace extends string | undefined,\n  TName extends string | undefined,\n  TParams,\n  UOutput extends AnyExtensionDataRef,\n  TInputs extends {\n    [inputName in string]: ExtensionInput<\n      AnyExtensionDataRef,\n      { optional: boolean; singleton: boolean }\n    >;\n  },\n  TConfigSchema extends { [key in string]: (zImpl: typeof z) => z.ZodType },\n  UFactoryOutput extends ExtensionDataValue<any, any>,\n  TDataRefs extends { [name in string]: AnyExtensionDataRef },\n> = {\n  kind: TKind;\n  namespace?: TNamespace;\n  attachTo: { id: string; input: string };\n  disabled?: boolean;\n  inputs?: TInputs;\n  output: Array<UOutput>;\n  name?: TName;\n  config?: {\n    schema: TConfigSchema;\n  };\n  factory(\n    params: TParams,\n    context: {\n      node: AppNode;\n      config: {\n        [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;\n      };\n      inputs: Expand<ResolvedExtensionInputs<TInputs>>;\n    },\n  ): Iterable<UFactoryOutput>;\n\n  dataRefs?: TDataRefs;\n} & VerifyExtensionFactoryOutput<UOutput, UFactoryOutput>;\n\n/**\n * @public\n */\nexport interface ExtensionBlueprint<\n  TIdParts extends {\n    kind: string;\n    namespace?: string;\n    name?: string;\n  },\n  TParams,\n  UOutput extends AnyExtensionDataRef,\n  TInputs extends {\n    [inputName in string]: ExtensionInput<\n      AnyExtensionDataRef,\n      { optional: boolean; singleton: boolean }\n    >;\n  },\n  TConfig extends { [key in string]: unknown },\n  TConfigInput extends { [key in string]: unknown },\n  TDataRefs extends { [name in string]: AnyExtensionDataRef },\n> {\n  dataRefs: TDataRefs;\n\n  make<\n    TNewNamespace extends string | undefined,\n    TNewName extends string | undefined,\n  >(args: {\n    namespace?: TNewNamespace;\n    name?: TNewName;\n    attachTo?: { id: string; input: string };\n    disabled?: boolean;\n    params: TParams;\n  }): ExtensionDefinition<\n    TConfig,\n    TConfigInput,\n    UOutput,\n    TInputs,\n    {\n      kind: TIdParts['kind'];\n      namespace: string | undefined extends TNewNamespace\n        ? TIdParts['namespace']\n        : TNewNamespace;\n      name: string | undefined extends TNewName ? TIdParts['name'] : TNewName;\n    }\n  >;\n\n  /**\n   * Creates a new extension from the blueprint.\n   *\n   * You must either pass `params` directly, or define a `factory` that can\n   * optionally call the original factory with the same params.\n   */\n  makeWithOverrides<\n    TNewNamespace extends string | undefined,\n    TNewName extends string | undefined,\n    TExtensionConfigSchema extends {\n      [key in string]: (zImpl: typeof z) => z.ZodType;\n    },\n    UFactoryOutput extends ExtensionDataValue<any, any>,\n    UNewOutput extends AnyExtensionDataRef,\n    TExtraInputs extends {\n      [inputName in string]: ExtensionInput<\n        AnyExtensionDataRef,\n        { optional: boolean; singleton: boolean }\n      >;\n    },\n  >(args: {\n    namespace?: TNewNamespace;\n    name?: TNewName;\n    attachTo?: { id: string; input: string };\n    disabled?: boolean;\n    inputs?: TExtraInputs & {\n      [KName in keyof TInputs]?: `Error: Input '${KName &\n        string}' is already defined in parent definition`;\n    };\n    output?: Array<UNewOutput>;\n    config?: {\n      schema: TExtensionConfigSchema & {\n        [KName in keyof TConfig]?: `Error: Config key '${KName &\n          string}' is already defined in parent schema`;\n      };\n    };\n    factory(\n      originalFactory: (\n        params: TParams,\n        context?: {\n          config?: TConfig;\n          inputs?: ResolveInputValueOverrides<TInputs>;\n        },\n      ) => ExtensionDataContainer<UOutput>,\n      context: {\n        node: AppNode;\n        config: TConfig & {\n          [key in keyof TExtensionConfigSchema]: z.infer<\n            ReturnType<TExtensionConfigSchema[key]>\n          >;\n        };\n        inputs: Expand<ResolvedExtensionInputs<TInputs & TExtraInputs>>;\n      },\n    ): Iterable<UFactoryOutput> &\n      VerifyExtensionFactoryOutput<\n        AnyExtensionDataRef extends UNewOutput ? UOutput : UNewOutput,\n        UFactoryOutput\n      >;\n  }): ExtensionDefinition<\n    {\n      [key in keyof TExtensionConfigSchema]: z.infer<\n        ReturnType<TExtensionConfigSchema[key]>\n      >;\n    } & TConfig,\n    z.input<\n      z.ZodObject<{\n        [key in keyof TExtensionConfigSchema]: ReturnType<\n          TExtensionConfigSchema[key]\n        >;\n      }>\n    > &\n      TConfigInput,\n    AnyExtensionDataRef extends UNewOutput ? UOutput : UNewOutput,\n    TInputs & TExtraInputs,\n    {\n      kind: TIdParts['kind'];\n      namespace: string | undefined extends TNewNamespace\n        ? TIdParts['namespace']\n        : TNewNamespace;\n      name: string | undefined extends TNewName ? TIdParts['name'] : TNewName;\n    }\n  >;\n}\n\n/**\n * @internal\n */\nclass ExtensionBlueprintImpl<\n  TKind extends string,\n  TNamespace extends string | undefined,\n  TName extends string | undefined,\n  TParams,\n  UOutput extends AnyExtensionDataRef,\n  TInputs extends {\n    [inputName in string]: ExtensionInput<\n      AnyExtensionDataRef,\n      { optional: boolean; singleton: boolean }\n    >;\n  },\n  TConfigSchema extends { [key in string]: (zImpl: typeof z) => z.ZodType },\n  TDataRefs extends { [name in string]: AnyExtensionDataRef },\n> {\n  constructor(\n    private readonly options: CreateExtensionBlueprintOptions<\n      TKind,\n      TNamespace,\n      TName,\n      TParams,\n      UOutput,\n      TInputs,\n      TConfigSchema,\n      any,\n      TDataRefs\n    >,\n  ) {\n    this.dataRefs = options.dataRefs!;\n  }\n\n  dataRefs: TDataRefs;\n\n  public makeWithOverrides<\n    TExtensionConfigSchema extends {\n      [key in string]: (zImpl: typeof z) => z.ZodType;\n    },\n    UFactoryOutput extends ExtensionDataValue<any, any>,\n    UNewOutput extends AnyExtensionDataRef,\n    TExtraInputs extends {\n      [inputName in string]: ExtensionInput<\n        AnyExtensionDataRef,\n        { optional: boolean; singleton: boolean }\n      >;\n    },\n    TNewNamespace extends string | undefined = undefined,\n    TNewName extends string | undefined = undefined,\n  >(args: {\n    namespace?: TNewNamespace;\n    name?: TNewName;\n    attachTo?: { id: string; input: string };\n    disabled?: boolean;\n    inputs?: TExtraInputs;\n    output?: Array<UNewOutput>;\n    config?: {\n      schema: TExtensionConfigSchema;\n    };\n    factory(\n      originalFactory: (\n        params: TParams,\n        context?: {\n          config?: {\n            [key in keyof TConfigSchema]: z.infer<\n              ReturnType<TConfigSchema[key]>\n            >;\n          };\n          inputs?: ResolveInputValueOverrides<TInputs>;\n        },\n      ) => ExtensionDataContainer<UOutput>,\n      context: {\n        node: AppNode;\n        config: {\n          [key in keyof TExtensionConfigSchema]: z.infer<\n            ReturnType<TExtensionConfigSchema[key]>\n          >;\n        } & {\n          [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;\n        };\n        inputs: Expand<ResolvedExtensionInputs<TInputs & TExtraInputs>>;\n      },\n    ): Iterable<UFactoryOutput>;\n  }): ExtensionDefinition<\n    {\n      [key in keyof TExtensionConfigSchema]: z.infer<\n        ReturnType<TExtensionConfigSchema[key]>\n      >;\n    } & {\n      [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;\n    },\n    z.input<\n      z.ZodObject<\n        {\n          [key in keyof TExtensionConfigSchema]: ReturnType<\n            TExtensionConfigSchema[key]\n          >;\n        } & {\n          [key in keyof TConfigSchema]: ReturnType<TConfigSchema[key]>;\n        }\n      >\n    >\n  > {\n    const schema = {\n      ...this.options.config?.schema,\n      ...args.config?.schema,\n    } as TConfigSchema & TExtensionConfigSchema;\n\n    return createExtension({\n      kind: this.options.kind,\n      namespace: args.namespace ?? this.options.namespace,\n      name: args.name ?? this.options.name,\n      attachTo: args.attachTo ?? this.options.attachTo,\n      disabled: args.disabled ?? this.options.disabled,\n      inputs: { ...args.inputs, ...this.options.inputs },\n      output: args.output ?? this.options.output,\n      config: Object.keys(schema).length === 0 ? undefined : { schema },\n      factory: ({ node, config, inputs }) => {\n        return args.factory(\n          (\n            innerParams: TParams,\n            innerContext?: {\n              config?: {\n                [key in keyof TConfigSchema]: z.infer<\n                  ReturnType<TConfigSchema[key]>\n                >;\n              };\n              inputs?: ResolveInputValueOverrides;\n            },\n          ): ExtensionDataContainer<UOutput> => {\n            return createExtensionDataContainer<UOutput>(\n              this.options.factory(innerParams, {\n                node,\n                config: innerContext?.config ?? config,\n                inputs: resolveInputOverrides(\n                  this.options.inputs,\n                  inputs,\n                  innerContext?.inputs,\n                ) as any, // TODO: Might be able to improve this once legacy inputs are gone\n              }),\n              this.options.output,\n            );\n          },\n          {\n            node,\n            config,\n            inputs,\n          },\n        );\n      },\n    } as CreateExtensionOptions<TKind, string | undefined extends TNewNamespace ? TNamespace : TNewNamespace, string | undefined extends TNewName ? TName : TNewName, AnyExtensionDataRef extends UNewOutput ? UOutput : UNewOutput, TInputs & TExtraInputs, TConfigSchema & TExtensionConfigSchema, UFactoryOutput>);\n  }\n\n  public make<\n    TNewNamespace extends string | undefined = undefined,\n    TNewName extends string | undefined = undefined,\n  >(args: {\n    namespace?: TNewNamespace;\n    name?: TNewName;\n    attachTo?: { id: string; input: string };\n    disabled?: boolean;\n    params: TParams;\n  }): ExtensionDefinition<\n    {\n      [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;\n    },\n    z.input<\n      z.ZodObject<{\n        [key in keyof TConfigSchema]: ReturnType<TConfigSchema[key]>;\n      }>\n    >\n  > {\n    return createExtension({\n      kind: this.options.kind,\n      namespace: args.namespace ?? this.options.namespace,\n      name: args.name ?? this.options.name,\n      attachTo: args.attachTo ?? this.options.attachTo,\n      disabled: args.disabled ?? this.options.disabled,\n      inputs: this.options.inputs,\n      output: this.options.output,\n      config: this.options.config,\n      factory: ctx => this.options.factory(args.params, ctx),\n    } as CreateExtensionOptions<TKind, string | undefined extends TNewNamespace ? TNamespace : TNewNamespace, string | undefined extends TNewName ? TName : TNewName, UOutput, TInputs, TConfigSchema, any>);\n  }\n}\n\n/**\n * A simpler replacement for wrapping up `createExtension` inside a kind or type. This allows for a cleaner API for creating\n * types and instances of those types.\n *\n * @public\n */\nexport function createExtensionBlueprint<\n  TParams,\n  UOutput extends AnyExtensionDataRef,\n  TInputs extends {\n    [inputName in string]: ExtensionInput<\n      AnyExtensionDataRef,\n      { optional: boolean; singleton: boolean }\n    >;\n  },\n  TConfigSchema extends { [key in string]: (zImpl: typeof z) => z.ZodType },\n  UFactoryOutput extends ExtensionDataValue<any, any>,\n  TKind extends string,\n  TNamespace extends string | undefined = undefined,\n  TName extends string | undefined = undefined,\n  TDataRefs extends { [name in string]: AnyExtensionDataRef } = never,\n>(\n  options: CreateExtensionBlueprintOptions<\n    TKind,\n    TNamespace,\n    TName,\n    TParams,\n    UOutput,\n    TInputs,\n    TConfigSchema,\n    UFactoryOutput,\n    TDataRefs\n  >,\n): ExtensionBlueprint<\n  {\n    kind: TKind;\n    namespace: TNamespace;\n    name: TName;\n  },\n  TParams,\n  UOutput,\n  string extends keyof TInputs ? {} : TInputs,\n  string extends keyof TConfigSchema\n    ? {}\n    : { [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>> },\n  string extends keyof TConfigSchema\n    ? {}\n    : z.input<\n        z.ZodObject<{\n          [key in keyof TConfigSchema]: ReturnType<TConfigSchema[key]>;\n        }>\n      >,\n  TDataRefs\n> {\n  return new ExtensionBlueprintImpl(options) as ExtensionBlueprint<\n    {\n      kind: TKind;\n      namespace: TNamespace;\n      name: TName;\n    },\n    TParams,\n    UOutput,\n    string extends keyof TInputs ? {} : TInputs,\n    string extends keyof TConfigSchema\n      ? {}\n      : {\n          [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;\n        },\n    string extends keyof TConfigSchema\n      ? {}\n      : z.input<\n          z.ZodObject<{\n            [key in keyof TConfigSchema]: ReturnType<TConfigSchema[key]>;\n          }>\n        >,\n    TDataRefs\n  >;\n}\n"],"names":[],"mappings":"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"}

package/dist/wiring/createExtensionDataContainer.esm.js

@@ -0,0 +1,31 @@
+function createExtensionDataContainer(values, declaredRefs) {
+  const container = /* @__PURE__ */ new Map();
+  const verifyRefs = declaredRefs && new Map(declaredRefs.map((ref) => [ref.id, ref]));
+  for (const output of values) {
+    if (verifyRefs) {
+      if (!verifyRefs.delete(output.id)) {
+        throw new Error(
+          `extension data '${output.id}' was provided but not declared`
+        );
+      }
+    }
+    container.set(output.id, output);
+  }
+  const remainingRefs = verifyRefs && Array.from(verifyRefs.values()).filter((ref) => !ref.config.optional);
+  if (remainingRefs && remainingRefs.length > 0) {
+    throw new Error(
+      `missing required extension data value(s) '${remainingRefs.map((ref) => ref.id).join(", ")}'`
+    );
+  }
+  return {
+    get(ref) {
+      return container.get(ref.id)?.value;
+    },
+    [Symbol.iterator]() {
+      return container.values();
+    }
+  };
+}
+
+export { createExtensionDataContainer };
+//# sourceMappingURL=createExtensionDataContainer.esm.js.map

package/dist/wiring/createExtensionDataContainer.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createExtensionDataContainer.esm.js","sources":["../../src/wiring/createExtensionDataContainer.ts"],"sourcesContent":["/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  AnyExtensionDataRef,\n  ExtensionDataRef,\n  ExtensionDataValue,\n} from './createExtensionDataRef';\n\n/** @public */\nexport type ExtensionDataContainer<UExtensionData extends AnyExtensionDataRef> =\n  Iterable<\n    UExtensionData extends ExtensionDataRef<\n      infer IData,\n      infer IId,\n      infer IConfig\n    >\n      ? IConfig['optional'] extends true\n        ? never\n        : ExtensionDataValue<IData, IId>\n      : never\n  > & {\n    get<TId extends UExtensionData['id']>(\n      ref: ExtensionDataRef<any, TId, any>,\n    ): UExtensionData extends ExtensionDataRef<infer IData, TId, infer IConfig>\n      ? IConfig['optional'] extends true\n        ? IData | undefined\n        : IData\n      : never;\n  };\n\n/** @internal */\nexport function createExtensionDataContainer<UData extends AnyExtensionDataRef>(\n  values: Iterable<\n    UData extends ExtensionDataRef<infer IData, infer IId>\n      ? ExtensionDataValue<IData, IId>\n      : never\n  >,\n  declaredRefs?: ExtensionDataRef<any, any, any>[],\n): ExtensionDataContainer<UData> {\n  const container = new Map<string, ExtensionDataValue<any, any>>();\n  const verifyRefs =\n    declaredRefs && new Map(declaredRefs.map(ref => [ref.id, ref]));\n\n  for (const output of values) {\n    if (verifyRefs) {\n      if (!verifyRefs.delete(output.id)) {\n        throw new Error(\n          `extension data '${output.id}' was provided but not declared`,\n        );\n      }\n    }\n    container.set(output.id, output);\n  }\n\n  const remainingRefs =\n    verifyRefs &&\n    Array.from(verifyRefs.values()).filter(ref => !ref.config.optional);\n  if (remainingRefs && remainingRefs.length > 0) {\n    throw new Error(\n      `missing required extension data value(s) '${remainingRefs\n        .map(ref => ref.id)\n        .join(', ')}'`,\n    );\n  }\n\n  return {\n    get(ref) {\n      return container.get(ref.id)?.value;\n    },\n    [Symbol.iterator]() {\n      return container.values();\n    },\n  } as ExtensionDataContainer<UData>;\n}\n"],"names":[],"mappings":"AA6CgB,SAAA,4BAAA,CACd,QAKA,YAC+B,EAAA;AAC/B,EAAM,MAAA,SAAA,uBAAgB,GAA0C,EAAA,CAAA;AAChE,EAAA,MAAM,UACJ,GAAA,YAAA,IAAgB,IAAI,GAAA,CAAI,YAAa,CAAA,GAAA,CAAI,CAAO,GAAA,KAAA,CAAC,GAAI,CAAA,EAAA,EAAI,GAAG,CAAC,CAAC,CAAA,CAAA;AAEhE,EAAA,KAAA,MAAW,UAAU,MAAQ,EAAA;AAC3B,IAAA,IAAI,UAAY,EAAA;AACd,MAAA,IAAI,CAAC,UAAA,CAAW,MAAO,CAAA,MAAA,CAAO,EAAE,CAAG,EAAA;AACjC,QAAA,MAAM,IAAI,KAAA;AAAA,UACR,CAAA,gBAAA,EAAmB,OAAO,EAAE,CAAA,+BAAA,CAAA;AAAA,SAC9B,CAAA;AAAA,OACF;AAAA,KACF;AACA,IAAU,SAAA,CAAA,GAAA,CAAI,MAAO,CAAA,EAAA,EAAI,MAAM,CAAA,CAAA;AAAA,GACjC;AAEA,EAAA,MAAM,aACJ,GAAA,UAAA,IACA,KAAM,CAAA,IAAA,CAAK,UAAW,CAAA,MAAA,EAAQ,CAAA,CAAE,MAAO,CAAA,CAAA,GAAA,KAAO,CAAC,GAAA,CAAI,OAAO,QAAQ,CAAA,CAAA;AACpE,EAAI,IAAA,aAAA,IAAiB,aAAc,CAAA,MAAA,GAAS,CAAG,EAAA;AAC7C,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,0CAAA,EAA6C,cAC1C,GAAI,CAAA,CAAA,GAAA,KAAO,IAAI,EAAE,CAAA,CACjB,IAAK,CAAA,IAAI,CAAC,CAAA,CAAA,CAAA;AAAA,KACf,CAAA;AAAA,GACF;AAEA,EAAO,OAAA;AAAA,IACL,IAAI,GAAK,EAAA;AACP,MAAA,OAAO,SAAU,CAAA,GAAA,CAAI,GAAI,CAAA,EAAE,CAAG,EAAA,KAAA,CAAA;AAAA,KAChC;AAAA,IACA,CAAC,MAAO,CAAA,QAAQ,CAAI,GAAA;AAClB,MAAA,OAAO,UAAU,MAAO,EAAA,CAAA;AAAA,KAC1B;AAAA,GACF,CAAA;AACF;;;;"}

package/dist/wiring/createExtensionDataRef.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"createExtensionDataRef.esm.js","sources":["../../src/wiring/createExtensionDataRef.ts"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/** @public */\nexport type ExtensionDataValue<TData, TId extends string> = {\n  readonly $$type: '@backstage/ExtensionDataValue';\n  readonly id: TId;\n  readonly value: TData;\n};\n\n/** @public */\nexport type ExtensionDataRef<\n  TData,\n  TId extends string = string,\n  TConfig extends { optional?: true } = {},\n> = {\n  readonly $$type: '@backstage/ExtensionDataRef';\n  readonly id: TId;\n  readonly T: TData;\n  readonly config: TConfig;\n};\n\n/** @public */\nexport type ExtensionDataRefToValue<TDataRef extends AnyExtensionDataRef> =\n  TDataRef extends ExtensionDataRef<infer IData, infer IId, any>\n    ? ExtensionDataValue<IData, IId>\n    : never;\n\n/** @public */\nexport type AnyExtensionDataRef = ExtensionDataRef<\n  unknown,\n  string,\n  { optional?: true }\n>;\n\n/** @public */\nexport interface ConfigurableExtensionDataRef<\n  TData,\n  TId extends string,\n  TConfig extends { optional?: true } = {},\n> extends ExtensionDataRef<TData, TId, TConfig> {\n  optional(): ConfigurableExtensionDataRef<\n    TData,\n    TId,\n    TData & { optional: true }\n  >;\n  (t: TData): ExtensionDataValue<TData, TId>;\n}\n\n/**\n * @public\n * @deprecated Use the following form instead: `createExtensionDataRef<Type>().with({ id: 'core.foo' })`\n */\nexport function createExtensionDataRef<TData>(\n  id: string,\n): ConfigurableExtensionDataRef<TData, string>;\n/** @public */\nexport function createExtensionDataRef<TData>(): {\n  with<TId extends string>(options: {\n    id: TId;\n  }): ConfigurableExtensionDataRef<TData, TId>;\n};\nexport function createExtensionDataRef<TData>(id?: string):\n  | ConfigurableExtensionDataRef<TData, string>\n  | {\n      with<TId extends string>(options: {\n        id: TId;\n      }): ConfigurableExtensionDataRef<TData, TId>;\n    } {\n  const createRef = <TId extends string>(refId: TId) =>\n    Object.assign(\n      (value: TData): ExtensionDataValue<TData, TId> => ({\n        $$type: '@backstage/ExtensionDataValue',\n        id: refId,\n        value,\n      }),\n      {\n        id: refId,\n        $$type: '@backstage/ExtensionDataRef',\n        config: {},\n        optional() {\n          return {\n            ...this,\n            config: { ...this.config, optional: true },\n          };\n        },\n        toString() {\n          const optional = Boolean(this.config.optional);\n          return `ExtensionDataRef{id=${refId},optional=${optional}}`;\n        },\n      } as ConfigurableExtensionDataRef<TData, TId, { optional?: true }>,\n    );\n  if (id) {\n    return createRef(id);\n  }\n  return {\n    with<TId extends string>(options: { id: TId }) {\n      return createRef(options.id);\n    },\n  };\n}\n"],"names":[],"mappings":"AA2EO,SAAS,uBAA8B,EAMxC,EAAA;AACJ,EAAM,MAAA,SAAA,GAAY,CAAqB,KAAA,KACrC,MAAO,CAAA,MAAA;AAAA,IACL,CAAC,KAAkD,MAAA;AAAA,MACjD,MAAQ,EAAA,+BAAA;AAAA,MACR,EAAI,EAAA,KAAA;AAAA,MACJ,KAAA;AAAA,KACF,CAAA;AAAA,IACA;AAAA,MACE,EAAI,EAAA,KAAA;AAAA,MACJ,MAAQ,EAAA,6BAAA;AAAA,MACR,QAAQ,EAAC;AAAA,MACT,QAAW,GAAA;AACT,QAAO,OAAA;AAAA,UACL,GAAG,IAAA;AAAA,UACH,QAAQ,EAAE,GAAG,IAAK,CAAA,MAAA,EAAQ,UAAU,IAAK,EAAA;AAAA,SAC3C,CAAA;AAAA,OACF;AAAA,MACA,QAAW,GAAA;AACT,QAAA,MAAM,QAAW,GAAA,OAAA,CAAQ,IAAK,CAAA,MAAA,CAAO,QAAQ,CAAA,CAAA;AAC7C,QAAO,OAAA,CAAA,oBAAA,EAAuB,KAAK,CAAA,UAAA,EAAa,QAAQ,CAAA,CAAA,CAAA,CAAA;AAAA,OAC1D;AAAA,KACF;AAAA,GACF,CAAA;AACF,EAAA,IAAI,EAAI,EAAA;AACN,IAAA,OAAO,UAAU,EAAE,CAAA,CAAA;AAAA,GACrB;AACA,EAAO,OAAA;AAAA,IACL,KAAyB,OAAsB,EAAA;AAC7C,MAAO,OAAA,SAAA,CAAU,QAAQ,EAAE,CAAA,CAAA;AAAA,KAC7B;AAAA,GACF,CAAA;AACF;;;;"}
+{"version":3,"file":"createExtensionDataRef.esm.js","sources":["../../src/wiring/createExtensionDataRef.ts"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/** @public */\nexport type ExtensionDataValue<TData, TId extends string> = {\n  readonly $$type: '@backstage/ExtensionDataValue';\n  readonly id: TId;\n  readonly value: TData;\n};\n\n/** @public */\nexport type ExtensionDataRef<\n  TData,\n  TId extends string = string,\n  TConfig extends { optional?: true } = {},\n> = {\n  readonly $$type: '@backstage/ExtensionDataRef';\n  readonly id: TId;\n  readonly T: TData;\n  readonly config: TConfig;\n};\n\n/** @public */\nexport type ExtensionDataRefToValue<TDataRef extends AnyExtensionDataRef> =\n  TDataRef extends ExtensionDataRef<infer IData, infer IId, any>\n    ? ExtensionDataValue<IData, IId>\n    : never;\n\n/** @public */\nexport type AnyExtensionDataRef = ExtensionDataRef<\n  unknown,\n  string,\n  { optional?: true }\n>;\n\n/** @public */\nexport interface ConfigurableExtensionDataRef<\n  TData,\n  TId extends string,\n  TConfig extends { optional?: true } = {},\n> extends ExtensionDataRef<TData, TId, TConfig> {\n  optional(): ConfigurableExtensionDataRef<\n    TData,\n    TId,\n    TConfig & { optional: true }\n  >;\n  (t: TData): ExtensionDataValue<TData, TId>;\n}\n\n/**\n * @public\n * @deprecated Use the following form instead: `createExtensionDataRef<Type>().with({ id: 'core.foo' })`\n */\nexport function createExtensionDataRef<TData>(\n  id: string,\n): ConfigurableExtensionDataRef<TData, string>;\n/** @public */\nexport function createExtensionDataRef<TData>(): {\n  with<TId extends string>(options: {\n    id: TId;\n  }): ConfigurableExtensionDataRef<TData, TId>;\n};\nexport function createExtensionDataRef<TData>(id?: string):\n  | ConfigurableExtensionDataRef<TData, string>\n  | {\n      with<TId extends string>(options: {\n        id: TId;\n      }): ConfigurableExtensionDataRef<TData, TId>;\n    } {\n  const createRef = <TId extends string>(refId: TId) =>\n    Object.assign(\n      (value: TData): ExtensionDataValue<TData, TId> => ({\n        $$type: '@backstage/ExtensionDataValue',\n        id: refId,\n        value,\n      }),\n      {\n        id: refId,\n        $$type: '@backstage/ExtensionDataRef',\n        config: {},\n        optional() {\n          return {\n            ...this,\n            config: { ...this.config, optional: true },\n          };\n        },\n        toString() {\n          const optional = Boolean(this.config.optional);\n          return `ExtensionDataRef{id=${refId},optional=${optional}}`;\n        },\n      } as ConfigurableExtensionDataRef<TData, TId, { optional?: true }>,\n    );\n  if (id) {\n    return createRef(id);\n  }\n  return {\n    with<TId extends string>(options: { id: TId }) {\n      return createRef(options.id);\n    },\n  };\n}\n"],"names":[],"mappings":"AA2EO,SAAS,uBAA8B,EAMxC,EAAA;AACJ,EAAM,MAAA,SAAA,GAAY,CAAqB,KAAA,KACrC,MAAO,CAAA,MAAA;AAAA,IACL,CAAC,KAAkD,MAAA;AAAA,MACjD,MAAQ,EAAA,+BAAA;AAAA,MACR,EAAI,EAAA,KAAA;AAAA,MACJ,KAAA;AAAA,KACF,CAAA;AAAA,IACA;AAAA,MACE,EAAI,EAAA,KAAA;AAAA,MACJ,MAAQ,EAAA,6BAAA;AAAA,MACR,QAAQ,EAAC;AAAA,MACT,QAAW,GAAA;AACT,QAAO,OAAA;AAAA,UACL,GAAG,IAAA;AAAA,UACH,QAAQ,EAAE,GAAG,IAAK,CAAA,MAAA,EAAQ,UAAU,IAAK,EAAA;AAAA,SAC3C,CAAA;AAAA,OACF;AAAA,MACA,QAAW,GAAA;AACT,QAAA,MAAM,QAAW,GAAA,OAAA,CAAQ,IAAK,CAAA,MAAA,CAAO,QAAQ,CAAA,CAAA;AAC7C,QAAO,OAAA,CAAA,oBAAA,EAAuB,KAAK,CAAA,UAAA,EAAa,QAAQ,CAAA,CAAA,CAAA,CAAA;AAAA,OAC1D;AAAA,KACF;AAAA,GACF,CAAA;AACF,EAAA,IAAI,EAAI,EAAA;AACN,IAAA,OAAO,UAAU,EAAE,CAAA,CAAA;AAAA,GACrB;AACA,EAAO,OAAA;AAAA,IACL,KAAyB,OAAsB,EAAA;AAC7C,MAAO,OAAA,SAAA,CAAU,QAAQ,EAAE,CAAA,CAAA;AAAA,KAC7B;AAAA,GACF,CAAA;AACF;;;;"}

package/dist/wiring/createFrontendPlugin.esm.js

@@ -0,0 +1,59 @@
+import { resolveExtensionDefinition } from './resolveExtensionDefinition.esm.js';
+
+function createFrontendPlugin(options) {
+  const extensions = new Array();
+  const extensionDefinitionsById = /* @__PURE__ */ new Map();
+  for (const def of options.extensions ?? []) {
+    const ext = resolveExtensionDefinition(def, { namespace: options.id });
+    extensions.push(ext);
+    extensionDefinitionsById.set(ext.id, { ...def, namespace: options.id });
+  }
+  if (extensions.length !== extensionDefinitionsById.size) {
+    const extensionIds = extensions.map((e) => e.id);
+    const duplicates = Array.from(
+      new Set(
+        extensionIds.filter((id, index) => extensionIds.indexOf(id) !== index)
+      )
+    );
+    throw new Error(
+      `Plugin '${options.id}' provided duplicate extensions: ${duplicates.join(
+        ", "
+      )}`
+    );
+  }
+  return {
+    $$type: "@backstage/BackstagePlugin",
+    version: "v1",
+    id: options.id,
+    routes: options.routes ?? {},
+    externalRoutes: options.externalRoutes ?? {},
+    featureFlags: options.featureFlags ?? [],
+    extensions,
+    getExtension(id) {
+      return extensionDefinitionsById.get(id);
+    },
+    toString() {
+      return `Plugin{id=${options.id}}`;
+    },
+    withOverrides(overrides) {
+      const overriddenExtensionIds = new Set(
+        overrides.extensions.map(
+          (e) => resolveExtensionDefinition(e, { namespace: options.id }).id
+        )
+      );
+      const nonOverriddenExtensions = (options.extensions ?? []).filter(
+        (e) => !overriddenExtensionIds.has(
+          resolveExtensionDefinition(e, { namespace: options.id }).id
+        )
+      );
+      return createFrontendPlugin({
+        ...options,
+        extensions: [...nonOverriddenExtensions, ...overrides.extensions]
+      });
+    }
+  };
+}
+const createPlugin = createFrontendPlugin;
+
+export { createFrontendPlugin, createPlugin };
+//# sourceMappingURL=createFrontendPlugin.esm.js.map

package/dist/wiring/createFrontendPlugin.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFrontendPlugin.esm.js","sources":["../../src/wiring/createFrontendPlugin.ts"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ExtensionDefinition } from './createExtension';\nimport {\n  Extension,\n  ResolveExtensionId,\n  resolveExtensionDefinition,\n} from './resolveExtensionDefinition';\nimport {\n  AnyExternalRoutes,\n  AnyRoutes,\n  BackstagePlugin,\n  FeatureFlagConfig,\n} from './types';\n\n/** @public */\nexport interface PluginOptions<\n  TId extends string,\n  TRoutes extends AnyRoutes,\n  TExternalRoutes extends AnyExternalRoutes,\n  TExtensions extends readonly ExtensionDefinition<any, any>[],\n> {\n  id: TId;\n  routes?: TRoutes;\n  externalRoutes?: TExternalRoutes;\n  extensions?: TExtensions;\n  featureFlags?: FeatureFlagConfig[];\n}\n\n/** @public */\nexport interface InternalBackstagePlugin<\n  TRoutes extends AnyRoutes = AnyRoutes,\n  TExternalRoutes extends AnyExternalRoutes = AnyExternalRoutes,\n> extends BackstagePlugin<TRoutes, TExternalRoutes> {\n  readonly version: 'v1';\n  readonly extensions: Extension<unknown>[];\n  readonly featureFlags: FeatureFlagConfig[];\n}\n\n/** @public */\nexport function createFrontendPlugin<\n  TId extends string,\n  TRoutes extends AnyRoutes = {},\n  TExternalRoutes extends AnyExternalRoutes = {},\n  TExtensions extends readonly ExtensionDefinition<any, any>[] = [],\n>(\n  options: PluginOptions<TId, TRoutes, TExternalRoutes, TExtensions>,\n): BackstagePlugin<\n  TRoutes,\n  TExternalRoutes,\n  {\n    [KExtension in TExtensions[number] as ResolveExtensionId<\n      KExtension,\n      TId\n    >]: KExtension;\n  }\n> {\n  const extensions = new Array<Extension<unknown>>();\n  const extensionDefinitionsById = new Map<\n    string,\n    ExtensionDefinition<unknown>\n  >();\n\n  for (const def of options.extensions ?? []) {\n    const ext = resolveExtensionDefinition(def, { namespace: options.id });\n    extensions.push(ext);\n    extensionDefinitionsById.set(ext.id, { ...def, namespace: options.id });\n  }\n\n  if (extensions.length !== extensionDefinitionsById.size) {\n    const extensionIds = extensions.map(e => e.id);\n    const duplicates = Array.from(\n      new Set(\n        extensionIds.filter((id, index) => extensionIds.indexOf(id) !== index),\n      ),\n    );\n    // TODO(Rugvip): This could provide some more information about the kind + name of the extensions\n    throw new Error(\n      `Plugin '${options.id}' provided duplicate extensions: ${duplicates.join(\n        ', ',\n      )}`,\n    );\n  }\n\n  return {\n    $$type: '@backstage/BackstagePlugin',\n    version: 'v1',\n    id: options.id,\n    routes: options.routes ?? ({} as TRoutes),\n    externalRoutes: options.externalRoutes ?? ({} as TExternalRoutes),\n    featureFlags: options.featureFlags ?? [],\n    extensions,\n    getExtension(id) {\n      return extensionDefinitionsById.get(id);\n    },\n    toString() {\n      return `Plugin{id=${options.id}}`;\n    },\n    withOverrides(overrides) {\n      const overriddenExtensionIds = new Set(\n        overrides.extensions.map(\n          e => resolveExtensionDefinition(e, { namespace: options.id }).id,\n        ),\n      );\n      const nonOverriddenExtensions = (options.extensions ?? []).filter(\n        e =>\n          !overriddenExtensionIds.has(\n            resolveExtensionDefinition(e, { namespace: options.id }).id,\n          ),\n      );\n      return createFrontendPlugin({\n        ...options,\n        extensions: [...nonOverriddenExtensions, ...overrides.extensions],\n      });\n    },\n  } as InternalBackstagePlugin<TRoutes, TExternalRoutes>;\n}\n\n/** @internal */\nexport function toInternalBackstagePlugin(\n  plugin: BackstagePlugin,\n): InternalBackstagePlugin {\n  const internal = plugin as InternalBackstagePlugin;\n  if (internal.$$type !== '@backstage/BackstagePlugin') {\n    throw new Error(`Invalid plugin instance, bad type '${internal.$$type}'`);\n  }\n  if (internal.version !== 'v1') {\n    throw new Error(\n      `Invalid plugin instance, bad version '${internal.version}'`,\n    );\n  }\n  return internal;\n}\n\n/**\n * @public\n * @deprecated Use {@link createFrontendPlugin} instead.\n */\nexport const createPlugin = createFrontendPlugin;\n"],"names":[],"mappings":";;AAsDO,SAAS,qBAMd,OAUA,EAAA;AACA,EAAM,MAAA,UAAA,GAAa,IAAI,KAA0B,EAAA,CAAA;AACjD,EAAM,MAAA,wBAAA,uBAA+B,GAGnC,EAAA,CAAA;AAEF,EAAA,KAAA,MAAW,GAAO,IAAA,OAAA,CAAQ,UAAc,IAAA,EAAI,EAAA;AAC1C,IAAA,MAAM,MAAM,0BAA2B,CAAA,GAAA,EAAK,EAAE,SAAW,EAAA,OAAA,CAAQ,IAAI,CAAA,CAAA;AACrE,IAAA,UAAA,CAAW,KAAK,GAAG,CAAA,CAAA;AACnB,IAAyB,wBAAA,CAAA,GAAA,CAAI,IAAI,EAAI,EAAA,EAAE,GAAG,GAAK,EAAA,SAAA,EAAW,OAAQ,CAAA,EAAA,EAAI,CAAA,CAAA;AAAA,GACxE;AAEA,EAAI,IAAA,UAAA,CAAW,MAAW,KAAA,wBAAA,CAAyB,IAAM,EAAA;AACvD,IAAA,MAAM,YAAe,GAAA,UAAA,CAAW,GAAI,CAAA,CAAA,CAAA,KAAK,EAAE,EAAE,CAAA,CAAA;AAC7C,IAAA,MAAM,aAAa,KAAM,CAAA,IAAA;AAAA,MACvB,IAAI,GAAA;AAAA,QACF,YAAA,CAAa,OAAO,CAAC,EAAA,EAAI,UAAU,YAAa,CAAA,OAAA,CAAQ,EAAE,CAAA,KAAM,KAAK,CAAA;AAAA,OACvE;AAAA,KACF,CAAA;AAEA,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAW,QAAA,EAAA,OAAA,CAAQ,EAAE,CAAA,iCAAA,EAAoC,UAAW,CAAA,IAAA;AAAA,QAClE,IAAA;AAAA,OACD,CAAA,CAAA;AAAA,KACH,CAAA;AAAA,GACF;AAEA,EAAO,OAAA;AAAA,IACL,MAAQ,EAAA,4BAAA;AAAA,IACR,OAAS,EAAA,IAAA;AAAA,IACT,IAAI,OAAQ,CAAA,EAAA;AAAA,IACZ,MAAA,EAAQ,OAAQ,CAAA,MAAA,IAAW,EAAC;AAAA,IAC5B,cAAA,EAAgB,OAAQ,CAAA,cAAA,IAAmB,EAAC;AAAA,IAC5C,YAAA,EAAc,OAAQ,CAAA,YAAA,IAAgB,EAAC;AAAA,IACvC,UAAA;AAAA,IACA,aAAa,EAAI,EAAA;AACf,MAAO,OAAA,wBAAA,CAAyB,IAAI,EAAE,CAAA,CAAA;AAAA,KACxC;AAAA,IACA,QAAW,GAAA;AACT,MAAO,OAAA,CAAA,UAAA,EAAa,QAAQ,EAAE,CAAA,CAAA,CAAA,CAAA;AAAA,KAChC;AAAA,IACA,cAAc,SAAW,EAAA;AACvB,MAAA,MAAM,yBAAyB,IAAI,GAAA;AAAA,QACjC,UAAU,UAAW,CAAA,GAAA;AAAA,UACnB,CAAA,CAAA,KAAK,2BAA2B,CAAG,EAAA,EAAE,WAAW,OAAQ,CAAA,EAAA,EAAI,CAAE,CAAA,EAAA;AAAA,SAChE;AAAA,OACF,CAAA;AACA,MAAA,MAAM,uBAA2B,GAAA,CAAA,OAAA,CAAQ,UAAc,IAAA,EAAI,EAAA,MAAA;AAAA,QACzD,CAAA,CAAA,KACE,CAAC,sBAAuB,CAAA,GAAA;AAAA,UACtB,2BAA2B,CAAG,EAAA,EAAE,WAAW,OAAQ,CAAA,EAAA,EAAI,CAAE,CAAA,EAAA;AAAA,SAC3D;AAAA,OACJ,CAAA;AACA,MAAA,OAAO,oBAAqB,CAAA;AAAA,QAC1B,GAAG,OAAA;AAAA,QACH,YAAY,CAAC,GAAG,uBAAyB,EAAA,GAAG,UAAU,UAAU,CAAA;AAAA,OACjE,CAAA,CAAA;AAAA,KACH;AAAA,GACF,CAAA;AACF,CAAA;AAsBO,MAAM,YAAe,GAAA;;;;"}

package/dist/wiring/resolveExtensionDefinition.esm.js

@@ -2,7 +2,13 @@ import { toInternalExtensionDefinition } from './createExtension.esm.js';
 
 function resolveExtensionDefinition(definition, context) {
   const internalDefinition = toInternalExtensionDefinition(definition);
-  const { name, kind, namespace: _, ...rest } = internalDefinition;
+  const {
+    name,
+    kind,
+    namespace: _skip1,
+    override: _skip2,
+    ...rest
+  } = internalDefinition;
   const namespace = internalDefinition.namespace ?? context?.namespace;
   const namePart = name && namespace ? `${namespace}/${name}` : namespace || name;
   if (!namePart) {

package/dist/wiring/resolveExtensionDefinition.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveExtensionDefinition.esm.js","sources":["../../src/wiring/resolveExtensionDefinition.ts"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { AppNode } from '../apis';\nimport {\n  AnyExtensionDataMap,\n  AnyExtensionInputMap,\n  ExtensionDataValues,\n  ExtensionDefinition,\n  ResolvedExtensionInputs,\n  toInternalExtensionDefinition,\n} from './createExtension';\nimport { PortableSchema } from '../schema';\nimport { ExtensionInput } from './createExtensionInput';\nimport {\n  AnyExtensionDataRef,\n  ExtensionDataValue,\n} from './createExtensionDataRef';\n\n/** @public */\nexport interface Extension<TConfig, TConfigInput = TConfig> {\n  $$type: '@backstage/Extension';\n  readonly id: string;\n  readonly attachTo: { id: string; input: string };\n  readonly disabled: boolean;\n  readonly configSchema?: PortableSchema<TConfig, TConfigInput>;\n}\n\n/** @internal */\nexport type InternalExtension<TConfig, TConfigInput> = Extension<\n  TConfig,\n  TConfigInput\n> &\n  (\n    | {\n        readonly version: 'v1';\n        readonly inputs: AnyExtensionInputMap;\n        readonly output: AnyExtensionDataMap;\n        factory(options: {\n          node: AppNode;\n          config: TConfig;\n          inputs: ResolvedExtensionInputs<AnyExtensionInputMap>;\n        }): ExtensionDataValues<any>;\n      }\n    | {\n        readonly version: 'v2';\n        readonly inputs: {\n          [inputName in string]: ExtensionInput<\n            AnyExtensionDataRef,\n            { optional: boolean; singleton: boolean }\n          >;\n        };\n        readonly output: Array<AnyExtensionDataRef>;\n        factory(options: {\n          node: AppNode;\n          config: TConfig;\n          inputs: ResolvedExtensionInputs<{\n            [inputName in string]: ExtensionInput<\n              AnyExtensionDataRef,\n              { optional: boolean; singleton: boolean }\n            >;\n          }>;\n        }): Iterable<ExtensionDataValue<any, any>>;\n      }\n  );\n\n/** @internal */\nexport function toInternalExtension<TConfig, TConfigInput>(\n  overrides: Extension<TConfig, TConfigInput>,\n): InternalExtension<TConfig, TConfigInput> {\n  const internal = overrides as InternalExtension<TConfig, TConfigInput>;\n  if (internal.$$type !== '@backstage/Extension') {\n    throw new Error(\n      `Invalid extension instance, bad type '${internal.$$type}'`,\n    );\n  }\n  const version = internal.version;\n  if (version !== 'v1' && version !== 'v2') {\n    throw new Error(`Invalid extension instance, bad version '${version}'`);\n  }\n  return internal;\n}\n\n/** @internal */\nexport function resolveExtensionDefinition<TConfig, TConfigInput>(\n  definition: ExtensionDefinition<TConfig, TConfigInput>,\n  context?: { namespace?: string },\n): Extension<TConfig, TConfigInput> {\n  const internalDefinition = toInternalExtensionDefinition(definition);\n  const { name, kind, namespace: _, ...rest } = internalDefinition;\n  const namespace = internalDefinition.namespace ?? context?.namespace;\n\n  const namePart =\n    name && namespace ? `${namespace}/${name}` : namespace || name;\n  if (!namePart) {\n    throw new Error(\n      `Extension must declare an explicit namespace or name as it could not be resolved from context, kind=${kind} namespace=${namespace} name=${name}`,\n    );\n  }\n\n  const id = kind ? `${kind}:${namePart}` : namePart;\n\n  return {\n    ...rest,\n    $$type: '@backstage/Extension',\n    version: internalDefinition.version,\n    id,\n    toString() {\n      return `Extension{id=${id}}`;\n    },\n  } as InternalExtension<TConfig, TConfigInput>;\n}\n"],"names":[],"mappings":";;AAiGgB,SAAA,0BAAA,CACd,YACA,OACkC,EAAA;AAClC,EAAM,MAAA,kBAAA,GAAqB,8BAA8B,UAAU,CAAA,CAAA;AACnE,EAAA,MAAM,EAAE,IAAM,EAAA,IAAA,EAAM,WAAW,CAAG,EAAA,GAAG,MAAS,GAAA,kBAAA,CAAA;AAC9C,EAAM,MAAA,SAAA,GAAY,kBAAmB,CAAA,SAAA,IAAa,OAAS,EAAA,SAAA,CAAA;AAE3D,EAAM,MAAA,QAAA,GACJ,QAAQ,SAAY,GAAA,CAAA,EAAG,SAAS,CAAI,CAAA,EAAA,IAAI,KAAK,SAAa,IAAA,IAAA,CAAA;AAC5D,EAAA,IAAI,CAAC,QAAU,EAAA;AACb,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAuG,oGAAA,EAAA,IAAI,CAAc,WAAA,EAAA,SAAS,SAAS,IAAI,CAAA,CAAA;AAAA,KACjJ,CAAA;AAAA,GACF;AAEA,EAAA,MAAM,KAAK,IAAO,GAAA,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,QAAQ,CAAK,CAAA,GAAA,QAAA,CAAA;AAE1C,EAAO,OAAA;AAAA,IACL,GAAG,IAAA;AAAA,IACH,MAAQ,EAAA,sBAAA;AAAA,IACR,SAAS,kBAAmB,CAAA,OAAA;AAAA,IAC5B,EAAA;AAAA,IACA,QAAW,GAAA;AACT,MAAA,OAAO,gBAAgB,EAAE,CAAA,CAAA,CAAA,CAAA;AAAA,KAC3B;AAAA,GACF,CAAA;AACF;;;;"}
+{"version":3,"file":"resolveExtensionDefinition.esm.js","sources":["../../src/wiring/resolveExtensionDefinition.ts"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { AppNode } from '../apis';\nimport {\n  AnyExtensionDataMap,\n  AnyExtensionInputMap,\n  ExtensionDataValues,\n  ExtensionDefinition,\n  ResolvedExtensionInputs,\n  toInternalExtensionDefinition,\n} from './createExtension';\nimport { PortableSchema } from '../schema';\nimport { ExtensionInput } from './createExtensionInput';\nimport {\n  AnyExtensionDataRef,\n  ExtensionDataValue,\n} from './createExtensionDataRef';\n\n/** @public */\nexport interface Extension<TConfig, TConfigInput = TConfig> {\n  $$type: '@backstage/Extension';\n  readonly id: string;\n  readonly attachTo: { id: string; input: string };\n  readonly disabled: boolean;\n  readonly configSchema?: PortableSchema<TConfig, TConfigInput>;\n}\n\n/** @internal */\nexport type InternalExtension<TConfig, TConfigInput> = Extension<\n  TConfig,\n  TConfigInput\n> &\n  (\n    | {\n        readonly version: 'v1';\n        readonly inputs: AnyExtensionInputMap;\n        readonly output: AnyExtensionDataMap;\n        factory(options: {\n          node: AppNode;\n          config: TConfig;\n          inputs: ResolvedExtensionInputs<AnyExtensionInputMap>;\n        }): ExtensionDataValues<any>;\n      }\n    | {\n        readonly version: 'v2';\n        readonly inputs: {\n          [inputName in string]: ExtensionInput<\n            AnyExtensionDataRef,\n            { optional: boolean; singleton: boolean }\n          >;\n        };\n        readonly output: Array<AnyExtensionDataRef>;\n        factory(options: {\n          node: AppNode;\n          config: TConfig;\n          inputs: ResolvedExtensionInputs<{\n            [inputName in string]: ExtensionInput<\n              AnyExtensionDataRef,\n              { optional: boolean; singleton: boolean }\n            >;\n          }>;\n        }): Iterable<ExtensionDataValue<any, any>>;\n      }\n  );\n\n/** @internal */\nexport function toInternalExtension<TConfig, TConfigInput>(\n  overrides: Extension<TConfig, TConfigInput>,\n): InternalExtension<TConfig, TConfigInput> {\n  const internal = overrides as InternalExtension<TConfig, TConfigInput>;\n  if (internal.$$type !== '@backstage/Extension') {\n    throw new Error(\n      `Invalid extension instance, bad type '${internal.$$type}'`,\n    );\n  }\n  const version = internal.version;\n  if (version !== 'v1' && version !== 'v2') {\n    throw new Error(`Invalid extension instance, bad version '${version}'`);\n  }\n  return internal;\n}\n\n/** @ignore */\nexport type ResolveExtensionId<\n  TExtension extends ExtensionDefinition<any>,\n  TDefaultNamespace extends string | undefined,\n> = TExtension extends ExtensionDefinition<\n  any,\n  any,\n  any,\n  any,\n  {\n    kind: infer IKind extends string | undefined;\n    namespace: infer INamespace extends string | undefined;\n    name: infer IName extends string | undefined;\n  }\n>\n  ? [string | undefined] extends [IKind | INamespace | IName]\n    ? never\n    : (\n        (\n          undefined extends TDefaultNamespace ? INamespace : TDefaultNamespace\n        ) extends infer ISelectedNamespace extends string\n          ? undefined extends IName\n            ? ISelectedNamespace\n            : `${ISelectedNamespace}/${IName}`\n          : IName\n      ) extends infer INamePart extends string\n    ? IKind extends string\n      ? `${IKind}:${INamePart}`\n      : INamePart\n    : never\n  : never;\n\n/** @internal */\nexport function resolveExtensionDefinition<TConfig, TConfigInput>(\n  definition: ExtensionDefinition<TConfig, TConfigInput>,\n  context?: { namespace?: string },\n): Extension<TConfig, TConfigInput> {\n  const internalDefinition = toInternalExtensionDefinition(definition);\n  const {\n    name,\n    kind,\n    namespace: _skip1,\n    override: _skip2,\n    ...rest\n  } = internalDefinition;\n  const namespace = internalDefinition.namespace ?? context?.namespace;\n\n  const namePart =\n    name && namespace ? `${namespace}/${name}` : namespace || name;\n  if (!namePart) {\n    throw new Error(\n      `Extension must declare an explicit namespace or name as it could not be resolved from context, kind=${kind} namespace=${namespace} name=${name}`,\n    );\n  }\n\n  const id = kind ? `${kind}:${namePart}` : namePart;\n\n  return {\n    ...rest,\n    $$type: '@backstage/Extension',\n    version: internalDefinition.version,\n    id,\n    toString() {\n      return `Extension{id=${id}}`;\n    },\n  } as InternalExtension<TConfig, TConfigInput>;\n}\n"],"names":[],"mappings":";;AAiIgB,SAAA,0BAAA,CACd,YACA,OACkC,EAAA;AAClC,EAAM,MAAA,kBAAA,GAAqB,8BAA8B,UAAU,CAAA,CAAA;AACnE,EAAM,MAAA;AAAA,IACJ,IAAA;AAAA,IACA,IAAA;AAAA,IACA,SAAW,EAAA,MAAA;AAAA,IACX,QAAU,EAAA,MAAA;AAAA,IACV,GAAG,IAAA;AAAA,GACD,GAAA,kBAAA,CAAA;AACJ,EAAM,MAAA,SAAA,GAAY,kBAAmB,CAAA,SAAA,IAAa,OAAS,EAAA,SAAA,CAAA;AAE3D,EAAM,MAAA,QAAA,GACJ,QAAQ,SAAY,GAAA,CAAA,EAAG,SAAS,CAAI,CAAA,EAAA,IAAI,KAAK,SAAa,IAAA,IAAA,CAAA;AAC5D,EAAA,IAAI,CAAC,QAAU,EAAA;AACb,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAuG,oGAAA,EAAA,IAAI,CAAc,WAAA,EAAA,SAAS,SAAS,IAAI,CAAA,CAAA;AAAA,KACjJ,CAAA;AAAA,GACF;AAEA,EAAA,MAAM,KAAK,IAAO,GAAA,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,QAAQ,CAAK,CAAA,GAAA,QAAA,CAAA;AAE1C,EAAO,OAAA;AAAA,IACL,GAAG,IAAA;AAAA,IACH,MAAQ,EAAA,sBAAA;AAAA,IACR,SAAS,kBAAmB,CAAA,OAAA;AAAA,IAC5B,EAAA;AAAA,IACA,QAAW,GAAA;AACT,MAAA,OAAO,gBAAgB,EAAE,CAAA,CAAA,CAAA,CAAA;AAAA,KAC3B;AAAA,GACF,CAAA;AACF;;;;"}