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

package/dist/node/routes.d.ts

@@ -0,0 +1,307 @@
+import { projectConnectorConnectInputSchema } from "./project-connector-contracts.js";
+import { ProjectConnectorClientConfig } from "./project-connector-client.js";
+import { ProjectConnectorConnectionReadinessChangedPayload } from "./definition.js";
+import { z } from "zod";
+//#region src/routes.d.ts
+/** Authenticated routes never accept a product user ID or account binding from the browser. */
+declare const projectConnectorRoutes: import("@fragno-dev/core").RouteFactory<ProjectConnectorClientConfig & {
+  getExternalUserId: (headers: Headers) => string | null | Promise<string | null>;
+  allowedReturnUrls: (url: URL) => boolean;
+  onConnectionReadinessChanged?: (payload: ProjectConnectorConnectionReadinessChangedPayload, context: import("@fragno-dev/db").HookContext) => Promise<void> | void;
+}, {
+  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: z.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<{}>, {}, readonly [import("@fragno-dev/core").FragnoRouteConfig<"GET", "/provider-configs", import("@standard-schema/spec").StandardSchemaV1<unknown, unknown> | undefined, z.ZodObject<{
+  projectId: z.ZodString;
+  providerConfigs: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    service: z.ZodString;
+    displayName: z.ZodString;
+    callbackUrl: z.ZodURL;
+    effectiveScopes: z.ZodArray<z.ZodString>;
+    proxyAvailable: z.ZodBoolean;
+  }, z.core.$strip>>;
+}, z.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, z.ZodObject<{
+  projectId: z.ZodString;
+  providerConfigId: z.ZodString;
+  actions: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    service: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    outputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  }, z.core.$strip>>;
+}, z.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, z.ZodObject<{
+  authenticated: z.ZodLiteral<true>;
+}, z.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", z.ZodUnion<readonly [z.ZodObject<{
+  service: z.ZodString;
+  connectionName: z.ZodString;
+  returnUri: z.ZodURL;
+}, z.core.$strict>, z.ZodObject<{
+  providerConfigId: z.ZodString;
+  connectionName: z.ZodString;
+  returnUri: z.ZodURL;
+}, z.core.$strict>]>, z.ZodObject<{
+  id: z.ZodString;
+  projectId: z.ZodString;
+  providerConfigId: z.ZodString;
+  externalUserId: z.ZodString;
+  service: z.ZodString;
+  connectionName: z.ZodString;
+  authorizationUrl: z.ZodURL;
+  expiresAt: z.ZodString;
+  state: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"initiated">;
+  }, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"connected">;
+    connectedAccountId: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"failed">;
+    errorCode: z.ZodNullable<z.ZodString>;
+    errorMessage: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"expired">;
+  }, z.core.$strip>], "status">;
+}, z.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, z.ZodObject<{
+  request: z.ZodNullable<z.ZodObject<{
+    id: z.ZodString;
+    projectId: z.ZodString;
+    providerConfigId: z.ZodString;
+    externalUserId: z.ZodString;
+    service: z.ZodString;
+    connectionName: z.ZodString;
+    authorizationUrl: z.ZodURL;
+    expiresAt: z.ZodString;
+    state: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      status: z.ZodLiteral<"initiated">;
+    }, z.core.$strip>, z.ZodObject<{
+      status: z.ZodLiteral<"connected">;
+      connectedAccountId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      status: z.ZodLiteral<"failed">;
+      errorCode: z.ZodNullable<z.ZodString>;
+      errorMessage: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      status: z.ZodLiteral<"expired">;
+    }, z.core.$strip>], "status">;
+  }, z.core.$strip>>;
+}, z.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, z.ZodObject<{
+  id: z.ZodString;
+  projectId: z.ZodString;
+  providerConfigId: z.ZodString;
+  externalUserId: z.ZodString;
+  service: z.ZodString;
+  connectionName: z.ZodString;
+  authorizationUrl: z.ZodURL;
+  expiresAt: z.ZodString;
+  state: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"initiated">;
+  }, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"connected">;
+    connectedAccountId: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"failed">;
+    errorCode: z.ZodNullable<z.ZodString>;
+    errorMessage: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"expired">;
+  }, z.core.$strip>], "status">;
+}, z.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, z.ZodObject<{
+  accounts: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    projectId: z.ZodString;
+    providerConfigId: z.ZodString;
+    externalUserId: z.ZodString;
+    service: z.ZodString;
+    connectionName: z.ZodString;
+  }, z.core.$strip>>;
+  cursor: z.ZodNullable<z.ZodString>;
+  hasNextPage: z.ZodBoolean;
+}, z.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, z.ZodObject<{
+  account: z.ZodNullable<z.ZodObject<{
+    id: z.ZodString;
+    projectId: z.ZodString;
+    providerConfigId: z.ZodString;
+    externalUserId: z.ZodString;
+    service: z.ZodString;
+    connectionName: z.ZodString;
+  }, z.core.$strip>>;
+}, z.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, z.ZodObject<{
+  connectedAccountId: z.ZodString;
+  externalUserId: z.ZodString;
+  service: z.ZodString;
+  profile: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodString;
+    username: z.ZodNullable<z.ZodString>;
+    displayName: z.ZodNullable<z.ZodString>;
+    avatarUrl: z.ZodNullable<z.ZodString>;
+    email: z.ZodNullable<z.ZodString>;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  }, z.core.$strip>;
+  fetchedAt: z.ZodNumber;
+}, z.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", z.ZodObject<{
+  input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>, z.ZodObject<{
+  executionId: z.ZodString;
+  actionId: z.ZodString;
+  output: z.ZodUnknown & z.ZodType<{} | null, unknown, z.core.$ZodTypeInternals<{} | null, unknown>>;
+}, z.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>;
+}>>]>;
+//#endregion
+export { projectConnectorRoutes };
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","names":[],"sources":["../../src/routes.ts"],"mappings":";;;;;;cA6Ca,mDAAsB,aAAtB"}