@credo-ts/core 0.6.1-pr-2091-20241119140918 → 0.6.1

package/build/modules/x509/extraction.mjs

@@ -0,0 +1,12 @@
+
+
+import { X509Certificate } from "./X509Certificate.mjs";
+
+//#region src/modules/x509/extraction.ts
+function extractX509CertificatesFromJwt(jwt) {
+	return jwt.header.x5c?.map((cert) => X509Certificate.fromEncodedCertificate(cert));
+}
+
+//#endregion
+export { extractX509CertificatesFromJwt };
+//# sourceMappingURL=extraction.mjs.map

package/build/modules/x509/extraction.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.mjs","names":[],"sources":["../../../src/modules/x509/extraction.ts"],"sourcesContent":["import type { Jwt } from '../../crypto'\n\nimport { X509Certificate } from './X509Certificate'\n\nexport function extractX509CertificatesFromJwt(jwt: Jwt) {\n  return jwt.header.x5c?.map((cert) => X509Certificate.fromEncodedCertificate(cert))\n}\n"],"mappings":";;;;;AAIA,SAAgB,+BAA+B,KAAU;AACvD,QAAO,IAAI,OAAO,KAAK,KAAK,SAAS,gBAAgB,uBAAuB,KAAK,CAAC"}

package/build/modules/x509/index.d.mts

@@ -0,0 +1,11 @@
+import { EncodedX509Certificate, X509CertificateExtensionsOptions, X509CertificateIssuerAndSubjectOptions, X509CreateCertificateChainOptions, X509CreateCertificateOptions, X509GetLeafCertificateOptions, X509ParseCertificateOptions, X509ValidateCertificateChainOptions } from "./X509ServiceOptions.mjs";
+import { X509Certificate, X509CertificateOptions, X509ExtendedKeyUsage, X509KeyUsage } from "./X509Certificate.mjs";
+import { extractX509CertificatesFromJwt } from "./extraction.mjs";
+import { createAuthorityKeyIdentifierExtension, createBasicConstraintsExtension, createCrlDistributionPointsExtension, createExtendedKeyUsagesExtension, createIssuerAlternativeNameExtension, createKeyUsagesExtension, createSubjectAlternativeNameExtension, createSubjectKeyIdentifierExtension } from "./utils/extensions.mjs";
+import { convertName } from "./utils/nameConversion.mjs";
+import "./utils/index.mjs";
+import { X509ModuleConfig, X509ModuleConfigOptions, X509VerificationContext, X509VerificationTypeCredential, X509VerificationTypeOauth2ClientAttestation, X509VerificationTypeOauth2SecuredAuthorizationRequest, X509VerificationTypeOpenId4VciCredentialIssuerMetadata, X509VerificationTypeOpenId4VciKeyAttestation } from "./X509ModuleConfig.mjs";
+import { X509Api } from "./X509Api.mjs";
+import { X509Error } from "./X509Error.mjs";
+import { X509Module } from "./X509Module.mjs";
+import { X509Service } from "./X509Service.mjs";

package/build/modules/x509/index.mjs

@@ -0,0 +1,13 @@
+
+
+import { createAuthorityKeyIdentifierExtension, createBasicConstraintsExtension, createCrlDistributionPointsExtension, createExtendedKeyUsagesExtension, createIssuerAlternativeNameExtension, createKeyUsagesExtension, createSubjectAlternativeNameExtension, createSubjectKeyIdentifierExtension } from "./utils/extensions.mjs";
+import { X509Error } from "./X509Error.mjs";
+import { convertName } from "./utils/nameConversion.mjs";
+import "./utils/index.mjs";
+import { X509Certificate, X509ExtendedKeyUsage, X509KeyUsage } from "./X509Certificate.mjs";
+import { extractX509CertificatesFromJwt } from "./extraction.mjs";
+import { X509ModuleConfig } from "./X509ModuleConfig.mjs";
+import { X509Service } from "./X509Service.mjs";
+import { X509Api } from "./X509Api.mjs";
+import { X509Module } from "./X509Module.mjs";
+import "./X509ServiceOptions.mjs";

package/build/modules/x509/utils/extensions.d.mts

@@ -0,0 +1,21 @@
+import { X509CertificateExtensionsOptions } from "../X509ServiceOptions.mjs";
+import { PublicJwk } from "../../kms/jwk/PublicJwk.mjs";
+import "../../kms/index.mjs";
+import { AuthorityKeyIdentifierExtension, BasicConstraintsExtension, CRLDistributionPointsExtension, ExtendedKeyUsageExtension, IssuerAlternativeNameExtension, KeyUsagesExtension, SubjectAlternativeNameExtension, SubjectKeyIdentifierExtension } from "@peculiar/x509";
+
+//#region src/modules/x509/utils/extensions.d.ts
+declare const createSubjectKeyIdentifierExtension: (options: X509CertificateExtensionsOptions["subjectKeyIdentifier"], additionalOptions: {
+  publicJwk: PublicJwk;
+}) => SubjectKeyIdentifierExtension | undefined;
+declare const createKeyUsagesExtension: (options: X509CertificateExtensionsOptions["keyUsage"]) => KeyUsagesExtension | undefined;
+declare const createExtendedKeyUsagesExtension: (options: X509CertificateExtensionsOptions["extendedKeyUsage"]) => ExtendedKeyUsageExtension | undefined;
+declare const createAuthorityKeyIdentifierExtension: (options: X509CertificateExtensionsOptions["authorityKeyIdentifier"], additionalOptions: {
+  publicJwk: PublicJwk;
+}) => AuthorityKeyIdentifierExtension | undefined;
+declare const createIssuerAlternativeNameExtension: (options: X509CertificateExtensionsOptions["issuerAlternativeName"]) => IssuerAlternativeNameExtension | undefined;
+declare const createSubjectAlternativeNameExtension: (options: X509CertificateExtensionsOptions["subjectAlternativeName"]) => SubjectAlternativeNameExtension | undefined;
+declare const createBasicConstraintsExtension: (options: X509CertificateExtensionsOptions["basicConstraints"]) => BasicConstraintsExtension | undefined;
+declare const createCrlDistributionPointsExtension: (options: X509CertificateExtensionsOptions["crlDistributionPoints"]) => CRLDistributionPointsExtension | undefined;
+//#endregion
+export { createAuthorityKeyIdentifierExtension, createBasicConstraintsExtension, createCrlDistributionPointsExtension, createExtendedKeyUsagesExtension, createIssuerAlternativeNameExtension, createKeyUsagesExtension, createSubjectAlternativeNameExtension, createSubjectKeyIdentifierExtension };
+//# sourceMappingURL=extensions.d.mts.map

package/build/modules/x509/utils/extensions.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.mts","names":[],"sources":["../../../../src/modules/x509/utils/extensions.ts"],"sourcesContent":[],"mappings":";;;;;;cAgBa,+CACF;aACuB;MAAW;cAUhC,oCAAqC,iDAA4C;cAQjF,4CAA6C,yDAAoD;AApBjG,cA0BA,qCAhBZ,EAAA,CAAA,OAAA,EAiBU,gCAjBV,CAAA,wBAAA,CAAA,EAAA,iBAAA,EAAA;EATU,SAAA,EA2BuB,SA3BvB;CACuB,EAAA,GA0BW,+BA1BX,GAAA,SAAA;AAAW,cAoChC,oCApCgC,EAAA,CAAA,OAAA,EAqClC,gCArCkC,CAAA,uBAAA,CAAA,EAAA,GAqCuB,8BArCvB,GAAA,SAAA;AAAA,cA4ChC,qCA5CgC,EAAA,CAAA,OAAA,EA6ClC,gCA7CkC,CAAA,wBAAA,CAAA,EAAA,GA6CwB,+BA7CxB,GAAA,SAAA;AAUhC,cA0CA,+BA1CqC,EAAA,CAAA,OAAA,EA0CO,gCA1CqC,CAAA,kBAAA,CAAA,EAAA,GA0Ce,yBA1Cf,GAAA,SAAA;AAQjF,cAwCA,oCAxC6C,EAAA,CAAA,OAAA,EAyC/C,gCAzCmG,CAAA,uBAAA,CAAA,EAAA,GAyC1C,8BAzC0C,GAAA,SAAA"}

package/build/modules/x509/utils/extensions.mjs

@@ -0,0 +1,51 @@
+
+
+import { TypedArrayEncoder } from "../../../utils/TypedArrayEncoder.mjs";
+import { Hasher } from "../../../crypto/hashes/Hasher.mjs";
+import "../../../utils/index.mjs";
+import "../../kms/index.mjs";
+import { publicJwkToSpki } from "../../../crypto/webcrypto/utils/keyAlgorithmConversion.mjs";
+import "../../../crypto/webcrypto/utils/index.mjs";
+import { AuthorityKeyIdentifierExtension, BasicConstraintsExtension, CRLDistributionPointsExtension, ExtendedKeyUsageExtension, IssuerAlternativeNameExtension, KeyUsagesExtension, SubjectAlternativeNameExtension, SubjectKeyIdentifierExtension } from "@peculiar/x509";
+
+//#region src/modules/x509/utils/extensions.ts
+const createSubjectKeyIdentifierExtension = (options, additionalOptions) => {
+	if (!options || !options.include) return;
+	const spki = publicJwkToSpki(additionalOptions.publicJwk);
+	const hash = Hasher.hash(new Uint8Array(spki.subjectPublicKey), "SHA-1");
+	return new SubjectKeyIdentifierExtension(TypedArrayEncoder.toHex(hash));
+};
+const createKeyUsagesExtension = (options) => {
+	if (!options) return;
+	return new KeyUsagesExtension(options.usages.reduce((prev, curr) => prev | curr, 0), options.markAsCritical);
+};
+const createExtendedKeyUsagesExtension = (options) => {
+	if (!options) return;
+	return new ExtendedKeyUsageExtension(options.usages, options.markAsCritical);
+};
+const createAuthorityKeyIdentifierExtension = (options, additionalOptions) => {
+	if (!options) return;
+	const spki = publicJwkToSpki(additionalOptions.publicJwk);
+	const hash = Hasher.hash(new Uint8Array(spki.subjectPublicKey), "SHA-1");
+	return new AuthorityKeyIdentifierExtension(TypedArrayEncoder.toHex(hash), options.markAsCritical);
+};
+const createIssuerAlternativeNameExtension = (options) => {
+	if (!options) return;
+	return new IssuerAlternativeNameExtension(options.name, options.markAsCritical);
+};
+const createSubjectAlternativeNameExtension = (options) => {
+	if (!options) return;
+	return new SubjectAlternativeNameExtension(options.name, options.markAsCritical);
+};
+const createBasicConstraintsExtension = (options) => {
+	if (!options) return;
+	return new BasicConstraintsExtension(options.ca, options.pathLenConstraint, options.markAsCritical);
+};
+const createCrlDistributionPointsExtension = (options) => {
+	if (!options) return;
+	return new CRLDistributionPointsExtension(options.urls, options.markAsCritical);
+};
+
+//#endregion
+export { createAuthorityKeyIdentifierExtension, createBasicConstraintsExtension, createCrlDistributionPointsExtension, createExtendedKeyUsagesExtension, createIssuerAlternativeNameExtension, createKeyUsagesExtension, createSubjectAlternativeNameExtension, createSubjectKeyIdentifierExtension };
+//# sourceMappingURL=extensions.mjs.map

package/build/modules/x509/utils/extensions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.mjs","names":[],"sources":["../../../../src/modules/x509/utils/extensions.ts"],"sourcesContent":["import {\n  AuthorityKeyIdentifierExtension,\n  BasicConstraintsExtension,\n  CRLDistributionPointsExtension,\n  ExtendedKeyUsageExtension,\n  IssuerAlternativeNameExtension,\n  KeyUsagesExtension,\n  SubjectAlternativeNameExtension,\n  SubjectKeyIdentifierExtension,\n} from '@peculiar/x509'\nimport { Hasher } from '../../../crypto/hashes/Hasher'\nimport { publicJwkToSpki } from '../../../crypto/webcrypto/utils'\nimport { TypedArrayEncoder } from '../../../utils'\nimport { PublicJwk } from '../../kms'\nimport type { X509CertificateExtensionsOptions } from '../X509ServiceOptions'\n\nexport const createSubjectKeyIdentifierExtension = (\n  options: X509CertificateExtensionsOptions['subjectKeyIdentifier'],\n  additionalOptions: { publicJwk: PublicJwk }\n) => {\n  if (!options || !options.include) return\n\n  const spki = publicJwkToSpki(additionalOptions.publicJwk)\n  const hash = Hasher.hash(new Uint8Array(spki.subjectPublicKey), 'SHA-1')\n\n  return new SubjectKeyIdentifierExtension(TypedArrayEncoder.toHex(hash))\n}\n\nexport const createKeyUsagesExtension = (options: X509CertificateExtensionsOptions['keyUsage']) => {\n  if (!options) return\n\n  const flags = options.usages.reduce((prev, curr) => prev | curr, 0)\n\n  return new KeyUsagesExtension(flags, options.markAsCritical)\n}\n\nexport const createExtendedKeyUsagesExtension = (options: X509CertificateExtensionsOptions['extendedKeyUsage']) => {\n  if (!options) return\n\n  return new ExtendedKeyUsageExtension(options.usages, options.markAsCritical)\n}\n\nexport const createAuthorityKeyIdentifierExtension = (\n  options: X509CertificateExtensionsOptions['authorityKeyIdentifier'],\n  additionalOptions: { publicJwk: PublicJwk }\n) => {\n  if (!options) return\n\n  const spki = publicJwkToSpki(additionalOptions.publicJwk)\n  const hash = Hasher.hash(new Uint8Array(spki.subjectPublicKey), 'SHA-1')\n\n  return new AuthorityKeyIdentifierExtension(TypedArrayEncoder.toHex(hash), options.markAsCritical)\n}\n\nexport const createIssuerAlternativeNameExtension = (\n  options: X509CertificateExtensionsOptions['issuerAlternativeName']\n) => {\n  if (!options) return\n\n  return new IssuerAlternativeNameExtension(options.name, options.markAsCritical)\n}\n\nexport const createSubjectAlternativeNameExtension = (\n  options: X509CertificateExtensionsOptions['subjectAlternativeName']\n) => {\n  if (!options) return\n\n  return new SubjectAlternativeNameExtension(options.name, options.markAsCritical)\n}\n\nexport const createBasicConstraintsExtension = (options: X509CertificateExtensionsOptions['basicConstraints']) => {\n  if (!options) return\n\n  return new BasicConstraintsExtension(options.ca, options.pathLenConstraint, options.markAsCritical)\n}\n\nexport const createCrlDistributionPointsExtension = (\n  options: X509CertificateExtensionsOptions['crlDistributionPoints']\n) => {\n  if (!options) return\n\n  return new CRLDistributionPointsExtension(options.urls, options.markAsCritical)\n}\n"],"mappings":";;;;;;;;;;;AAgBA,MAAa,uCACX,SACA,sBACG;AACH,KAAI,CAAC,WAAW,CAAC,QAAQ,QAAS;CAElC,MAAM,OAAO,gBAAgB,kBAAkB,UAAU;CACzD,MAAM,OAAO,OAAO,KAAK,IAAI,WAAW,KAAK,iBAAiB,EAAE,QAAQ;AAExE,QAAO,IAAI,8BAA8B,kBAAkB,MAAM,KAAK,CAAC;;AAGzE,MAAa,4BAA4B,YAA0D;AACjG,KAAI,CAAC,QAAS;AAId,QAAO,IAAI,mBAFG,QAAQ,OAAO,QAAQ,MAAM,SAAS,OAAO,MAAM,EAAE,EAE9B,QAAQ,eAAe;;AAG9D,MAAa,oCAAoC,YAAkE;AACjH,KAAI,CAAC,QAAS;AAEd,QAAO,IAAI,0BAA0B,QAAQ,QAAQ,QAAQ,eAAe;;AAG9E,MAAa,yCACX,SACA,sBACG;AACH,KAAI,CAAC,QAAS;CAEd,MAAM,OAAO,gBAAgB,kBAAkB,UAAU;CACzD,MAAM,OAAO,OAAO,KAAK,IAAI,WAAW,KAAK,iBAAiB,EAAE,QAAQ;AAExE,QAAO,IAAI,gCAAgC,kBAAkB,MAAM,KAAK,EAAE,QAAQ,eAAe;;AAGnG,MAAa,wCACX,YACG;AACH,KAAI,CAAC,QAAS;AAEd,QAAO,IAAI,+BAA+B,QAAQ,MAAM,QAAQ,eAAe;;AAGjF,MAAa,yCACX,YACG;AACH,KAAI,CAAC,QAAS;AAEd,QAAO,IAAI,gCAAgC,QAAQ,MAAM,QAAQ,eAAe;;AAGlF,MAAa,mCAAmC,YAAkE;AAChH,KAAI,CAAC,QAAS;AAEd,QAAO,IAAI,0BAA0B,QAAQ,IAAI,QAAQ,mBAAmB,QAAQ,eAAe;;AAGrG,MAAa,wCACX,YACG;AACH,KAAI,CAAC,QAAS;AAEd,QAAO,IAAI,+BAA+B,QAAQ,MAAM,QAAQ,eAAe"}

package/build/modules/x509/utils/index.d.mts

@@ -0,0 +1,2 @@
+import { createAuthorityKeyIdentifierExtension, createBasicConstraintsExtension, createCrlDistributionPointsExtension, createExtendedKeyUsagesExtension, createIssuerAlternativeNameExtension, createKeyUsagesExtension, createSubjectAlternativeNameExtension, createSubjectKeyIdentifierExtension } from "./extensions.mjs";
+import { convertName } from "./nameConversion.mjs";

package/build/modules/x509/utils/index.mjs

@@ -0,0 +1,4 @@
+
+
+import { createAuthorityKeyIdentifierExtension, createBasicConstraintsExtension, createCrlDistributionPointsExtension, createExtendedKeyUsagesExtension, createIssuerAlternativeNameExtension, createKeyUsagesExtension, createSubjectAlternativeNameExtension, createSubjectKeyIdentifierExtension } from "./extensions.mjs";
+import { convertName } from "./nameConversion.mjs";

package/build/modules/x509/utils/nameConversion.d.mts

@@ -0,0 +1,7 @@
+import { X509CertificateIssuerAndSubjectOptions } from "../X509ServiceOptions.mjs";
+
+//#region src/modules/x509/utils/nameConversion.d.ts
+declare const convertName: (name: string | X509CertificateIssuerAndSubjectOptions) => string;
+//#endregion
+export { convertName };
+//# sourceMappingURL=nameConversion.d.mts.map

package/build/modules/x509/utils/nameConversion.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nameConversion.d.mts","names":[],"sources":["../../../../src/modules/x509/utils/nameConversion.ts"],"sourcesContent":[],"mappings":";;;cAGa,6BAA8B"}

package/build/modules/x509/utils/nameConversion.mjs

@@ -0,0 +1,19 @@
+
+
+import { X509Error } from "../X509Error.mjs";
+
+//#region src/modules/x509/utils/nameConversion.ts
+const convertName = (name) => {
+	if (typeof name === "string") return name;
+	let nameBuilder = "";
+	if (name.commonName) nameBuilder = nameBuilder.concat(`CN=${name.commonName}, `);
+	if (name.countryName) nameBuilder = nameBuilder.concat(`C=${name.countryName}, `);
+	if (name.organizationalUnit) nameBuilder = nameBuilder.concat(`OU=${name.organizationalUnit}, `);
+	if (name.stateOrProvinceName) nameBuilder = nameBuilder.concat(`S=${name.stateOrProvinceName}, `);
+	if (nameBuilder.length === 0) throw new X509Error("Provided name object has no entries. Could not generate an issuer/subject name");
+	return nameBuilder.slice(0, nameBuilder.length - 2);
+};
+
+//#endregion
+export { convertName };
+//# sourceMappingURL=nameConversion.mjs.map

package/build/modules/x509/utils/nameConversion.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nameConversion.mjs","names":[],"sources":["../../../../src/modules/x509/utils/nameConversion.ts"],"sourcesContent":["import { X509Error } from '../X509Error'\nimport type { X509CertificateIssuerAndSubjectOptions } from '../X509ServiceOptions'\n\nexport const convertName = (name: string | X509CertificateIssuerAndSubjectOptions) => {\n  if (typeof name === 'string') return name\n\n  let nameBuilder = ''\n\n  if (name.commonName) nameBuilder = nameBuilder.concat(`CN=${name.commonName}, `)\n  if (name.countryName) nameBuilder = nameBuilder.concat(`C=${name.countryName}, `)\n  if (name.organizationalUnit) nameBuilder = nameBuilder.concat(`OU=${name.organizationalUnit}, `)\n  if (name.stateOrProvinceName) nameBuilder = nameBuilder.concat(`S=${name.stateOrProvinceName}, `)\n\n  if (nameBuilder.length === 0) {\n    throw new X509Error('Provided name object has no entries. Could not generate an issuer/subject name')\n  }\n\n  // Remove the trailing `, `\n  return nameBuilder.slice(0, nameBuilder.length - 2)\n}\n"],"mappings":";;;;;AAGA,MAAa,eAAe,SAA0D;AACpF,KAAI,OAAO,SAAS,SAAU,QAAO;CAErC,IAAI,cAAc;AAElB,KAAI,KAAK,WAAY,eAAc,YAAY,OAAO,MAAM,KAAK,WAAW,IAAI;AAChF,KAAI,KAAK,YAAa,eAAc,YAAY,OAAO,KAAK,KAAK,YAAY,IAAI;AACjF,KAAI,KAAK,mBAAoB,eAAc,YAAY,OAAO,MAAM,KAAK,mBAAmB,IAAI;AAChG,KAAI,KAAK,oBAAqB,eAAc,YAAY,OAAO,KAAK,KAAK,oBAAoB,IAAI;AAEjG,KAAI,YAAY,WAAW,EACzB,OAAM,IAAI,UAAU,iFAAiF;AAIvG,QAAO,YAAY,MAAM,GAAG,YAAY,SAAS,EAAE"}

package/build/plugins/DependencyManager.d.mts

@@ -0,0 +1,57 @@
+import { Constructor } from "../utils/mixins.mjs";
+import { ModulesMap } from "../agent/AgentModules.mjs";
+import { AgentContext } from "../agent/context/AgentContext.mjs";
+import "../agent/index.mjs";
+import { DependencyContainer, InjectionToken } from "tsyringe";
+
+//#region src/plugins/DependencyManager.d.ts
+declare class DependencyManager {
+  readonly container: DependencyContainer;
+  readonly registeredModules: ModulesMap;
+  /**
+   * @internal
+   */
+  constructor(container?: DependencyContainer, registeredModules?: ModulesMap);
+  /**
+   * @internal
+   */
+  registerModules(modules: ModulesMap): void;
+  /**
+   * @internal
+   */
+  initializeModules(agentContext: AgentContext): Promise<void>;
+  /**
+   * @internal
+   */
+  shutdownModules(agentContext: AgentContext): Promise<void>;
+  /**
+   * @internal
+   */
+  initializeAgentContext(agentContext: AgentContext): Promise<void>;
+  /**
+   * @internal
+   */
+  deleteAgentContext(agentContext: AgentContext): Promise<void>;
+  /**
+   * @internal
+   */
+  provisionAgentContext(agentContext: AgentContext): Promise<AgentContext>;
+  /**
+   * @internal
+   */
+  closeAgentContext(agentContext: AgentContext): Promise<void>;
+  registerSingleton<T>(from: InjectionToken<T>, to: InjectionToken<T>): void;
+  registerSingleton<T>(token: Constructor<T>): void;
+  resolve<T>(token: InjectionToken<T>): T;
+  registerInstance<T>(token: InjectionToken<T>, instance: T): void;
+  isRegistered<T>(token: InjectionToken<T>, recursive?: boolean): boolean;
+  registerContextScoped<T = any>(token: Constructor<T>): void;
+  registerContextScoped<T = any>(token: InjectionToken<T>, provider: Constructor<T>): void;
+  /**
+   * @internal
+   */
+  createChild(): DependencyManager;
+}
+//#endregion
+export { DependencyManager, type InjectionToken };
+//# sourceMappingURL=DependencyManager.d.mts.map

package/build/plugins/DependencyManager.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyManager.d.mts","names":[],"sources":["../../src/plugins/DependencyManager.ts"],"sourcesContent":[],"mappings":";;;;;;;cASa,iBAAA;sBACgB;8BACQ;EAFxB;;;EAQE,WAAA,CAAA,SAAA,CAAA,EAAA,mBAAA,EAAA,iBAAA,CAAA,EACQ,UADR;EACQ;;;EAgCoC,eAAA,CAAA,OAAA,EAvBzB,UAuByB,CAAA,EAAA,IAAA;EAsBd;;;EAsBmB,iBAAA,CAAA,YAAA,EA5CjB,YA4CiB,CAAA,EA5CL,OA4CK,CAAA,IAAA,CAAA;EAsBhB;;;EA0Be,eAAA,CAAA,YAAA,EAtElB,YAsEkB,CAAA,EAtEN,OAsEM,CAAA,IAAA,CAAA;EAAA;;;EAkDZ,sBAAA,CAAA,YAAA,EAlGC,YAkGD,CAAA,EAlGa,OAkGb,CAAA,IAAA,CAAA;EAAf;;;EACa,kBAAA,CAAA,YAAA,EA7ED,YA6EC,CAAA,EA7EW,OA6EX,CAAA,IAAA,CAAA;EAAZ;;;EAMU,qBAAA,CAAA,YAAA,EAzDI,YAyDJ,CAAA,EAzDgB,OAyDhB,CAzDgB,YAyDhB,CAAA;EAII;;;EAIJ,iBAAA,CAAA,YAAA,EAzCA,YAyCA,CAAA,EAzCY,OAyCZ,CAAA,IAAA,CAAA;EAAf,iBAAA,CAAA,CAAA,CAAA,CAAA,IAAA,EAfI,cAeJ,CAfmB,CAenB,CAAA,EAAA,EAAA,EAf2B,cAe3B,CAf0C,CAe1C,CAAA,CAAA,EAAA,IAAA;EAK2B,iBAAA,CAAA,CAAA,CAAA,CAAA,KAAA,EAnBtB,WAmBsB,CAnBV,CAmBU,CAAA,CAAA,EAAA,IAAA;EAAZ,OAAA,CAAA,CAAA,CAAA,CAAA,KAAA,EAbpB,cAaoB,CAbL,CAaK,CAAA,CAAA,EAbA,CAaA;EAEe,gBAAA,CAAA,CAAA,CAAA,CAAA,KAAA,EAX1B,cAW0B,CAXX,CAWW,CAAA,EAAA,QAAA,EAXG,CAWH,CAAA,EAAA,IAAA;EAAf,YAAA,CAAA,CAAA,CAAA,CAAA,KAAA,EAPf,cAOe,CAPA,CAOA,CAAA,EAAA,SAAA,CAAA,EAAA,OAAA,CAAA,EAAA,OAAA;EAAyC,qBAAA,CAAA,IAAA,GAAA,CAAA,CAAA,KAAA,EAFzC,WAEyC,CAF7B,CAE6B,CAAA,CAAA,EAAA,IAAA;EAAZ,qBAAA,CAAA,IAAA,GAAA,CAAA,CAAA,KAAA,EAA7B,cAA6B,CAAd,CAAc,CAAA,EAAA,QAAA,EAAA,WAAA,CAAY,CAAZ,CAAA,CAAA,EAAA,IAAA;EAWxD;;;iBAAA"}

package/build/plugins/DependencyManager.mjs

@@ -0,0 +1,132 @@
+
+
+import { CredoError } from "../error/CredoError.mjs";
+import "../error/index.mjs";
+import { Lifecycle, container } from "tsyringe";
+
+//#region src/plugins/DependencyManager.ts
+var DependencyManager = class DependencyManager {
+	/**
+	* @internal
+	*/
+	constructor(container$1 = container.createChildContainer(), registeredModules = {}) {
+		this.container = container$1;
+		this.registeredModules = registeredModules;
+	}
+	/**
+	* @internal
+	*/
+	registerModules(modules) {
+		for (const [moduleKey, module] of Object.entries(modules)) {
+			if (this.registeredModules[moduleKey]) throw new CredoError(`Module with key ${moduleKey} has already been registered. Only a single module can be registered with the same key.`);
+			this.registeredModules[moduleKey] = module;
+			if (module.api) this.registerContextScoped(module.api);
+			try {
+				module.register(this);
+			} catch (error) {
+				throw new CredoError(`Cannot register ${moduleKey}: ${error}`);
+			}
+		}
+	}
+	/**
+	* @internal
+	*/
+	async initializeModules(agentContext) {
+		if (agentContext.dependencyManager.container !== this.container) throw new CredoError(`Method 'initializeModule' called on DependencyManager different from the agent context for which 'initializeModule' is called. Make sure to call 'initializeModule' on the DependencyManager associated with the agent context.`);
+		for (const [moduleName, module] of Object.entries(this.registeredModules)) try {
+			await module.initialize?.(agentContext);
+		} catch (error) {
+			throw new CredoError(`Error during call to 'initialize' method in module '${moduleName}' for agent context '${agentContext.contextCorrelationId}'.`, { cause: error });
+		}
+	}
+	/**
+	* @internal
+	*/
+	async shutdownModules(agentContext) {
+		if (agentContext.dependencyManager.container !== this.container) throw new CredoError(`Method 'shutdownModules' called on DependencyManager different from the agent context for which 'shutdownModules' is called. Make sure to call 'shutdownModules' on the DependencyManager associated with the agent context.`);
+		for (const [moduleName, module] of Object.entries(this.registeredModules)) try {
+			await module.shutdown?.(agentContext);
+		} catch (error) {
+			throw new CredoError(`Error during call to 'shutdown' method in module '${moduleName}' for agent context '${agentContext.contextCorrelationId}'.`, { cause: error });
+		}
+	}
+	/**
+	* @internal
+	*/
+	async initializeAgentContext(agentContext) {
+		if (agentContext.dependencyManager.container !== this.container) throw new CredoError(`Method 'initializeAgentContext' called on DependencyManager different from the agent context for which 'initializeAgentContext' is called. Make sure to call 'initializeAgentContext' on the DependencyManager associated with the agent context.`);
+		for (const [moduleName, module] of Object.entries(this.registeredModules)) try {
+			await module.onInitializeContext?.(agentContext);
+		} catch (error) {
+			throw new CredoError(`Error during call to 'onInitializeContext' method in module '${moduleName}' for agent context '${agentContext.contextCorrelationId}'.`, { cause: error });
+		}
+	}
+	/**
+	* @internal
+	*/
+	async deleteAgentContext(agentContext) {
+		if (agentContext.dependencyManager.container !== this.container) throw new CredoError(`Method 'deleteAgentContext' called on DependencyManager different from the agent context for which 'deleteAgentContext' is called. Make sure to call 'deleteAgentContext' on the DependencyManager associated with the agent context.`);
+		try {
+			for (const [moduleName, module] of Object.entries(this.registeredModules)) try {
+				await module.onDeleteContext?.(agentContext);
+			} catch (error) {
+				throw new CredoError(`Error during call to 'onDeleteContext' method in module '${moduleName}' for agent context '${agentContext.contextCorrelationId}'.`, { cause: error });
+			}
+		} finally {
+			await this.container.dispose();
+		}
+	}
+	/**
+	* @internal
+	*/
+	async provisionAgentContext(agentContext) {
+		if (agentContext.dependencyManager.container !== this.container) throw new CredoError(`Method 'provisionAgentContext' called on DependencyManager different from the agent context for which 'provisionAgentContext' is called. Make sure to call 'provisionAgentContext' on the DependencyManager associated with the agent context.`);
+		for (const [moduleName, module] of Object.entries(this.registeredModules)) try {
+			await module.onProvisionContext?.(agentContext);
+		} catch (error) {
+			throw new CredoError(`Error during call to 'onProvisionContext' method in module '${moduleName}' for agent context '${agentContext.contextCorrelationId}'.`, { cause: error });
+		}
+		return agentContext;
+	}
+	/**
+	* @internal
+	*/
+	async closeAgentContext(agentContext) {
+		if (agentContext.dependencyManager.container !== this.container) throw new CredoError(`Method 'closeAgentContext' called on DependencyManager different from the agent context for which 'closeAgentContext' is called. Make sure to call 'closeAgentContext' on the DependencyManager associated with the agent context.`);
+		try {
+			for (const [moduleName, module] of Object.entries(this.registeredModules)) try {
+				await module.onCloseContext?.(agentContext);
+			} catch (error) {
+				throw new CredoError(`Error during call to 'onCloseContext' method in module '${moduleName}' for agent context '${agentContext.contextCorrelationId}'.`, { cause: error });
+			}
+		} finally {
+			if (!agentContext.isRootAgentContext) await this.container.dispose();
+		}
+	}
+	registerSingleton(fromOrToken, to) {
+		this.container.registerSingleton(fromOrToken, to);
+	}
+	resolve(token) {
+		return this.container.resolve(token);
+	}
+	registerInstance(token, instance) {
+		this.container.registerInstance(token, instance);
+	}
+	isRegistered(token, recursive = false) {
+		return this.container.isRegistered(token, recursive);
+	}
+	registerContextScoped(token, provider) {
+		if (provider) this.container.register(token, provider, { lifecycle: Lifecycle.ContainerScoped });
+		else this.container.register(token, token, { lifecycle: Lifecycle.ContainerScoped });
+	}
+	/**
+	* @internal
+	*/
+	createChild() {
+		return new DependencyManager(this.container.createChildContainer(), this.registeredModules);
+	}
+};
+
+//#endregion
+export { DependencyManager };
+//# sourceMappingURL=DependencyManager.mjs.map

package/build/plugins/DependencyManager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyManager.mjs","names":["rootContainer","container"],"sources":["../../src/plugins/DependencyManager.ts"],"sourcesContent":["import type { DependencyContainer } from 'tsyringe'\nimport { type InjectionToken, Lifecycle, container as rootContainer } from 'tsyringe'\nimport type { AgentContext } from '../agent'\nimport type { ModulesMap } from '../agent/AgentModules'\nimport { CredoError } from '../error'\nimport type { Constructor } from '../utils/mixins'\n\nexport type { InjectionToken }\n\nexport class DependencyManager {\n  public readonly container: DependencyContainer\n  public readonly registeredModules: ModulesMap\n\n  /**\n   * @internal\n   */\n  public constructor(\n    container: DependencyContainer = rootContainer.createChildContainer(),\n    registeredModules: ModulesMap = {}\n  ) {\n    this.container = container\n    this.registeredModules = registeredModules\n  }\n\n  /**\n   * @internal\n   */\n  public registerModules(modules: ModulesMap) {\n    for (const [moduleKey, module] of Object.entries(modules)) {\n      if (this.registeredModules[moduleKey]) {\n        throw new CredoError(\n          `Module with key ${moduleKey} has already been registered. Only a single module can be registered with the same key.`\n        )\n      }\n\n      this.registeredModules[moduleKey] = module\n      if (module.api) {\n        this.registerContextScoped(module.api)\n      }\n      try {\n        module.register(this)\n      } catch (error) {\n        throw new CredoError(`Cannot register ${moduleKey}: ${error}`)\n      }\n    }\n  }\n\n  /**\n   * @internal\n   */\n  public async initializeModules(agentContext: AgentContext) {\n    if (agentContext.dependencyManager.container !== this.container) {\n      throw new CredoError(\n        `Method 'initializeModule' called on DependencyManager different from the agent context for which 'initializeModule' is called. Make sure to call 'initializeModule' on the DependencyManager associated with the agent context.`\n      )\n    }\n\n    for (const [moduleName, module] of Object.entries(this.registeredModules)) {\n      try {\n        await module.initialize?.(agentContext)\n      } catch (error) {\n        throw new CredoError(\n          `Error during call to 'initialize' method in module '${moduleName}' for agent context '${agentContext.contextCorrelationId}'.`,\n          { cause: error }\n        )\n      }\n    }\n  }\n\n  /**\n   * @internal\n   */\n  public async shutdownModules(agentContext: AgentContext) {\n    if (agentContext.dependencyManager.container !== this.container) {\n      throw new CredoError(\n        `Method 'shutdownModules' called on DependencyManager different from the agent context for which 'shutdownModules' is called. Make sure to call 'shutdownModules' on the DependencyManager associated with the agent context.`\n      )\n    }\n\n    for (const [moduleName, module] of Object.entries(this.registeredModules)) {\n      try {\n        await module.shutdown?.(agentContext)\n      } catch (error) {\n        throw new CredoError(\n          `Error during call to 'shutdown' method in module '${moduleName}' for agent context '${agentContext.contextCorrelationId}'.`,\n          { cause: error }\n        )\n      }\n    }\n  }\n\n  /**\n   * @internal\n   */\n  public async initializeAgentContext(agentContext: AgentContext) {\n    if (agentContext.dependencyManager.container !== this.container) {\n      throw new CredoError(\n        `Method 'initializeAgentContext' called on DependencyManager different from the agent context for which 'initializeAgentContext' is called. Make sure to call 'initializeAgentContext' on the DependencyManager associated with the agent context.`\n      )\n    }\n\n    for (const [moduleName, module] of Object.entries(this.registeredModules)) {\n      try {\n        await module.onInitializeContext?.(agentContext)\n      } catch (error) {\n        throw new CredoError(\n          `Error during call to 'onInitializeContext' method in module '${moduleName}' for agent context '${agentContext.contextCorrelationId}'.`,\n          { cause: error }\n        )\n      }\n    }\n  }\n\n  /**\n   * @internal\n   */\n  public async deleteAgentContext(agentContext: AgentContext) {\n    if (agentContext.dependencyManager.container !== this.container) {\n      throw new CredoError(\n        `Method 'deleteAgentContext' called on DependencyManager different from the agent context for which 'deleteAgentContext' is called. Make sure to call 'deleteAgentContext' on the DependencyManager associated with the agent context.`\n      )\n    }\n\n    try {\n      for (const [moduleName, module] of Object.entries(this.registeredModules)) {\n        try {\n          await module.onDeleteContext?.(agentContext)\n        } catch (error) {\n          throw new CredoError(\n            `Error during call to 'onDeleteContext' method in module '${moduleName}' for agent context '${agentContext.contextCorrelationId}'.`,\n            { cause: error }\n          )\n        }\n      }\n    } finally {\n      await this.container.dispose()\n    }\n  }\n\n  /**\n   * @internal\n   */\n  public async provisionAgentContext(agentContext: AgentContext) {\n    if (agentContext.dependencyManager.container !== this.container) {\n      throw new CredoError(\n        `Method 'provisionAgentContext' called on DependencyManager different from the agent context for which 'provisionAgentContext' is called. Make sure to call 'provisionAgentContext' on the DependencyManager associated with the agent context.`\n      )\n    }\n\n    for (const [moduleName, module] of Object.entries(this.registeredModules)) {\n      try {\n        await module.onProvisionContext?.(agentContext)\n      } catch (error) {\n        throw new CredoError(\n          `Error during call to 'onProvisionContext' method in module '${moduleName}' for agent context '${agentContext.contextCorrelationId}'.`,\n          { cause: error }\n        )\n      }\n    }\n\n    return agentContext\n  }\n\n  /**\n   * @internal\n   */\n  public async closeAgentContext(agentContext: AgentContext) {\n    if (agentContext.dependencyManager.container !== this.container) {\n      throw new CredoError(\n        `Method 'closeAgentContext' called on DependencyManager different from the agent context for which 'closeAgentContext' is called. Make sure to call 'closeAgentContext' on the DependencyManager associated with the agent context.`\n      )\n    }\n\n    try {\n      for (const [moduleName, module] of Object.entries(this.registeredModules)) {\n        try {\n          await module.onCloseContext?.(agentContext)\n        } catch (error) {\n          throw new CredoError(\n            `Error during call to 'onCloseContext' method in module '${moduleName}' for agent context '${agentContext.contextCorrelationId}'.`,\n            { cause: error }\n          )\n        }\n      }\n    } finally {\n      // NOTE: we support reinitialization of the root agent so we can't dispose of the agent context\n      if (!agentContext.isRootAgentContext) {\n        await this.container.dispose()\n      }\n    }\n  }\n\n  public registerSingleton<T>(from: InjectionToken<T>, to: InjectionToken<T>): void\n  public registerSingleton<T>(token: Constructor<T>): void\n  // biome-ignore lint/suspicious/noExplicitAny: no explanation\n  public registerSingleton<T = any>(fromOrToken: InjectionToken<T> | Constructor<T>, to?: any) {\n    this.container.registerSingleton(fromOrToken, to)\n  }\n\n  public resolve<T>(token: InjectionToken<T>): T {\n    return this.container.resolve(token)\n  }\n\n  public registerInstance<T>(token: InjectionToken<T>, instance: T) {\n    this.container.registerInstance(token, instance)\n  }\n\n  public isRegistered<T>(token: InjectionToken<T>, recursive = false): boolean {\n    return this.container.isRegistered(token, recursive)\n  }\n\n  // biome-ignore lint/suspicious/noExplicitAny: no explanation\n  public registerContextScoped<T = any>(token: Constructor<T>): void\n  // biome-ignore lint/suspicious/noExplicitAny: no explanation\n  public registerContextScoped<T = any>(token: InjectionToken<T>, provider: Constructor<T>): void\n\n  // biome-ignore lint/suspicious/noExplicitAny: no explanation\n  public registerContextScoped(token: any, provider?: any) {\n    if (provider) this.container.register(token, provider, { lifecycle: Lifecycle.ContainerScoped })\n    else this.container.register(token, token, { lifecycle: Lifecycle.ContainerScoped })\n  }\n\n  /**\n   * @internal\n   */\n  public createChild() {\n    return new DependencyManager(this.container.createChildContainer(), this.registeredModules)\n  }\n}\n"],"mappings":"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"}

package/build/plugins/Module.d.mts

@@ -0,0 +1,62 @@
+import { Constructor } from "../utils/mixins.mjs";
+import { DependencyManager } from "./DependencyManager.mjs";
+import { Update } from "../storage/migration/updates.mjs";
+import { AgentContext } from "../agent/context/AgentContext.mjs";
+import "../agent/index.mjs";
+
+//#region src/plugins/Module.d.ts
+interface Module {
+  api?: Constructor<unknown>;
+  register(dependencyManager: DependencyManager): void;
+  /**
+   * Method that will be called to initialize a module. This method is only called once on startup
+   * with the root agent context. It is meant to initialize services and requirements that are used
+   * globally within the agent, such as a connection to an external ledger.
+   *
+   * For context specific dependencies it is recommened to use `onInitializeContext`, which will be
+   * called for every context that is initialized.
+   */
+  initialize?(agentContext: AgentContext): Promise<void>;
+  /**
+   * Method that will be called to shutdown a module. This method is only called once on shutdown
+   * with the root agent context. It is meant to shutdown services and requirements that are used
+   * globally within the agent, such as a connection to an external ledger.
+   *
+   * For context specific dependencies it is recommened to use `onCloseContext`, which will be
+   * called for every context that is closed.
+   */
+  shutdown?(agentContext: AgentContext): Promise<void>;
+  /**
+   * Method that will be called when an agent context is deleted, and will allow for cleanup of
+   * data related to this agent context.
+   */
+  onDeleteContext?(agentContext: AgentContext): Promise<void>;
+  /**
+   * Method that will be called when an agent context is provisioned/created, and will allow for setting
+   * up of required services, data or other dependencies for an agent context.
+   *
+   * NOTE: this method will NOT be called for the root agent context as the framework
+   * does not know whether we are provisioning or initializing an existing agent.
+   */
+  onProvisionContext?(agentContext: AgentContext): Promise<void>;
+  /**
+   * Method that will be called when an agent context is initialized, and will allow for
+   * setting up of required services, data or other dependencies for an agent context.
+   */
+  onInitializeContext?(agentContext: AgentContext): Promise<void>;
+  /**
+   * Method that will be called when an agent context is closed, and will allow for
+   * closing of e.g. database sessions.
+   */
+  onCloseContext?(agentContext: AgentContext): Promise<void>;
+  /**
+   * List of updates that should be executed when the framework version is updated.
+   */
+  updates?: Update[];
+}
+interface ApiModule extends Module {
+  api: Constructor<unknown>;
+}
+//#endregion
+export { ApiModule, Module };
+//# sourceMappingURL=Module.d.mts.map

package/build/plugins/Module.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Module.d.mts","names":[],"sources":["../../src/plugins/Module.ts"],"sourcesContent":[],"mappings":";;;;;;;UAKiB,MAAA;QACT;8BACsB;;;AAF9B;;;;;;EAsByC,UAAA,EAAA,YAAA,EAVb,YAUa,CAAA,EAVE,OAUF,CAAA,IAAA,CAAA;EAMR;;;;;;;;EA0BrB,QAAA,EAAA,YAAA,EAhCc,YAgCd,CAAA,EAhC6B,OAgC7B,CAAA,IAAA,CAAA;EAAM;AAGlB;;;iCA7BiC,eAAe;;;;;;;;oCASZ,eAAe;;;;;qCAMd,eAAe;;;;;gCAMpB,eAAe;;;;YAKnC;;UAGK,SAAA,SAAkB;OAC5B"}

package/build/plugins/index.d.mts

@@ -0,0 +1,5 @@
+import { DependencyManager, InjectionToken } from "./DependencyManager.mjs";
+import { ApiModule, Module } from "./Module.mjs";
+import { getApiForModuleByName, getRegisteredModuleByInstance, getRegisteredModuleByName } from "./utils.mjs";
+import { inject, injectAll, injectable as injectable$1 } from "tsyringe";
+export { inject, injectAll, injectable$1 as injectable };

package/build/plugins/index.mjs

@@ -0,0 +1,7 @@
+
+
+import { DependencyManager } from "./DependencyManager.mjs";
+import { getApiForModuleByName, getRegisteredModuleByInstance, getRegisteredModuleByName } from "./utils.mjs";
+import { inject, injectAll, injectable as injectable$1 } from "tsyringe";
+
+export { inject, injectAll, injectable$1 as injectable };

package/build/plugins/utils.d.mts

@@ -0,0 +1,13 @@
+import { ApiModule, Module } from "./Module.mjs";
+import { AgentContext } from "../agent/context/AgentContext.mjs";
+import "../agent/index.mjs";
+
+//#region src/plugins/utils.d.ts
+declare function getRegisteredModuleByInstance<M extends Module>(agentContext: AgentContext, moduleType: {
+  new (...args: unknown[]): M;
+}): M | undefined;
+declare function getRegisteredModuleByName<M extends Module>(agentContext: AgentContext, constructorName: string): M | undefined;
+declare function getApiForModuleByName<M extends ApiModule>(agentContext: AgentContext, constructorName: string): InstanceType<M['api']> | undefined;
+//#endregion
+export { getApiForModuleByName, getRegisteredModuleByInstance, getRegisteredModuleByName };
+//# sourceMappingURL=utils.d.mts.map

package/build/plugins/utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","names":[],"sources":["../../src/plugins/utils.ts"],"sourcesContent":[],"mappings":";;;;;iBAGgB,wCAAwC,sBACxC;4BAC0B;IACvC;iBAQa,oCAAoC,sBACpC,wCAEb;iBAQa,gCAAgC,yBAChC,wCAEb,aAAa"}

package/build/plugins/utils.mjs

@@ -0,0 +1,18 @@
+
+
+//#region src/plugins/utils.ts
+function getRegisteredModuleByInstance(agentContext, moduleType) {
+	return Object.values(agentContext.dependencyManager.registeredModules).find((module) => module instanceof moduleType);
+}
+function getRegisteredModuleByName(agentContext, constructorName) {
+	return Object.values(agentContext.dependencyManager.registeredModules).find((module) => module.constructor.name === constructorName);
+}
+function getApiForModuleByName(agentContext, constructorName) {
+	const module = getRegisteredModuleByName(agentContext, constructorName);
+	if (!module || !module.api) return void 0;
+	return agentContext.dependencyManager.resolve(module.api);
+}
+
+//#endregion
+export { getApiForModuleByName, getRegisteredModuleByInstance, getRegisteredModuleByName };
+//# sourceMappingURL=utils.mjs.map

package/build/plugins/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","names":[],"sources":["../../src/plugins/utils.ts"],"sourcesContent":["import type { AgentContext } from '../agent'\nimport type { ApiModule, Module } from './Module'\n\nexport function getRegisteredModuleByInstance<M extends Module>(\n  agentContext: AgentContext,\n  moduleType: { new (...args: unknown[]): M }\n): M | undefined {\n  const module = Object.values(agentContext.dependencyManager.registeredModules).find(\n    (module): module is M => module instanceof moduleType\n  )\n\n  return module\n}\n\nexport function getRegisteredModuleByName<M extends Module>(\n  agentContext: AgentContext,\n  constructorName: string\n): M | undefined {\n  const module = Object.values(agentContext.dependencyManager.registeredModules).find(\n    (module): module is M => module.constructor.name === constructorName\n  )\n\n  return module\n}\n\nexport function getApiForModuleByName<M extends ApiModule>(\n  agentContext: AgentContext,\n  constructorName: string\n): InstanceType<M['api']> | undefined {\n  const module = getRegisteredModuleByName(agentContext, constructorName)\n  if (!module || !module.api) return undefined\n\n  return agentContext.dependencyManager.resolve(module.api) as InstanceType<M['api']>\n}\n"],"mappings":";;;AAGA,SAAgB,8BACd,cACA,YACe;AAKf,QAJe,OAAO,OAAO,aAAa,kBAAkB,kBAAkB,CAAC,MAC5E,WAAwB,kBAAkB,WAC5C;;AAKH,SAAgB,0BACd,cACA,iBACe;AAKf,QAJe,OAAO,OAAO,aAAa,kBAAkB,kBAAkB,CAAC,MAC5E,WAAwB,OAAO,YAAY,SAAS,gBACtD;;AAKH,SAAgB,sBACd,cACA,iBACoC;CACpC,MAAM,SAAS,0BAA0B,cAAc,gBAAgB;AACvE,KAAI,CAAC,UAAU,CAAC,OAAO,IAAK,QAAO;AAEnC,QAAO,aAAa,kBAAkB,QAAQ,OAAO,IAAI"}

package/build/storage/BaseRecord.d.mts

@@ -0,0 +1,61 @@
+import { Metadata } from "./Metadata.mjs";
+
+//#region src/storage/BaseRecord.d.ts
+type TagValue = string | boolean | undefined | Array<string> | null;
+type TagsBase = {
+  [key: string]: TagValue;
+  [key: number]: never;
+};
+type Tags<DefaultTags extends TagsBase, CustomTags extends TagsBase> = CustomTags & DefaultTags;
+type RecordTags<Record$1 extends BaseRecord> = ReturnType<Record$1['getTags']>;
+type BaseRecordAny = BaseRecord<any, any, any>;
+declare abstract class BaseRecord<DefaultTags extends TagsBase = TagsBase, CustomTags extends TagsBase = TagsBase, MetadataValues = {}> {
+  protected _tags: CustomTags & TagsBase;
+  id: string;
+  createdAt: Date;
+  updatedAt?: Date;
+  readonly type: string;
+  static readonly type: string;
+  readonly allowCache: boolean;
+  static readonly allowCache: boolean;
+  /** @inheritdoc {Metadata#Metadata} */
+  metadata: Metadata<MetadataValues>;
+  /**
+   * Get all tags. This is includes custom and default tags
+   * @returns tags object
+   */
+  abstract getTags(): Tags<DefaultTags, CustomTags>;
+  /**
+   * Set the value for a tag
+   * @param name name of the tag
+   * @param value value of the tag
+   */
+  setTag(name: keyof CustomTags | (string & {}), value: CustomTags[keyof CustomTags]): void;
+  /**
+   * Get the value for a tag
+   * @param name name of the tag
+   * @returns The tag value, or undefined if not found
+   */
+  getTag(name: keyof CustomTags | keyof DefaultTags | (string & {})): Tags<DefaultTags, CustomTags>[keyof CustomTags | keyof DefaultTags | (string & {})];
+  /**
+   * Set custom tags. This will merge the tags object with passed in tag properties
+   *
+   * @param tags the tags to set
+   */
+  setTags(tags: Partial<CustomTags | TagsBase>): void;
+  /**
+   * Replace tags. This will replace the whole tags object.
+   * Default tags will still be overridden when retrieving tags
+   *
+   * @param tags the tags to set
+   */
+  replaceTags(tags: CustomTags & Partial<TagsBase>): void;
+  toJSON(): Record<string, unknown>;
+  /**
+   * Clones the record.
+   */
+  clone(): this;
+}
+//#endregion
+export { BaseRecord, BaseRecordAny, RecordTags, TagValue, Tags, TagsBase };
+//# sourceMappingURL=BaseRecord.d.mts.map

package/build/storage/BaseRecord.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseRecord.d.mts","names":[],"sources":["../../src/storage/BaseRecord.ts"],"sourcesContent":[],"mappings":";;;KAOY,QAAA,kCAA0C;KAC1C,QAAA;iBACK;;AAFjB,CAAA;AACY,KAKA,IALQ,CAAA,oBAKiB,QAJZ,EAAA,mBAIyC,QAJzC,CAAA,GAIqD,UAJrD,GAIkE,WAJlE;AAIb,KAEA,UAFI,CAAA,iBAEsB,UAFtB,CAAA,GAEoC,UAFpC,CAE+C,QAF/C,CAAA,SAAA,CAAA,CAAA;AAAqB,KASzB,aAAA,GAAgB,UATS,CAAA,GAAA,EAAA,GAAA,EAAA,GAAA,CAAA;AAA6B,uBAW5C,UAX4C,CAAA,oBAY5C,QAZ4C,GAYjC,QAZiC,EAAA,mBAa7C,QAb6C,GAalC,QAbkC,EAAA,iBAAA,CAAA,CAAA,CAAA,CAAA;EAAY,UAAA,KAAA,EAmB3D,UAnB2D,GAmB9C,QAnB8C;EAAa,EAAA,EAAA,MAAA;EAAW,SAAA,EAwBjF,IAxBiF;EAE1F,SAAA,CAAA,EAyBS,IAzBC;EAAgB,SAAA,IAAA,EAAA,MAAA;EAAyB,gBAAA,IAAA,EAAA,MAAA;EAAX,SAAA,UAAA,EAAA,OAAA;EAAU,gBAAA,UAAA,EAAA,OAAA;EAOlD;EAEU,QAAA,EA4BH,QA5Ba,CA4BJ,cA5BI,CAAA;EACV;;;;EAOH,SAAA,OAAA,CAAA,CAAA,EA0BU,IA1BV,CA0Be,WA1Bf,EA0B4B,UA1B5B,CAAA;EAAa;;;;;EA0BE,MAAA,CAAA,IAAA,EAAA,MAON,UAPM,GAAA,CAAA,MAAA,GAAA,CAAA,CAAA,CAAA,EAAA,KAAA,EAO6B,UAP7B,CAAA,MAO8C,UAP9C,CAAA,CAAA,EAAA,IAAA;EAAa;;;;;EAgBnB,MAAA,CAAA,IAAA,EAAA,MAAA,UAAA,GAAA,MAAmB,WAAnB,GAAA,CAAA,MAAA,GAAA,CAAA,CAAA,CAAA,CAAA,EAA8C,IAA9C,CAA8C,WAA9C,EAA8C,UAA9C,CAAA,CAAA,MAA8C,UAA9C,GAAA,MAA8C,WAA9C,GAAA,CAAA,MAAA,GAAA,CAAA,CAAA,CAAA,CAAA;EAAmB;;;;;EAA2B,OAAA,CAAA,IAAA,EASnD,OATmD,CAS3C,UAT2C,GAS9B,QAT8B,CAAA,CAAA,EAAA,IAAA;EAS3C;;;;;;EAiBZ,WAAA,CAAA,IAAA,EAJQ,UAIR,GAJqB,OAIrB,CAJ6B,QAI7B,CAAA,CAAA,EAAA,IAAA;EAAM,MAAA,CAAA,CAAA,EAAN,MAAM,CAAA,MAAA,EAAA,OAAA,CAAA"}