@tangle-network/agent-integrations 0.49.0 → 0.51.0

package/dist/chunk-P4FFI752.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-P4FFI752.js.map

package/dist/chunk-PUXYDSXI.js

@@ -0,0 +1,109 @@
+import {
+  CONNECTOR_ADAPTER_FACTORIES,
+  adapters_exports
+} from "./chunk-XEJKVCXB.js";
+
+// src/connectors/bundled-manifests.ts
+var MANIFEST_PROBE_PREFIX = "tangle-adapter-metadata-";
+function isConnectorAdapter(value) {
+  if (!value || typeof value !== "object") return false;
+  const manifest = value.manifest;
+  if (!manifest || typeof manifest !== "object") return false;
+  return typeof manifest.kind === "string";
+}
+function manifestFromFactory(definition) {
+  const probeOptions = Object.fromEntries(
+    Object.keys(definition.envMap).map((name) => [name, `${MANIFEST_PROBE_PREFIX}${name}`])
+  );
+  try {
+    return definition.factory(probeOptions).manifest;
+  } catch {
+    return void 0;
+  }
+}
+var cachedManifests;
+var cachedByKind;
+function buildRegistry() {
+  const byKind = /* @__PURE__ */ new Map();
+  for (const value of Object.values(adapters_exports)) {
+    if (isConnectorAdapter(value)) byKind.set(value.manifest.kind, value.manifest);
+  }
+  for (const definition of CONNECTOR_ADAPTER_FACTORIES) {
+    if (byKind.has(definition.kind)) continue;
+    const manifest = manifestFromFactory(definition);
+    if (manifest) byKind.set(manifest.kind, manifest);
+  }
+  return byKind;
+}
+function registry() {
+  if (!cachedByKind) cachedByKind = buildRegistry();
+  return cachedByKind;
+}
+function listBundledAdapterManifests() {
+  if (!cachedManifests) {
+    cachedManifests = [...registry().values()].sort((a, b) => a.kind.localeCompare(b.kind));
+  }
+  return cachedManifests;
+}
+function getBundledAdapterManifest(kind) {
+  return registry().get(kind);
+}
+function hasBundledAdapter(kind) {
+  return registry().has(kind);
+}
+function listBundledAdapterKinds() {
+  return listBundledAdapterManifests().map((manifest) => manifest.kind);
+}
+function bundledAuthMode(manifest) {
+  const auth = manifest.auth;
+  const effective = auth.kind === "one_of" ? auth.options.find((option) => option.kind === auth.preferred) ?? auth.options[0] : auth;
+  switch (effective.kind) {
+    case "oauth2":
+      return effective.grantType === "client_credentials" ? "oauth2_client_credentials" : "oauth2";
+    case "api-key":
+      return "api_key";
+    case "hmac":
+      return "hmac";
+    case "none":
+      return "none";
+    default:
+      return void 0;
+  }
+}
+function bundledApiKeyHint(manifest) {
+  const auth = manifest.auth;
+  const candidates = auth.kind === "one_of" ? auth.options : [auth];
+  for (const candidate of candidates) {
+    if (candidate.kind === "api-key") return candidate.hint;
+  }
+  return void 0;
+}
+function bundledOAuth2Auth(manifest) {
+  const auth = manifest.auth;
+  const candidates = auth.kind === "one_of" ? auth.options.filter((option) => option.kind === auth.preferred) : [auth];
+  for (const candidate of candidates) {
+    if (candidate.kind !== "oauth2") continue;
+    if (candidate.grantType === "client_credentials") continue;
+    if (!candidate.authorizationUrl) continue;
+    return {
+      authorizationUrl: candidate.authorizationUrl,
+      tokenUrl: candidate.tokenUrl,
+      scopes: candidate.scopes,
+      clientIdEnv: candidate.clientIdEnv,
+      clientSecretEnv: candidate.clientSecretEnv,
+      extraAuthParams: candidate.extraAuthParams
+    };
+  }
+  return void 0;
+}
+
+export {
+  listBundledAdapterManifests,
+  getBundledAdapterManifest,
+  hasBundledAdapter,
+  listBundledAdapterKinds,
+  bundledAuthMode,
+  bundledApiKeyHint,
+  bundledOAuth2Auth
+};
+//# sourceMappingURL=chunk-PUXYDSXI.js.map

package/dist/chunk-PUXYDSXI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/connectors/bundled-manifests.ts"],"sourcesContent":["import {\n  CONNECTOR_ADAPTER_FACTORIES,\n  type ConnectorAdapterFactoryDefinition,\n} from './adapters/factories.js'\nimport * as bundledAdapters from './adapters/index.js'\nimport type { ConnectorAdapter, ConnectorManifest } from './types.js'\n\n/**\n * The bundled adapter registry — the single source of truth for \"which\n * connectors does this package actually implement, and how do they really\n * authenticate\".\n *\n * This exists because the answer was previously maintained by hand in two\n * places that drifted apart: `specs/registry.ts` carried an 18-name\n * `EXECUTABLE_KINDS` set while the package shipped 530 adapters, and the\n * platform kept its own private `collectBundledAdapters()` copy. A catalog\n * that describes connectors must derive from the connectors, never restate\n * them — restating is what let QuickBooks and Xero advertise a\n * `https://example.invalid/...` authorization URL behind a live Connect\n * button.\n *\n * Manifests are static data. Factory-style adapters need client credentials\n * to *execute*, but their manifest (auth endpoints, scopes, capability list)\n * is fixed at definition time, so we instantiate them with clearly-marked\n * placeholder options purely to read that static shape. The placeholders are\n * never used to make a request — {@link listBundledAdapterManifests} returns\n * manifests, not adapters.\n */\n\n/** Placeholder marker for factory options resolved only to read a manifest. */\nconst MANIFEST_PROBE_PREFIX = 'tangle-adapter-metadata-'\n\nfunction isConnectorAdapter(value: unknown): value is ConnectorAdapter {\n  if (!value || typeof value !== 'object') return false\n  const manifest = (value as { manifest?: unknown }).manifest\n  if (!manifest || typeof manifest !== 'object') return false\n  return typeof (manifest as { kind?: unknown }).kind === 'string'\n}\n\nfunction manifestFromFactory(\n  definition: ConnectorAdapterFactoryDefinition,\n): ConnectorManifest | undefined {\n  const probeOptions = Object.fromEntries(\n    Object.keys(definition.envMap).map((name) => [name, `${MANIFEST_PROBE_PREFIX}${name}`]),\n  )\n  try {\n    return definition.factory(probeOptions).manifest\n  } catch {\n    // A factory that cannot be constructed from placeholder options cannot\n    // contribute a manifest. Skipping is correct: it means the adapter is not\n    // describable without real credentials, so the catalog must not claim it.\n    return undefined\n  }\n}\n\nlet cachedManifests: ConnectorManifest[] | undefined\nlet cachedByKind: Map<string, ConnectorManifest> | undefined\n\nfunction buildRegistry(): Map<string, ConnectorManifest> {\n  const byKind = new Map<string, ConnectorManifest>()\n  for (const value of Object.values(bundledAdapters)) {\n    if (isConnectorAdapter(value)) byKind.set(value.manifest.kind, value.manifest)\n  }\n  for (const definition of CONNECTOR_ADAPTER_FACTORIES) {\n    if (byKind.has(definition.kind)) continue\n    const manifest = manifestFromFactory(definition)\n    if (manifest) byKind.set(manifest.kind, manifest)\n  }\n  return byKind\n}\n\nfunction registry(): Map<string, ConnectorManifest> {\n  if (!cachedByKind) cachedByKind = buildRegistry()\n  return cachedByKind\n}\n\n/** Every connector manifest this package bundles, sorted by kind. */\nexport function listBundledAdapterManifests(): ConnectorManifest[] {\n  if (!cachedManifests) {\n    cachedManifests = [...registry().values()].sort((a, b) => a.kind.localeCompare(b.kind))\n  }\n  return cachedManifests\n}\n\n/** The bundled manifest for `kind`, or undefined when nothing implements it. */\nexport function getBundledAdapterManifest(kind: string): ConnectorManifest | undefined {\n  return registry().get(kind)\n}\n\n/** Whether this package ships a real, executable adapter for `kind`. */\nexport function hasBundledAdapter(kind: string): boolean {\n  return registry().has(kind)\n}\n\n/** Kinds this package implements. */\nexport function listBundledAdapterKinds(): string[] {\n  return listBundledAdapterManifests().map((manifest) => manifest.kind)\n}\n\n/**\n * How a bundled connector really authenticates.\n *\n * `oauth2_client_credentials` is called out separately because it IS a\n * connectable mode but has no user-facing authorize step — a caller that\n * treats \"oauth2 without an authorizationUrl\" as broken would wrongly condemn\n * these machine-to-machine providers.\n */\nexport type BundledAuthMode =\n  | 'oauth2'\n  | 'oauth2_client_credentials'\n  | 'api_key'\n  | 'hmac'\n  | 'none'\n\n/** The auth mode a connect flow would actually drive for this manifest,\n *  resolving `one_of` through its declared `preferred` mode. */\nexport function bundledAuthMode(manifest: ConnectorManifest): BundledAuthMode | undefined {\n  const auth = manifest.auth\n  const effective =\n    auth.kind === 'one_of'\n      ? (auth.options.find((option) => option.kind === auth.preferred) ?? auth.options[0])\n      : auth\n  switch (effective.kind) {\n    case 'oauth2':\n      return effective.grantType === 'client_credentials' ? 'oauth2_client_credentials' : 'oauth2'\n    case 'api-key':\n      return 'api_key'\n    case 'hmac':\n      return 'hmac'\n    case 'none':\n      return 'none'\n    default:\n      return undefined\n  }\n}\n\n/** The setup hint an api-key connector shows when collecting its credential. */\nexport function bundledApiKeyHint(manifest: ConnectorManifest): string | undefined {\n  const auth = manifest.auth\n  const candidates = auth.kind === 'one_of' ? auth.options : [auth]\n  for (const candidate of candidates) {\n    if (candidate.kind === 'api-key') return candidate.hint\n  }\n  return undefined\n}\n\n/** The authorization-code OAuth2 branch of a manifest's auth spec, if it has\n *  one. `one_of` manifests are resolved through their `preferred` mode, which\n *  is the mode a connect flow would actually drive. Returns undefined for\n *  api-key/hmac/none connectors and for `client_credentials` OAuth (which has\n *  no user-facing authorize step). */\nexport function bundledOAuth2Auth(manifest: ConnectorManifest):\n  | {\n      authorizationUrl: string\n      tokenUrl: string\n      scopes: string[]\n      clientIdEnv: string\n      clientSecretEnv: string\n      extraAuthParams?: Record<string, string>\n    }\n  | undefined {\n  const auth = manifest.auth\n  const candidates =\n    auth.kind === 'one_of'\n      ? auth.options.filter((option) => option.kind === auth.preferred)\n      : [auth]\n  for (const candidate of candidates) {\n    if (candidate.kind !== 'oauth2') continue\n    if (candidate.grantType === 'client_credentials') continue\n    if (!candidate.authorizationUrl) continue\n    return {\n      authorizationUrl: candidate.authorizationUrl,\n      tokenUrl: candidate.tokenUrl,\n      scopes: candidate.scopes,\n      clientIdEnv: candidate.clientIdEnv,\n      clientSecretEnv: candidate.clientSecretEnv,\n      extraAuthParams: candidate.extraAuthParams,\n    }\n  }\n  return undefined\n}\n"],"mappings":";;;;;;AA8BA,IAAM,wBAAwB;AAE9B,SAAS,mBAAmB,OAA2C;AACrE,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,WAAY,MAAiC;AACnD,MAAI,CAAC,YAAY,OAAO,aAAa,SAAU,QAAO;AACtD,SAAO,OAAQ,SAAgC,SAAS;AAC1D;AAEA,SAAS,oBACP,YAC+B;AAC/B,QAAM,eAAe,OAAO;AAAA,IAC1B,OAAO,KAAK,WAAW,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,qBAAqB,GAAG,IAAI,EAAE,CAAC;AAAA,EACxF;AACA,MAAI;AACF,WAAO,WAAW,QAAQ,YAAY,EAAE;AAAA,EAC1C,QAAQ;AAIN,WAAO;AAAA,EACT;AACF;AAEA,IAAI;AACJ,IAAI;AAEJ,SAAS,gBAAgD;AACvD,QAAM,SAAS,oBAAI,IAA+B;AAClD,aAAW,SAAS,OAAO,OAAO,gBAAe,GAAG;AAClD,QAAI,mBAAmB,KAAK,EAAG,QAAO,IAAI,MAAM,SAAS,MAAM,MAAM,QAAQ;AAAA,EAC/E;AACA,aAAW,cAAc,6BAA6B;AACpD,QAAI,OAAO,IAAI,WAAW,IAAI,EAAG;AACjC,UAAM,WAAW,oBAAoB,UAAU;AAC/C,QAAI,SAAU,QAAO,IAAI,SAAS,MAAM,QAAQ;AAAA,EAClD;AACA,SAAO;AACT;AAEA,SAAS,WAA2C;AAClD,MAAI,CAAC,aAAc,gBAAe,cAAc;AAChD,SAAO;AACT;AAGO,SAAS,8BAAmD;AACjE,MAAI,CAAC,iBAAiB;AACpB,sBAAkB,CAAC,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC;AAAA,EACxF;AACA,SAAO;AACT;AAGO,SAAS,0BAA0B,MAA6C;AACrF,SAAO,SAAS,EAAE,IAAI,IAAI;AAC5B;AAGO,SAAS,kBAAkB,MAAuB;AACvD,SAAO,SAAS,EAAE,IAAI,IAAI;AAC5B;AAGO,SAAS,0BAAoC;AAClD,SAAO,4BAA4B,EAAE,IAAI,CAAC,aAAa,SAAS,IAAI;AACtE;AAmBO,SAAS,gBAAgB,UAA0D;AACxF,QAAM,OAAO,SAAS;AACtB,QAAM,YACJ,KAAK,SAAS,WACT,KAAK,QAAQ,KAAK,CAAC,WAAW,OAAO,SAAS,KAAK,SAAS,KAAK,KAAK,QAAQ,CAAC,IAChF;AACN,UAAQ,UAAU,MAAM;AAAA,IACtB,KAAK;AACH,aAAO,UAAU,cAAc,uBAAuB,8BAA8B;AAAA,IACtF,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAGO,SAAS,kBAAkB,UAAiD;AACjF,QAAM,OAAO,SAAS;AACtB,QAAM,aAAa,KAAK,SAAS,WAAW,KAAK,UAAU,CAAC,IAAI;AAChE,aAAW,aAAa,YAAY;AAClC,QAAI,UAAU,SAAS,UAAW,QAAO,UAAU;AAAA,EACrD;AACA,SAAO;AACT;AAOO,SAAS,kBAAkB,UASpB;AACZ,QAAM,OAAO,SAAS;AACtB,QAAM,aACJ,KAAK,SAAS,WACV,KAAK,QAAQ,OAAO,CAAC,WAAW,OAAO,SAAS,KAAK,SAAS,IAC9D,CAAC,IAAI;AACX,aAAW,aAAa,YAAY;AAClC,QAAI,UAAU,SAAS,SAAU;AACjC,QAAI,UAAU,cAAc,qBAAsB;AAClD,QAAI,CAAC,UAAU,iBAAkB;AACjC,WAAO;AAAA,MACL,kBAAkB,UAAU;AAAA,MAC5B,UAAU,UAAU;AAAA,MACpB,QAAQ,UAAU;AAAA,MAClB,aAAa,UAAU;AAAA,MACvB,iBAAiB,UAAU;AAAA,MAC3B,iBAAiB,UAAU;AAAA,IAC7B;AAAA,EACF;AACA,SAAO;AACT;","names":[]}