@fragno-dev/project-connector-fragment 0.0.0-stage → 0.0.1

package/dist/node/index.d.ts

@@ -0,0 +1,456 @@
+import { projectConnectorConnectInputSchema } from "./project-connector-contracts.js";
+import { ProjectConnectorConnectionReadinessChangedPayload, ProjectConnectorFragmentConfig } from "./definition.js";
+import { FragnoPublicClientConfig } from "@fragno-dev/core/client";
+import { FragnoPublicConfigWithDatabase } from "@fragno-dev/db";
+//#region src/index.d.ts
+/** Creates a project-scoped connector with integrator-owned user authentication. */
+declare function createProjectConnectorFragment(config: ProjectConnectorFragmentConfig, fragnoConfig: FragnoPublicConfigWithDatabase): import("@fragno-dev/core").FragnoInstantiatedFragment<readonly [import("@fragno-dev/core").FragnoRouteConfig<"GET", "/provider-configs", import("@standard-schema/spec").StandardSchemaV1<unknown, unknown> | undefined, import("zod").ZodObject<{
+  projectId: import("zod").ZodString;
+  providerConfigs: import("zod").ZodArray<import("zod").ZodObject<{
+    id: import("zod").ZodString;
+    service: import("zod").ZodString;
+    displayName: import("zod").ZodString;
+    callbackUrl: import("zod").ZodURL;
+    effectiveScopes: import("zod").ZodArray<import("zod").ZodString>;
+    proxyAvailable: import("zod").ZodBoolean;
+  }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, "UNAUTHENTICATED" | "PROJECT_CONNECTOR_ERROR", string, import("@fragno-dev/db").DatabaseRequestContext<{
+  onConnectionReadinessChanged: import("@fragno-dev/db").HookFn<ProjectConnectorConnectionReadinessChangedPayload>;
+}>>, import("@fragno-dev/core").FragnoRouteConfig<"GET", "/provider-configs/:providerConfigId/actions", import("@standard-schema/spec").StandardSchemaV1<unknown, unknown> | undefined, import("zod").ZodObject<{
+  projectId: import("zod").ZodString;
+  providerConfigId: import("zod").ZodString;
+  actions: import("zod").ZodArray<import("zod").ZodObject<{
+    id: import("zod").ZodString;
+    service: import("zod").ZodString;
+    name: import("zod").ZodString;
+    description: import("zod").ZodNullable<import("zod").ZodString>;
+    inputSchema: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+    outputSchema: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+  }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, "UNAUTHENTICATED" | "PROJECT_CONNECTOR_ERROR" | "PROVIDER_CONFIG_NOT_FOUND", string, import("@fragno-dev/db").DatabaseRequestContext<{
+  onConnectionReadinessChanged: import("@fragno-dev/db").HookFn<ProjectConnectorConnectionReadinessChangedPayload>;
+}>>, import("@fragno-dev/core").FragnoRouteConfig<"GET", "/status", import("@standard-schema/spec").StandardSchemaV1<unknown, unknown> | undefined, import("zod").ZodObject<{
+  authenticated: import("zod").ZodLiteral<true>;
+}, import("zod/v4/core").$strip>, "UNAUTHENTICATED" | "PROJECT_CONNECTOR_ERROR", string, import("@fragno-dev/db").DatabaseRequestContext<{
+  onConnectionReadinessChanged: import("@fragno-dev/db").HookFn<ProjectConnectorConnectionReadinessChangedPayload>;
+}>>, import("@fragno-dev/core").FragnoRouteConfig<"POST", "/connection-requests", import("zod").ZodUnion<readonly [import("zod").ZodObject<{
+  service: import("zod").ZodString;
+  connectionName: import("zod").ZodString;
+  returnUri: import("zod").ZodURL;
+}, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+  providerConfigId: import("zod").ZodString;
+  connectionName: import("zod").ZodString;
+  returnUri: import("zod").ZodURL;
+}, import("zod/v4/core").$strict>]>, import("zod").ZodObject<{
+  id: import("zod").ZodString;
+  projectId: import("zod").ZodString;
+  providerConfigId: import("zod").ZodString;
+  externalUserId: import("zod").ZodString;
+  service: import("zod").ZodString;
+  connectionName: import("zod").ZodString;
+  authorizationUrl: import("zod").ZodURL;
+  expiresAt: import("zod").ZodString;
+  state: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+    status: import("zod").ZodLiteral<"initiated">;
+  }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    status: import("zod").ZodLiteral<"connected">;
+    connectedAccountId: import("zod").ZodString;
+  }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    status: import("zod").ZodLiteral<"failed">;
+    errorCode: import("zod").ZodNullable<import("zod").ZodString>;
+    errorMessage: import("zod").ZodNullable<import("zod").ZodString>;
+  }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    status: import("zod").ZodLiteral<"expired">;
+  }, import("zod/v4/core").$strip>], "status">;
+}, import("zod/v4/core").$strip>, "UNAUTHENTICATED" | "PROJECT_CONNECTOR_ERROR" | "RETURN_URI_NOT_ALLOWED", string, import("@fragno-dev/db").DatabaseRequestContext<{
+  onConnectionReadinessChanged: import("@fragno-dev/db").HookFn<ProjectConnectorConnectionReadinessChangedPayload>;
+}>>, import("@fragno-dev/core").FragnoRouteConfig<"GET", "/connection-requests/by-name", import("@standard-schema/spec").StandardSchemaV1<unknown, unknown> | undefined, import("zod").ZodObject<{
+  request: import("zod").ZodNullable<import("zod").ZodObject<{
+    id: import("zod").ZodString;
+    projectId: import("zod").ZodString;
+    providerConfigId: import("zod").ZodString;
+    externalUserId: import("zod").ZodString;
+    service: import("zod").ZodString;
+    connectionName: import("zod").ZodString;
+    authorizationUrl: import("zod").ZodURL;
+    expiresAt: import("zod").ZodString;
+    state: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+      status: import("zod").ZodLiteral<"initiated">;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+      status: import("zod").ZodLiteral<"connected">;
+      connectedAccountId: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+      status: import("zod").ZodLiteral<"failed">;
+      errorCode: import("zod").ZodNullable<import("zod").ZodString>;
+      errorMessage: import("zod").ZodNullable<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+      status: import("zod").ZodLiteral<"expired">;
+    }, import("zod/v4/core").$strip>], "status">;
+  }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strict>, "UNAUTHENTICATED" | "INVALID_SELECTOR" | "CONNECTION_AMBIGUOUS", "projectId" | "providerConfigId" | "connectionName", import("@fragno-dev/db").DatabaseRequestContext<{
+  onConnectionReadinessChanged: import("@fragno-dev/db").HookFn<ProjectConnectorConnectionReadinessChangedPayload>;
+}>>, import("@fragno-dev/core").FragnoRouteConfig<"POST", "/connection-requests/:requestId/refresh", import("@standard-schema/spec").StandardSchemaV1<unknown, unknown> | undefined, import("zod").ZodObject<{
+  id: import("zod").ZodString;
+  projectId: import("zod").ZodString;
+  providerConfigId: import("zod").ZodString;
+  externalUserId: import("zod").ZodString;
+  service: import("zod").ZodString;
+  connectionName: import("zod").ZodString;
+  authorizationUrl: import("zod").ZodURL;
+  expiresAt: import("zod").ZodString;
+  state: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+    status: import("zod").ZodLiteral<"initiated">;
+  }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    status: import("zod").ZodLiteral<"connected">;
+    connectedAccountId: import("zod").ZodString;
+  }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    status: import("zod").ZodLiteral<"failed">;
+    errorCode: import("zod").ZodNullable<import("zod").ZodString>;
+    errorMessage: import("zod").ZodNullable<import("zod").ZodString>;
+  }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    status: import("zod").ZodLiteral<"expired">;
+  }, import("zod/v4/core").$strip>], "status">;
+}, import("zod/v4/core").$strip>, "UNAUTHENTICATED" | "PROJECT_CONNECTOR_ERROR" | "REQUEST_NOT_FOUND", string, import("@fragno-dev/db").DatabaseRequestContext<{
+  onConnectionReadinessChanged: import("@fragno-dev/db").HookFn<ProjectConnectorConnectionReadinessChangedPayload>;
+}>>, import("@fragno-dev/core").FragnoRouteConfig<"GET", "/accounts", import("@standard-schema/spec").StandardSchemaV1<unknown, unknown> | undefined, import("zod").ZodObject<{
+  accounts: import("zod").ZodArray<import("zod").ZodObject<{
+    id: import("zod").ZodString;
+    projectId: import("zod").ZodString;
+    providerConfigId: import("zod").ZodString;
+    externalUserId: import("zod").ZodString;
+    service: import("zod").ZodString;
+    connectionName: import("zod").ZodString;
+  }, import("zod/v4/core").$strip>>;
+  cursor: import("zod").ZodNullable<import("zod").ZodString>;
+  hasNextPage: import("zod").ZodBoolean;
+}, import("zod/v4/core").$strip>, "UNAUTHENTICATED" | "INVALID_CURSOR", "cursor", import("@fragno-dev/db").DatabaseRequestContext<{
+  onConnectionReadinessChanged: import("@fragno-dev/db").HookFn<ProjectConnectorConnectionReadinessChangedPayload>;
+}>>, import("@fragno-dev/core").FragnoRouteConfig<"GET", "/accounts/by-name", import("@standard-schema/spec").StandardSchemaV1<unknown, unknown> | undefined, import("zod").ZodObject<{
+  account: import("zod").ZodNullable<import("zod").ZodObject<{
+    id: import("zod").ZodString;
+    projectId: import("zod").ZodString;
+    providerConfigId: import("zod").ZodString;
+    externalUserId: import("zod").ZodString;
+    service: import("zod").ZodString;
+    connectionName: import("zod").ZodString;
+  }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strict>, "UNAUTHENTICATED" | "INVALID_SELECTOR" | "CONNECTION_AMBIGUOUS", "projectId" | "providerConfigId" | "connectionName", import("@fragno-dev/db").DatabaseRequestContext<{
+  onConnectionReadinessChanged: import("@fragno-dev/db").HookFn<ProjectConnectorConnectionReadinessChangedPayload>;
+}>>, import("@fragno-dev/core").FragnoRouteConfig<"GET", "/accounts/:accountId/profile", import("@standard-schema/spec").StandardSchemaV1<unknown, unknown> | undefined, import("zod").ZodObject<{
+  connectedAccountId: import("zod").ZodString;
+  externalUserId: import("zod").ZodString;
+  service: import("zod").ZodString;
+  profile: import("zod").ZodObject<{
+    id: import("zod").ZodString;
+    kind: import("zod").ZodString;
+    username: import("zod").ZodNullable<import("zod").ZodString>;
+    displayName: import("zod").ZodNullable<import("zod").ZodString>;
+    avatarUrl: import("zod").ZodNullable<import("zod").ZodString>;
+    email: import("zod").ZodNullable<import("zod").ZodString>;
+    metadata: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+  }, import("zod/v4/core").$strip>;
+  fetchedAt: import("zod").ZodNumber;
+}, import("zod/v4/core").$strip>, "UNAUTHENTICATED" | "PROJECT_CONNECTOR_ERROR" | "ACCOUNT_NOT_FOUND", string, import("@fragno-dev/db").DatabaseRequestContext<{
+  onConnectionReadinessChanged: import("@fragno-dev/db").HookFn<ProjectConnectorConnectionReadinessChangedPayload>;
+}>>, import("@fragno-dev/core").FragnoRouteConfig<"POST", "/accounts/:accountId/actions/:actionId", import("zod").ZodObject<{
+  input: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+}, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+  executionId: import("zod").ZodString;
+  actionId: import("zod").ZodString;
+  output: import("zod").ZodUnknown & import("zod").ZodType<{} | null, unknown, import("zod/v4/core").$ZodTypeInternals<{} | null, unknown>>;
+}, import("zod/v4/core").$strip>, "UNAUTHENTICATED" | "PROJECT_CONNECTOR_ERROR" | "ACCOUNT_NOT_FOUND" | "ACTION_SERVICE_MISMATCH", string, import("@fragno-dev/db").DatabaseRequestContext<{
+  onConnectionReadinessChanged: import("@fragno-dev/db").HookFn<ProjectConnectorConnectionReadinessChangedPayload>;
+}>>], {
+  projectConnector: {
+    listProviderConfigs(): Promise<{
+      projectId: string;
+      providerConfigs: {
+        id: string;
+        service: string;
+        displayName: string;
+        callbackUrl: string;
+        effectiveScopes: string[];
+        proxyAvailable: boolean;
+      }[];
+    }>;
+    listProviderActions(providerConfigId: string): Promise<{
+      projectId: string;
+      providerConfigId: string;
+      actions: {
+        id: string;
+        service: string;
+        name: string;
+        description: string | null;
+        inputSchema: Record<string, unknown>;
+        outputSchema: Record<string, unknown>;
+      }[];
+    } | null>;
+    check(): Promise<{
+      authenticated: true;
+    }>;
+    connect(externalUserId: string, input: import("zod").infer<typeof projectConnectorConnectInputSchema>): Promise<{
+      id: string;
+      projectId: string;
+      providerConfigId: string;
+      externalUserId: string;
+      service: string;
+      connectionName: string | null;
+      authorizationUrl: string;
+      expiresAt: string;
+    } & ({
+      status: "initiated";
+    } | {
+      status: "connected";
+      connectedAccountId: string;
+    } | {
+      status: "failed";
+      errorCode: string | null;
+      errorMessage: string | null;
+    } | {
+      status: "expired";
+    })>;
+    getConnectionRequest(requestId: string): Promise<{
+      id: string;
+      projectId: string;
+      providerConfigId: string;
+      externalUserId: string;
+      service: string;
+      connectionName: string | null;
+      authorizationUrl: string;
+      expiresAt: string;
+    } & ({
+      status: "initiated";
+    } | {
+      status: "connected";
+      connectedAccountId: string;
+    } | {
+      status: "failed";
+      errorCode: string | null;
+      errorMessage: string | null;
+    } | {
+      status: "expired";
+    })>;
+    getProfile(accountId: string): Promise<{
+      connectedAccountId: string;
+      externalUserId: string;
+      service: string;
+      profile: {
+        id: string;
+        kind: string;
+        username: string | null;
+        displayName: string | null;
+        avatarUrl: string | null;
+        email: string | null;
+        metadata: Record<string, unknown>;
+      };
+      fetchedAt: number;
+    }>;
+    execute(account: {
+      externalUserId: string;
+      providerConfigId: string;
+      id: string;
+    }, actionId: string, input: Record<string, unknown>): Promise<{
+      executionId: string;
+      actionId: string;
+      output: {} | null;
+    }>;
+  };
+} & import("@fragno-dev/db").ImplicitDatabaseDependencies<import("@fragno-dev/db/schema").Schema<{
+  connectionRequest: import("@fragno-dev/db/schema").Table<{
+    id: import("@fragno-dev/db/schema").IdColumn<"varchar(128)", string | import("@fragno-dev/db/schema").FragnoId | null, import("@fragno-dev/db/schema").FragnoId>;
+    projectId: import("@fragno-dev/db/schema").Column<"string", string, string>;
+    providerConfigId: import("@fragno-dev/db/schema").Column<"string", string, string>;
+    externalUserId: import("@fragno-dev/db/schema").Column<"string", string, string>;
+    service: import("@fragno-dev/db/schema").Column<"string", string, string>;
+    authorizationUrl: import("@fragno-dev/db/schema").Column<"text", string, string>;
+    expiresAt: import("@fragno-dev/db/schema").Column<"string", string, string>;
+    state: import("@fragno-dev/db/schema").Column<"json", {
+      status: "initiated";
+    } | {
+      status: "connected";
+      connectedAccountId: string;
+    } | {
+      status: "failed";
+      errorCode: string | null;
+      errorMessage: string | null;
+    } | {
+      status: "expired";
+    }, {
+      status: "initiated";
+    } | {
+      status: "connected";
+      connectedAccountId: string;
+    } | {
+      status: "failed";
+      errorCode: string | null;
+      errorMessage: string | null;
+    } | {
+      status: "expired";
+    }>;
+    connectionName: import("@fragno-dev/db/schema").Column<"string", string, string>;
+  }, Record<"idx_request_named_connection", import("@fragno-dev/db/schema").Index<readonly [import("@fragno-dev/db/schema").Column<"string", string, string>, import("@fragno-dev/db/schema").Column<"string", string, string>, import("@fragno-dev/db/schema").Column<"string", string, string>, import("@fragno-dev/db/schema").Column<"string", string | null, string | null>] & import("@fragno-dev/db/schema").AnyColumn[], readonly ["externalUserId", "projectId", "providerConfigId", "connectionName"]>>>;
+  connectedAccount: import("@fragno-dev/db/schema").Table<{
+    id: import("@fragno-dev/db/schema").IdColumn<"varchar(128)", string | import("@fragno-dev/db/schema").FragnoId | null, import("@fragno-dev/db/schema").FragnoId>;
+    projectId: import("@fragno-dev/db/schema").Column<"string", string, string>;
+    providerConfigId: import("@fragno-dev/db/schema").Column<"string", string, string>;
+    externalUserId: import("@fragno-dev/db/schema").Column<"string", string, string>;
+    service: import("@fragno-dev/db/schema").Column<"string", string, string>;
+    connectionName: import("@fragno-dev/db/schema").Column<"string", string, string>;
+  }, Record<"idx_account_external_user_id", import("@fragno-dev/db/schema").Index<readonly [import("@fragno-dev/db/schema").Column<"string", string, string>, import("@fragno-dev/db/schema").IdColumn<"varchar(128)", string | import("@fragno-dev/db/schema").FragnoId | null, import("@fragno-dev/db/schema").FragnoId>] & import("@fragno-dev/db/schema").AnyColumn[], readonly ["externalUserId", "id"]>> & Record<"idx_account_named_connection", import("@fragno-dev/db/schema").Index<readonly [import("@fragno-dev/db/schema").Column<"string", string, string>, import("@fragno-dev/db/schema").Column<"string", string, string>, import("@fragno-dev/db/schema").Column<"string", string, string>, import("@fragno-dev/db/schema").Column<"string", string | null, string | null>] & import("@fragno-dev/db/schema").AnyColumn[], readonly ["externalUserId", "projectId", "providerConfigId", "connectionName"]>>>;
+}>>, import("@fragno-dev/core").BoundServices<{}>, import("@fragno-dev/db").DatabaseServiceContext<{
+  onConnectionReadinessChanged: import("@fragno-dev/db").HookFn<ProjectConnectorConnectionReadinessChangedPayload>;
+}>, import("@fragno-dev/db").DatabaseRequestContext<{
+  onConnectionReadinessChanged: import("@fragno-dev/db").HookFn<ProjectConnectorConnectionReadinessChangedPayload>;
+}>, import("@fragno-dev/db/fragment-definition-builder").DatabaseRequestStorage, FragnoPublicConfigWithDatabase, never>;
+/** Discover project OAuth configurations and select only server-verified accounts for actions. */
+declare function createProjectConnectorFragmentClients(fragnoConfig?: FragnoPublicClientConfig): {
+  useProviderConfigs: import("@fragno-dev/core/client").FragnoClientHookData<"GET", "/provider-configs", import("zod").ZodObject<{
+    projectId: import("zod").ZodString;
+    providerConfigs: import("zod").ZodArray<import("zod").ZodObject<{
+      id: import("zod").ZodString;
+      service: import("zod").ZodString;
+      displayName: import("zod").ZodString;
+      callbackUrl: import("zod").ZodURL;
+      effectiveScopes: import("zod").ZodArray<import("zod").ZodString>;
+      proxyAvailable: import("zod").ZodBoolean;
+    }, import("zod/v4/core").$strip>>;
+  }, import("zod/v4/core").$strip>, "UNAUTHENTICATED" | "PROJECT_CONNECTOR_ERROR", string>;
+  useProviderActions: import("@fragno-dev/core/client").FragnoClientHookData<"GET", "/provider-configs/:providerConfigId/actions", import("zod").ZodObject<{
+    projectId: import("zod").ZodString;
+    providerConfigId: import("zod").ZodString;
+    actions: import("zod").ZodArray<import("zod").ZodObject<{
+      id: import("zod").ZodString;
+      service: import("zod").ZodString;
+      name: import("zod").ZodString;
+      description: import("zod").ZodNullable<import("zod").ZodString>;
+      inputSchema: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+      outputSchema: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+    }, import("zod/v4/core").$strip>>;
+  }, import("zod/v4/core").$strip>, "UNAUTHENTICATED" | "PROJECT_CONNECTOR_ERROR" | "PROVIDER_CONFIG_NOT_FOUND", string>;
+  useStatus: import("@fragno-dev/core/client").FragnoClientHookData<"GET", "/status", import("zod").ZodObject<{
+    authenticated: import("zod").ZodLiteral<true>;
+  }, import("zod/v4/core").$strip>, "UNAUTHENTICATED" | "PROJECT_CONNECTOR_ERROR", string>;
+  useAccounts: import("@fragno-dev/core/client").FragnoClientHookData<"GET", "/accounts", import("zod").ZodObject<{
+    accounts: import("zod").ZodArray<import("zod").ZodObject<{
+      id: import("zod").ZodString;
+      projectId: import("zod").ZodString;
+      providerConfigId: import("zod").ZodString;
+      externalUserId: import("zod").ZodString;
+      service: import("zod").ZodString;
+      connectionName: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    cursor: import("zod").ZodNullable<import("zod").ZodString>;
+    hasNextPage: import("zod").ZodBoolean;
+  }, import("zod/v4/core").$strip>, "UNAUTHENTICATED" | "INVALID_CURSOR", "cursor">;
+  useNamedAccount: import("@fragno-dev/core/client").FragnoClientHookData<"GET", "/accounts/by-name", import("zod").ZodObject<{
+    account: import("zod").ZodNullable<import("zod").ZodObject<{
+      id: import("zod").ZodString;
+      projectId: import("zod").ZodString;
+      providerConfigId: import("zod").ZodString;
+      externalUserId: import("zod").ZodString;
+      service: import("zod").ZodString;
+      connectionName: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+  }, import("zod/v4/core").$strict>, "UNAUTHENTICATED" | "INVALID_SELECTOR" | "CONNECTION_AMBIGUOUS", "projectId" | "providerConfigId" | "connectionName">;
+  useNamedConnectionRequest: import("@fragno-dev/core/client").FragnoClientHookData<"GET", "/connection-requests/by-name", import("zod").ZodObject<{
+    request: import("zod").ZodNullable<import("zod").ZodObject<{
+      id: import("zod").ZodString;
+      projectId: import("zod").ZodString;
+      providerConfigId: import("zod").ZodString;
+      externalUserId: import("zod").ZodString;
+      service: import("zod").ZodString;
+      connectionName: import("zod").ZodString;
+      authorizationUrl: import("zod").ZodURL;
+      expiresAt: import("zod").ZodString;
+      state: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+        status: import("zod").ZodLiteral<"initiated">;
+      }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        status: import("zod").ZodLiteral<"connected">;
+        connectedAccountId: import("zod").ZodString;
+      }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        status: import("zod").ZodLiteral<"failed">;
+        errorCode: import("zod").ZodNullable<import("zod").ZodString>;
+        errorMessage: import("zod").ZodNullable<import("zod").ZodString>;
+      }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        status: import("zod").ZodLiteral<"expired">;
+      }, import("zod/v4/core").$strip>], "status">;
+    }, import("zod/v4/core").$strip>>;
+  }, import("zod/v4/core").$strict>, "UNAUTHENTICATED" | "INVALID_SELECTOR" | "CONNECTION_AMBIGUOUS", "projectId" | "providerConfigId" | "connectionName">;
+  useProfile: import("@fragno-dev/core/client").FragnoClientHookData<"GET", "/accounts/:accountId/profile", import("zod").ZodObject<{
+    connectedAccountId: import("zod").ZodString;
+    externalUserId: import("zod").ZodString;
+    service: import("zod").ZodString;
+    profile: import("zod").ZodObject<{
+      id: import("zod").ZodString;
+      kind: import("zod").ZodString;
+      username: import("zod").ZodNullable<import("zod").ZodString>;
+      displayName: import("zod").ZodNullable<import("zod").ZodString>;
+      avatarUrl: import("zod").ZodNullable<import("zod").ZodString>;
+      email: import("zod").ZodNullable<import("zod").ZodString>;
+      metadata: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+    }, import("zod/v4/core").$strip>;
+    fetchedAt: import("zod").ZodNumber;
+  }, import("zod/v4/core").$strip>, "UNAUTHENTICATED" | "PROJECT_CONNECTOR_ERROR" | "ACCOUNT_NOT_FOUND", string>;
+  connect: import("@fragno-dev/core/client").FragnoClientMutatorData<import("@fragno-dev/core/api").NonGetHTTPMethod, "/connection-requests", import("zod").ZodUnion<readonly [import("zod").ZodObject<{
+    service: import("zod").ZodString;
+    connectionName: import("zod").ZodString;
+    returnUri: import("zod").ZodURL;
+  }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+    providerConfigId: import("zod").ZodString;
+    connectionName: import("zod").ZodString;
+    returnUri: import("zod").ZodURL;
+  }, import("zod/v4/core").$strict>]> | undefined, import("zod").ZodObject<{
+    id: import("zod").ZodString;
+    projectId: import("zod").ZodString;
+    providerConfigId: import("zod").ZodString;
+    externalUserId: import("zod").ZodString;
+    service: import("zod").ZodString;
+    connectionName: import("zod").ZodString;
+    authorizationUrl: import("zod").ZodURL;
+    expiresAt: import("zod").ZodString;
+    state: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+      status: import("zod").ZodLiteral<"initiated">;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+      status: import("zod").ZodLiteral<"connected">;
+      connectedAccountId: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+      status: import("zod").ZodLiteral<"failed">;
+      errorCode: import("zod").ZodNullable<import("zod").ZodString>;
+      errorMessage: import("zod").ZodNullable<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+      status: import("zod").ZodLiteral<"expired">;
+    }, import("zod/v4/core").$strip>], "status">;
+  }, import("zod/v4/core").$strip> | undefined, "UNAUTHENTICATED" | "PROJECT_CONNECTOR_ERROR" | "RETURN_URI_NOT_ALLOWED", string>;
+  refreshConnection: import("@fragno-dev/core/client").FragnoClientMutatorData<import("@fragno-dev/core/api").NonGetHTTPMethod, "/connection-requests/:requestId/refresh", import("@standard-schema/spec").StandardSchemaV1<unknown, unknown> | undefined, import("zod").ZodObject<{
+    id: import("zod").ZodString;
+    projectId: import("zod").ZodString;
+    providerConfigId: import("zod").ZodString;
+    externalUserId: import("zod").ZodString;
+    service: import("zod").ZodString;
+    connectionName: import("zod").ZodString;
+    authorizationUrl: import("zod").ZodURL;
+    expiresAt: import("zod").ZodString;
+    state: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+      status: import("zod").ZodLiteral<"initiated">;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+      status: import("zod").ZodLiteral<"connected">;
+      connectedAccountId: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+      status: import("zod").ZodLiteral<"failed">;
+      errorCode: import("zod").ZodNullable<import("zod").ZodString>;
+      errorMessage: import("zod").ZodNullable<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+      status: import("zod").ZodLiteral<"expired">;
+    }, import("zod/v4/core").$strip>], "status">;
+  }, import("zod/v4/core").$strip> | undefined, "UNAUTHENTICATED" | "PROJECT_CONNECTOR_ERROR" | "REQUEST_NOT_FOUND", string>;
+  executeAction: import("@fragno-dev/core/client").FragnoClientMutatorData<import("@fragno-dev/core/api").NonGetHTTPMethod, "/accounts/:accountId/actions/:actionId", import("zod").ZodObject<{
+    input: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+  }, import("zod/v4/core").$strict> | undefined, import("zod").ZodObject<{
+    executionId: import("zod").ZodString;
+    actionId: import("zod").ZodString;
+    output: import("zod").ZodUnknown & import("zod").ZodType<{} | null, unknown, import("zod/v4/core").$ZodTypeInternals<{} | null, unknown>>;
+  }, import("zod/v4/core").$strip> | undefined, "UNAUTHENTICATED" | "PROJECT_CONNECTOR_ERROR" | "ACCOUNT_NOT_FOUND" | "ACTION_SERVICE_MISMATCH", string>;
+};
+//#endregion
+export { createProjectConnectorFragment, createProjectConnectorFragmentClients };
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/index.ts"],"mappings":";;;;;;iBAcgB,+BACd,QAAQ,gCACR,cAAc,4DAA8B,gEAAA,8EAAA,8DAAA;;;;;;;;;;;gEAA9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAUA,sCAAsC,eAAc"}

package/dist/node/index.js

@@ -0,0 +1,36 @@
+import { projectConnectorFragmentDefinition } from "./definition.js";
+import { projectConnectorRoutes } from "./routes.js";
+import { createClientBuilder } from "@fragno-dev/core/client";
+import { instantiate } from "@fragno-dev/core";
+//#region src/index.ts
+const routes = [projectConnectorRoutes];
+/** Creates a project-scoped connector with integrator-owned user authentication. */
+function createProjectConnectorFragment(config, fragnoConfig) {
+	return instantiate(projectConnectorFragmentDefinition).withConfig(config).withRoutes(routes).withOptions(fragnoConfig).build();
+}
+/** Discover project OAuth configurations and select only server-verified accounts for actions. */
+function createProjectConnectorFragmentClients(fragnoConfig = {}) {
+	const builder = createClientBuilder(projectConnectorFragmentDefinition, fragnoConfig, routes);
+	return {
+		useProviderConfigs: builder.createHook("/provider-configs"),
+		useProviderActions: builder.createHook("/provider-configs/:providerConfigId/actions"),
+		useStatus: builder.createHook("/status"),
+		useAccounts: builder.createHook("/accounts"),
+		useNamedAccount: builder.createHook("/accounts/by-name"),
+		useNamedConnectionRequest: builder.createHook("/connection-requests/by-name"),
+		useProfile: builder.createHook("/accounts/:accountId/profile"),
+		connect: builder.createMutator("POST", "/connection-requests", (invalidate) => {
+			invalidate("GET", "/connection-requests/by-name", {});
+		}),
+		refreshConnection: builder.createMutator("POST", "/connection-requests/:requestId/refresh", (invalidate) => {
+			invalidate("GET", "/accounts", {});
+			invalidate("GET", "/accounts/by-name", {});
+			invalidate("GET", "/connection-requests/by-name", {});
+		}),
+		executeAction: builder.createMutator("POST", "/accounts/:accountId/actions/:actionId")
+	};
+}
+//#endregion
+export { createProjectConnectorFragment, createProjectConnectorFragmentClients };
+
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/index.ts"],"sourcesContent":["import { createClientBuilder, type FragnoPublicClientConfig } from \"@fragno-dev/core/client\";\n\nimport { instantiate } from \"@fragno-dev/core\";\nimport type { FragnoPublicConfigWithDatabase } from \"@fragno-dev/db\";\n\nimport {\n  projectConnectorFragmentDefinition,\n  type ProjectConnectorFragmentConfig,\n} from \"./definition\";\nimport { projectConnectorRoutes } from \"./routes\";\n\nconst routes = [projectConnectorRoutes] as const;\n\n/** Creates a project-scoped connector with integrator-owned user authentication. */\nexport function createProjectConnectorFragment(\n  config: ProjectConnectorFragmentConfig,\n  fragnoConfig: FragnoPublicConfigWithDatabase,\n) {\n  return instantiate(projectConnectorFragmentDefinition)\n    .withConfig(config)\n    .withRoutes(routes)\n    .withOptions(fragnoConfig)\n    .build();\n}\n\n/** Discover project OAuth configurations and select only server-verified accounts for actions. */\nexport function createProjectConnectorFragmentClients(fragnoConfig: FragnoPublicClientConfig = {}) {\n  const builder = createClientBuilder(projectConnectorFragmentDefinition, fragnoConfig, routes);\n  return {\n    useProviderConfigs: builder.createHook(\"/provider-configs\"),\n    useProviderActions: builder.createHook(\"/provider-configs/:providerConfigId/actions\"),\n    useStatus: builder.createHook(\"/status\"),\n    useAccounts: builder.createHook(\"/accounts\"),\n    useNamedAccount: builder.createHook(\"/accounts/by-name\"),\n    useNamedConnectionRequest: builder.createHook(\"/connection-requests/by-name\"),\n    useProfile: builder.createHook(\"/accounts/:accountId/profile\"),\n    connect: builder.createMutator(\"POST\", \"/connection-requests\", (invalidate) => {\n      invalidate(\"GET\", \"/connection-requests/by-name\", {});\n    }),\n    refreshConnection: builder.createMutator(\n      \"POST\",\n      \"/connection-requests/:requestId/refresh\",\n      (invalidate) => {\n        invalidate(\"GET\", \"/accounts\", {});\n        invalidate(\"GET\", \"/accounts/by-name\", {});\n        invalidate(\"GET\", \"/connection-requests/by-name\", {});\n      },\n    ),\n    executeAction: builder.createMutator(\"POST\", \"/accounts/:accountId/actions/:actionId\"),\n  };\n}\n"],"mappings":";;;;;AAWA,MAAM,SAAS,CAAC,sBAAsB;;AAGtC,SAAgB,+BACd,QACA,cACA;CACA,OAAO,YAAY,kCAAkC,CAAC,CACnD,WAAW,MAAM,CAAC,CAClB,WAAW,MAAM,CAAC,CAClB,YAAY,YAAY,CAAC,CACzB,MAAM;AACX;;AAGA,SAAgB,sCAAsC,eAAyC,CAAC,GAAG;CACjG,MAAM,UAAU,oBAAoB,oCAAoC,cAAc,MAAM;CAC5F,OAAO;EACL,oBAAoB,QAAQ,WAAW,mBAAmB;EAC1D,oBAAoB,QAAQ,WAAW,6CAA6C;EACpF,WAAW,QAAQ,WAAW,SAAS;EACvC,aAAa,QAAQ,WAAW,WAAW;EAC3C,iBAAiB,QAAQ,WAAW,mBAAmB;EACvD,2BAA2B,QAAQ,WAAW,8BAA8B;EAC5E,YAAY,QAAQ,WAAW,8BAA8B;EAC7D,SAAS,QAAQ,cAAc,QAAQ,yBAAyB,eAAe;GAC7E,WAAW,OAAO,gCAAgC,CAAC,CAAC;EACtD,CAAC;EACD,mBAAmB,QAAQ,cACzB,QACA,4CACC,eAAe;GACd,WAAW,OAAO,aAAa,CAAC,CAAC;GACjC,WAAW,OAAO,qBAAqB,CAAC,CAAC;GACzC,WAAW,OAAO,gCAAgC,CAAC,CAAC;EACtD,CACF;EACA,eAAe,QAAQ,cAAc,QAAQ,wCAAwC;CACvF;AACF"}

package/dist/node/project-connector-client.d.ts

@@ -0,0 +1,13 @@
+import "./project-connector-contracts.js";
+import { z } from "zod";
+import "@oomol-lab/connector";
+//#region src/project-connector-client.d.ts
+/** Server-only gateway credentials; null catalogApiKey disables action discovery, not account operations. */
+type ProjectConnectorClientConfig = {
+  baseUrl: string;
+  apiKey: string;
+  catalogApiKey: string | null;
+};
+//#endregion
+export { ProjectConnectorClientConfig };
+//# sourceMappingURL=project-connector-client.d.ts.map

package/dist/node/project-connector-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-connector-client.d.ts","names":[],"sources":["../../src/project-connector-client.ts"],"mappings":";;;;;KAmFY;EACV;EACA;EACA"}