import { useCallback, useMemo } from "react";import { useAtomValue, useAtomSet } from "@effect/atom-react";import * as Exit from "effect/Exit";import * as AsyncResult from "effect/unstable/reactivity/AsyncResult";import { AuthTemplateSlug, IntegrationSlug } from "@executor-js/sdk/shared";import type { IntegrationAccountHandoff } from "@executor-js/sdk/client"; import { AccountsSection } from "@executor-js/react/components/accounts-section";import { HealthCheckEditor, type HealthCheckLivePreview,} from "@executor-js/react/components/health-check-editor";import { integrationWriteKeys } from "@executor-js/react/api/reactivity-keys";import { useOrganizationId } from "@executor-js/react/api/organization-context";import { defaultConnectionOwnerForHost } from "@executor-js/react/plugins/connection-owner";import type { AuthMethod, Placement } from "@executor-js/react/lib/auth-placements";import { useCustomMethodActions, type AuthMethodsCodec, type ConfigureAuthMethods,} from "@executor-js/react/lib/custom-auth-methods"; import { openApiConfigAtom, openapiConfigure } from "./atoms";import { authMethodsFromConfig, templateFromPlacements, openApiWireAuthInput,} from "./auth-method-config";import type { Authentication } from "../sdk/types"; const NO_AUTH_METHOD: AuthMethod = { id: "none", label: "No authentication", kind: "none", source: "spec", template: AuthTemplateSlug.make("none"), placements: [],}; // ---------------------------------------------------------------------------// OpenAPI Accounts hub: fills the generic detail page's `accounts` slot.//// Reads the integration's real `authenticationTemplate` (via `getConfig`),// converts it to generic `AuthMethod[]`, and composes the generic// `AccountsSection`, whose Add-account offers those methods plus a "+ Custom// method" row (apiKey-only). The custom-method create is INJECTED here// (`createCustomMethod`): generic placements → an `APIKeyAuthentication`// (`templateFromPlacements`, slug omitted → backend `custom_<id>`) merge-// appended onto the existing template and persisted via `configure`. Stays// plugin-side because it touches the OpenAPI sdk `Authentication` types.// --------------------------------------------------------------------------- export default function OpenApiAccountsPanel(props: { readonly sourceId: string; readonly integrationName: string; readonly accountHandoff?: IntegrationAccountHandoff | null;}) { const { sourceId, integrationName, accountHandoff } = props; const slug = IntegrationSlug.make(sourceId); const configResult = useAtomValue(openApiConfigAtom(slug)); const doConfigure = useAtomSet(openapiConfigure, { mode: "promiseExit" }); // The wire `getConfig` template is structurally an `Authentication[]` (the // `slug` is an unbranded string on the wire); treat it as such for the // plugin-side converters that brand the slug back. const existingTemplate = useMemo<readonly Authentication[]>(() => { if (!AsyncResult.isSuccess(configResult) || configResult.value == null) return []; return (configResult.value.authenticationTemplate ?? []) as readonly Authentication[]; }, [configResult]); const methods = useMemo<readonly AuthMethod[]>(() => { const declared = authMethodsFromConfig(existingTemplate); return declared.length > 0 ? declared : [NO_AUTH_METHOD]; }, [existingTemplate]); // Custom-method create/remove: the shared skeleton (merge-append → diff out // the created method; filter → replace) parameterized by the OpenAPI codec. // Stays plugin-side only where it touches the OpenAPI `Authentication` types. const configure = useCallback<ConfigureAuthMethods<Authentication>>( async (input) => { const exit = await doConfigure({ params: { slug }, payload: { authenticationTemplate: input.authenticationTemplate.map(openApiWireAuthInput), ...(input.mode ? { mode: input.mode } : {}), }, reactivityKeys: integrationWriteKeys, }); return Exit.map(exit, (result) => result.authenticationTemplate as readonly Authentication[]); }, [doConfigure, slug], ); const codec = useMemo<AuthMethodsCodec<Authentication>>( () => ({ toAuthMethods: authMethodsFromConfig, // Slug omitted → backend backfills `custom_<id>`. templatesFromPlacements: (placements: readonly Placement[]) => [ templateFromPlacements(placements), ], slugOf: (template: Authentication) => String(template.slug), }), [], ); const { createCustomMethod, removeCustomMethod } = useCustomMethodActions({ existing: existingTemplate, codec, configure, }); // Live-preview context for the health-check edit sheet: probe as the host's // default owner against the integration's API-key auth methods (the only kind // a pasted test key can validate). OAuth/none methods can't be previewed with // a key, so they're filtered out; with no apikey method the sheet hides the // preview block entirely. const organizationId = useOrganizationId(); const livePreview = useMemo<HealthCheckLivePreview | undefined>(() => { const templates = methods .filter((m) => m.kind === "apikey") .map((m) => ({ template: m.template, label: m.label })); if (templates.length === 0) return undefined; return { owner: defaultConnectionOwnerForHost(organizationId), templates }; }, [methods, organizationId]); return ( <div className="mx-auto max-w-3xl space-y-8 px-6 py-8"> <AccountsSection integration={slug} integrationName={integrationName} methods={methods} accountHandoff={accountHandoff} createCustomMethod={createCustomMethod} removeCustomMethod={removeCustomMethod} /> <HealthCheckEditor integration={slug} livePreview={livePreview} /> </div> );}
import { useCallback, useMemo } from "react";
import { useAtomValue, useAtomSet } from "@effect/atom-react";
import * as Exit from "effect/Exit";
import * as AsyncResult from "effect/unstable/reactivity/AsyncResult";
import { AuthTemplateSlug, IntegrationSlug } from "@executor-js/sdk/shared";
import type { IntegrationAccountHandoff } from "@executor-js/sdk/client";
import { AccountsSection } from "@executor-js/react/components/accounts-section";
import {
HealthCheckEditor,
type HealthCheckLivePreview,
} from "@executor-js/react/components/health-check-editor";
import { integrationWriteKeys } from "@executor-js/react/api/reactivity-keys";
import { useOrganizationId } from "@executor-js/react/api/organization-context";
import { defaultConnectionOwnerForHost } from "@executor-js/react/plugins/connection-owner";
import type { AuthMethod, Placement } from "@executor-js/react/lib/auth-placements";
import {
useCustomMethodActions,
type AuthMethodsCodec,
type ConfigureAuthMethods,
} from "@executor-js/react/lib/custom-auth-methods";
import { openApiConfigAtom, openapiConfigure } from "./atoms";
import {
authMethodsFromConfig,
templateFromPlacements,
openApiWireAuthInput,
} from "./auth-method-config";
import type { Authentication } from "../sdk/types";
const NO_AUTH_METHOD: AuthMethod = {
id: "none",
label: "No authentication",
kind: "none",
source: "spec",
template: AuthTemplateSlug.make("none"),
placements: [],
};
// ---------------------------------------------------------------------------
// OpenAPI Accounts hub: fills the generic detail page's `accounts` slot.
//
// Reads the integration's real `authenticationTemplate` (via `getConfig`),
// converts it to generic `AuthMethod[]`, and composes the generic
// `AccountsSection`, whose Add-account offers those methods plus a "+ Custom
// method" row (apiKey-only). The custom-method create is INJECTED here
// (`createCustomMethod`): generic placements → an `APIKeyAuthentication`
// (`templateFromPlacements`, slug omitted → backend `custom_<id>`) merge-
// appended onto the existing template and persisted via `configure`. Stays
// plugin-side because it touches the OpenAPI sdk `Authentication` types.
// ---------------------------------------------------------------------------
export default function OpenApiAccountsPanel(props: {
readonly sourceId: string;
readonly integrationName: string;
readonly accountHandoff?: IntegrationAccountHandoff | null;
}) {
const { sourceId, integrationName, accountHandoff } = props;
const slug = IntegrationSlug.make(sourceId);
const configResult = useAtomValue(openApiConfigAtom(slug));
const doConfigure = useAtomSet(openapiConfigure, { mode: "promiseExit" });
// The wire `getConfig` template is structurally an `Authentication[]` (the
// `slug` is an unbranded string on the wire); treat it as such for the
// plugin-side converters that brand the slug back.
const existingTemplate = useMemo<readonly Authentication[]>(() => {
if (!AsyncResult.isSuccess(configResult) || configResult.value == null) return [];
return (configResult.value.authenticationTemplate ?? []) as readonly Authentication[];
}, [configResult]);
const methods = useMemo<readonly AuthMethod[]>(() => {
const declared = authMethodsFromConfig(existingTemplate);
return declared.length > 0 ? declared : [NO_AUTH_METHOD];
}, [existingTemplate]);
// Custom-method create/remove: the shared skeleton (merge-append → diff out
// the created method; filter → replace) parameterized by the OpenAPI codec.
// Stays plugin-side only where it touches the OpenAPI `Authentication` types.
const configure = useCallback<ConfigureAuthMethods<Authentication>>(
async (input) => {
const exit = await doConfigure({
params: { slug },
payload: {
authenticationTemplate: input.authenticationTemplate.map(openApiWireAuthInput),
...(input.mode ? { mode: input.mode } : {}),
},
reactivityKeys: integrationWriteKeys,
});
return Exit.map(exit, (result) => result.authenticationTemplate as readonly Authentication[]);
},
[doConfigure, slug],
);
const codec = useMemo<AuthMethodsCodec<Authentication>>(
() => ({
toAuthMethods: authMethodsFromConfig,
// Slug omitted → backend backfills `custom_<id>`.
templatesFromPlacements: (placements: readonly Placement[]) => [
templateFromPlacements(placements),
],
slugOf: (template: Authentication) => String(template.slug),
}),
[],
);
const { createCustomMethod, removeCustomMethod } = useCustomMethodActions({
existing: existingTemplate,
codec,
configure,
});
// Live-preview context for the health-check edit sheet: probe as the host's
// default owner against the integration's API-key auth methods (the only kind
// a pasted test key can validate). OAuth/none methods can't be previewed with
// a key, so they're filtered out; with no apikey method the sheet hides the
// preview block entirely.
const organizationId = useOrganizationId();
const livePreview = useMemo<HealthCheckLivePreview | undefined>(() => {
const templates = methods
.filter((m) => m.kind === "apikey")
.map((m) => ({ template: m.template, label: m.label }));
if (templates.length === 0) return undefined;
return { owner: defaultConnectionOwnerForHost(organizationId), templates };
}, [methods, organizationId]);
return (
<div className="mx-auto max-w-3xl space-y-8 px-6 py-8">
<AccountsSection
integration={slug}
integrationName={integrationName}
methods={methods}
accountHandoff={accountHandoff}
createCustomMethod={createCustomMethod}
removeCustomMethod={removeCustomMethod}
/>
<HealthCheckEditor integration={slug} livePreview={livePreview} />
</div>
);
}