@opengeni/db 0.16.2 → 0.18.1

package/dist/index.d.ts

@@ -680,9 +680,28 @@ export type CreateSocialConnectionInput = {
     status: SocialConnectionStatus;
     scopes?: string[];
     credentialRef?: string | null;
+    credentialEncrypted?: string | null;
     tokenMetadata?: Record<string, unknown>;
     metadata?: Record<string, unknown>;
 };
+export type UpsertSocialOAuthConnectionInput = {
+    accountId: string;
+    workspaceId: string;
+    provider: SocialProvider;
+    accountHandle: string;
+    accountName?: string | null;
+    externalAccountId?: string | null;
+    scopes: string[];
+    credentialEncrypted: string;
+    tokenMetadata?: Record<string, unknown>;
+};
+export type UpdateSocialConnectionCredentialInput = {
+    workspaceId: string;
+    connectionId: string;
+    credentialEncrypted?: string | null;
+    status?: SocialConnectionStatus;
+    tokenMetadata?: Record<string, unknown>;
+};
 export type CreateSocialPostInput = {
     accountId: string;
     workspaceId: string;
@@ -1135,6 +1154,173 @@ export declare function listConnectionsMetadata(db: Database, workspaceId: strin
 export declare function getConnectionMetadata(db: Database, workspaceId: string, connectionId: string, subjectId?: string | null): Promise<ConnectionMetadataWithVerification | null>;
 export declare function updateConnection(db: Database, input: UpdateConnectionInput): Promise<ConnectionMetadataWithVerification | null>;
 export declare function revokeConnection(db: Database, workspaceId: string, connectionId: string, updatedBySubjectId?: string | null): Promise<ConnectionMetadataWithVerification | null>;
+export type SlackInstallationRoute = {
+    accountId: string;
+    workspaceId: string;
+    connectionId: string;
+    botId: string;
+    botUserId: string;
+};
+export type SlackBotUserLink = {
+    id: string;
+    accountId: string;
+    workspaceId: string;
+    connectionId: string;
+    slackTeamId: string;
+    slackUserId: string;
+    subjectId: string;
+    linkedBySubjectId: string;
+    createdAt: Date;
+    updatedAt: Date;
+};
+export type SlackInteractionTriggerKind = "app_mention" | "dm" | "slash_command" | "message_shortcut" | "thread_reply";
+export type SlackInteractionInboxEntry = {
+    id: string;
+    accountId: string;
+    workspaceId: string;
+    connectionId: string;
+    providerEventId: string;
+    providerMessageId: string;
+    slackTeamId: string;
+    slackUserId: string;
+    slackChannelId: string;
+    slackMessageTs: string;
+    slackThreadTs: string | null;
+    triggerKind: SlackInteractionTriggerKind;
+    text: string;
+    status: "pending" | "processing" | "processed" | "failed";
+    claimHolderId: string | null;
+    claimExpiresAt: Date | null;
+    attemptCount: number;
+    retryAt: Date | null;
+    lastErrorCode: string | null;
+    processedAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+};
+export type SlackInteraction = {
+    id: string;
+    accountId: string;
+    workspaceId: string;
+    connectionId: string;
+    slackTeamId: string;
+    slackChannelId: string;
+    slackThreadTs: string;
+    routeKey: string;
+    triggeringProviderEventId: string;
+    owningSubjectId: string;
+    visibility: "private" | "workspace";
+    sessionReservationId: string;
+    sessionId: string | null;
+    lastDeliveredSessionEventSequence: number;
+    deliveryClaimHolderId: string | null;
+    deliveryClaimExpiresAt: Date | null;
+    deliveryAttemptCount: number;
+    deliveryRetryAt: Date | null;
+    deliveryLastErrorCode: string | null;
+    ackSlackMessageTs: string | null;
+    progressCount: number;
+    terminalDeliveryState: "open" | "completed" | "failed" | "cancelled" | "blocked";
+    createdAt: Date;
+    updatedAt: Date;
+};
+export type SlackInteractionProgressDelivery = {
+    id: string;
+    accountId: string;
+    workspaceId: string;
+    interactionId: string;
+    sessionEventSequence: number;
+    slot: number;
+    operationId: string;
+    createdAt: Date;
+};
+export declare function resolveSlackInstallationRoute(db: Database, slackTeamId: string): Promise<SlackInstallationRoute | null>;
+export declare function saveSlackBotUserLink(db: Database, input: Omit<SlackBotUserLink, "id" | "createdAt" | "updatedAt">): Promise<SlackBotUserLink>;
+export declare function getSlackBotUserLink(db: Database, workspaceId: string, connectionId: string, slackUserId: string): Promise<SlackBotUserLink | null>;
+export declare function deleteSlackBotUserLink(db: Database, workspaceId: string, connectionId: string, slackUserId: string): Promise<boolean>;
+export declare function enqueueSlackInteractionInbox(db: Database, input: Omit<SlackInteractionInboxEntry, "id" | "status" | "claimHolderId" | "claimExpiresAt" | "attemptCount" | "retryAt" | "lastErrorCode" | "processedAt" | "createdAt" | "updatedAt">): Promise<{
+    inserted: boolean;
+    entry: SlackInteractionInboxEntry;
+}>;
+export declare function claimSlackInteractionInbox(db: Database, claimHolderId: string, claimLeaseMs: number): Promise<SlackInteractionInboxEntry | null>;
+export declare function settleSlackInteractionInbox(db: Database, input: {
+    entry: Pick<SlackInteractionInboxEntry, "id" | "accountId" | "workspaceId">;
+    claimHolderId: string;
+    outcome: "processed" | "failed";
+    errorCode?: string | null;
+}): Promise<boolean>;
+export declare function releaseSlackInteractionInbox(db: Database, input: {
+    entry: Pick<SlackInteractionInboxEntry, "id" | "accountId" | "workspaceId">;
+    claimHolderId: string;
+    errorCode: string;
+    retryAt: Date;
+}): Promise<boolean>;
+export declare function getOrCreateSlackInteraction(db: Database, input: Omit<SlackInteraction, "id" | "sessionReservationId" | "sessionId" | "lastDeliveredSessionEventSequence" | "deliveryClaimHolderId" | "deliveryClaimExpiresAt" | "deliveryAttemptCount" | "deliveryRetryAt" | "deliveryLastErrorCode" | "ackSlackMessageTs" | "progressCount" | "terminalDeliveryState" | "createdAt" | "updatedAt">): Promise<{
+    created: boolean;
+    interaction: SlackInteraction;
+}>;
+export declare function getSlackInteractionByRoute(db: Database, workspaceId: string, connectionId: string, routeKey: string): Promise<SlackInteraction | null>;
+export declare function getSlackInteractionSessionAccess(db: Database, workspaceId: string, rootSessionId: string): Promise<Pick<SlackInteraction, "owningSubjectId" | "visibility"> | null>;
+export declare function getSlackInteractionSessionAccessForSession(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    sessionId: string;
+}): Promise<(Pick<SlackInteraction, "owningSubjectId" | "visibility"> & {
+    rootSessionId: string;
+}) | null>;
+export declare function bindSlackInteractionSession(db: Database, input: Pick<SlackInteraction, "id" | "accountId" | "workspaceId" | "owningSubjectId"> & {
+    sessionId: string;
+}): Promise<SlackInteraction | null>;
+export type SlackInteractionProgressClaim = {
+    kind: "claimed";
+    created: boolean;
+    progressCount: number;
+    delivery: SlackInteractionProgressDelivery;
+} | {
+    kind: "limit_reached";
+    progressCount: number;
+} | {
+    kind: "not_owned";
+};
+/**
+ * Reserve one globally bounded progress slot before any Slack provider call.
+ * The interaction row lock serializes replicas and expired delivery claim
+ * successors; the event row preserves one operation UUID across every retry.
+ */
+export declare function claimSlackInteractionProgressDelivery(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    interactionId: string;
+    claimHolderId: string;
+    sessionEventSequence: number;
+    maxProgress: number;
+}): Promise<SlackInteractionProgressClaim>;
+export declare function rekeySlackInteractionRoute(db: Database, input: Pick<SlackInteraction, "id" | "accountId" | "workspaceId"> & {
+    routeKey: string;
+    slackThreadTs: string;
+    ackSlackMessageTs: string;
+}): Promise<SlackInteraction | null>;
+export declare function claimSlackInteractionDelivery(db: Database, claimHolderId: string, claimLeaseMs: number): Promise<SlackInteraction | null>;
+export declare function reopenSlackInteractionDelivery(db: Database, input: Pick<SlackInteraction, "id" | "accountId" | "workspaceId">): Promise<boolean>;
+export declare function advanceSlackInteractionDelivery(db: Database, input: Pick<SlackInteraction, "id" | "accountId" | "workspaceId"> & {
+    claimHolderId: string;
+    sequence: number;
+    ackSlackMessageTs?: string | null;
+}): Promise<boolean>;
+export declare function releaseSlackInteractionDelivery(db: Database, input: Pick<SlackInteraction, "id" | "accountId" | "workspaceId"> & {
+    claimHolderId: string;
+}): Promise<boolean>;
+export declare function deferSlackInteractionDelivery(db: Database, input: Pick<SlackInteraction, "id" | "accountId" | "workspaceId"> & {
+    claimHolderId: string;
+    retryAt: Date;
+    errorCode: string;
+}): Promise<boolean>;
+export declare function closeSlackInteractionDelivery(db: Database, input: Pick<SlackInteraction, "id" | "accountId" | "workspaceId"> & {
+    claimHolderId: string;
+    sequence: number;
+    state: Exclude<SlackInteraction["terminalDeliveryState"], "open">;
+    errorCode?: string | null;
+}): Promise<boolean>;
 export declare class SlackBotLifecycleSuccessAuditError extends Error {
     constructor();
 }
@@ -1370,10 +1556,48 @@ export declare function correctWorkspaceMemory(db: Database, input: CorrectWorks
 export declare function searchWorkspaceMemories(db: Database, workspaceId: string, input: WorkspaceMemorySearchInput, embedder?: MemoryEmbedder): Promise<WorkspaceMemorySearchResult[]>;
 export declare function resolveWorkspaceMemoryBlock(db: Database, workspaceId: string): Promise<string | null>;
 export declare function createSocialConnection(db: Database, input: CreateSocialConnectionInput): Promise<SocialConnection>;
+/**
+ * OAuth-callback persistence: reconnecting the same provider account replaces
+ * the stored credential and revives the connection instead of failing on the
+ * (workspace, provider, handle) unique index.
+ */
+export declare function upsertSocialOAuthConnection(db: Database, input: UpsertSocialOAuthConnectionInput): Promise<SocialConnection>;
+/**
+ * Host-side credential read for the social API client. Deliberately not part
+ * of mapSocialConnection so the encrypted bundle never rides along on list or
+ * MCP responses.
+ */
+export declare function loadSocialConnectionCredential(db: Database, workspaceId: string, connectionId: string): Promise<{
+    connection: SocialConnection;
+    credentialEncrypted: string | null;
+} | null>;
+export declare function updateSocialConnectionCredential(db: Database, input: UpdateSocialConnectionCredentialInput): Promise<SocialConnection | null>;
 export declare function listSocialConnections(db: Database, workspaceId: string, limit?: number): Promise<SocialConnection[]>;
 export declare function getSocialConnection(db: Database, workspaceId: string, connectionId: string): Promise<SocialConnection | null>;
 export declare function requireSocialConnection(db: Database, workspaceId: string, connectionId: string): Promise<SocialConnection>;
 export declare function createSocialPost(db: Database, input: CreateSocialPostInput): Promise<SocialPost>;
+/**
+ * Idempotent bulk ingest for provider sync: rows already present under the
+ * (workspace, connection, external post id) unique index are skipped, so a
+ * scheduled re-sync never duplicates or fails.
+ */
+export declare function recordSyncedSocialPosts(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    connectionId: string;
+    posts: Array<{
+        externalPostId: string;
+        url?: string | null;
+        authorHandle?: string | null;
+        text: string;
+        publishedAt: Date;
+        metrics?: Record<string, number>;
+        raw?: Record<string, unknown>;
+    }>;
+}): Promise<{
+    inserted: number;
+    skipped: number;
+}>;
 export declare function listSocialPosts(db: Database, options: {
     workspaceId: string;
     connectionIds?: string[];
@@ -6215,3 +6439,4 @@ export declare function appendSessionEventsWithLockedSessionUpdate(db: Database,
 export declare function sessionSubject(workspaceId: string, sessionId: string): string;
 export * from "./codex-token-resolver";
 export * from "./connection-token-resolver";
+export * from "./workspace-artifacts";