@opengeni/db 0.16.2 → 0.17.1

package/dist/index.d.ts

@@ -1135,6 +1135,162 @@ 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;
+    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;
+    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" | "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;
+}): Promise<boolean>;
+export declare function getOrCreateSlackInteraction(db: Database, input: Omit<SlackInteraction, "id" | "sessionReservationId" | "sessionId" | "lastDeliveredSessionEventSequence" | "deliveryClaimHolderId" | "deliveryClaimExpiresAt" | "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 closeSlackInteractionDelivery(db: Database, input: Pick<SlackInteraction, "id" | "accountId" | "workspaceId"> & {
+    claimHolderId: string;
+    sequence: number;
+    state: Exclude<SlackInteraction["terminalDeliveryState"], "open">;
+}): Promise<boolean>;
 export declare class SlackBotLifecycleSuccessAuditError extends Error {
     constructor();
 }
@@ -6215,3 +6371,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";