happy2 0.0.5

package/packages/happy2-server/dist/modules/operations/repository.d.ts

@@ -0,0 +1,215 @@
+import { type Client } from "@libsql/client";
+import type { RequestMetadata } from "../database.js";
+import { type AccountBan, type AuditLogEntry, type BackupRecord, type BackupStatus, type DataExportJob, type DataExportKind, type DataExportStatus, type ModerationAction, type ModerationActionKind, type ModerationReport, type ModerationReportStatus, type OperationsSyncHint, type Page, type RetentionRun, type RetentionScope, type UserAccessTelemetry } from "./types.js";
+interface AuditContext {
+    request?: RequestMetadata;
+    metadata?: Record<string, unknown>;
+}
+export interface ClaimedDataExport extends DataExportJob {
+    claimStartedAt: string;
+}
+/** Durable administrative and operational state. All authorization is rechecked in SQLite. */
+export declare class OperationsRepository {
+    private readonly client;
+    private readonly db;
+    private readonly ownsClient;
+    constructor(source: string | Client, authToken?: string);
+    close(): void;
+    listAuditLog(input: {
+        actorUserId: string;
+        action?: string;
+        targetType?: string;
+        targetId?: string;
+        auditedActorUserId?: string;
+        before?: string;
+        limit: number;
+    }): Promise<Page<AuditLogEntry>>;
+    applyBan(input: {
+        actorUserId: string;
+        targetUserId: string;
+        reason?: string;
+        expiresAt?: string;
+        context?: AuditContext;
+    }): Promise<AccountBan>;
+    revokeBan(input: {
+        actorUserId: string;
+        targetUserId: string;
+        reason?: string;
+        context?: AuditContext;
+    }): Promise<AccountBan>;
+    /** Clears elapsed bans durably. Safe for concurrent timers on multiple server instances. */
+    expireDueBans(input?: {
+        actorUserId?: string;
+        context?: AuditContext;
+    }): Promise<number>;
+    listBans(input: {
+        actorUserId: string;
+        targetUserId?: string;
+        status?: "active" | "expired" | "revoked";
+        before?: string;
+        limit: number;
+    }): Promise<Page<AccountBan>>;
+    createReport(input: {
+        actorUserId: string;
+        targetUserId?: string;
+        chatId?: string;
+        messageId?: string;
+        fileId?: string;
+        reason: string;
+        details?: string;
+        context?: AuditContext;
+    }): Promise<ModerationReport>;
+    listReports(input: {
+        actorUserId: string;
+        status?: ModerationReportStatus;
+        assignedToUserId?: string;
+        before?: string;
+        limit: number;
+    }): Promise<Page<ModerationReport>>;
+    updateReport(input: {
+        actorUserId: string;
+        reportId: string;
+        status?: ModerationReportStatus;
+        assignedToUserId?: string | null;
+        resolution?: string | null;
+        context?: AuditContext;
+    }): Promise<ModerationReport>;
+    takeModerationAction(input: {
+        actorUserId: string;
+        reportId: string;
+        action: ModerationActionKind;
+        automationRunId?: string;
+        reason?: string;
+        expiresAt?: string;
+        metadata?: Record<string, unknown>;
+        context?: AuditContext;
+    }): Promise<{
+        report: ModerationReport;
+        action: ModerationAction;
+        sync?: OperationsSyncHint;
+    }>;
+    revokeModerationAction(input: {
+        actorUserId: string;
+        actionId: string;
+        reason?: string;
+        context?: AuditContext;
+    }): Promise<{
+        action: ModerationAction;
+        sync: OperationsSyncHint;
+    }>;
+    requestDataExport(input: {
+        actorUserId: string;
+        kind: DataExportKind;
+        targetId?: string;
+        options?: Record<string, unknown>;
+        expiresAt?: string;
+        context?: AuditContext;
+    }): Promise<DataExportJob>;
+    getDataExport(actorUserId: string, jobId: string): Promise<DataExportJob>;
+    listDataExports(input: {
+        actorUserId: string;
+        status?: DataExportStatus;
+        requestedByUserId?: string;
+        before?: string;
+        limit: number;
+        ownOnly?: boolean;
+    }): Promise<Page<DataExportJob>>;
+    cancelDataExport(input: {
+        actorUserId: string;
+        jobId: string;
+        context?: AuditContext;
+    }): Promise<DataExportJob>;
+    updateDataExport(input: {
+        actorUserId: string;
+        jobId: string;
+        status: Exclude<DataExportStatus, "pending">;
+        outputFileId?: string;
+        lastError?: string;
+        expiresAt?: string;
+        context?: AuditContext;
+    }): Promise<DataExportJob>;
+    claimPendingDataExports(limit?: number, leaseMs?: number): Promise<ClaimedDataExport[]>;
+    buildDataExportArtifact(claim: ClaimedDataExport): Promise<Record<string, unknown>>;
+    completeClaimedDataExport(claim: ClaimedDataExport, outputFileId: string): Promise<boolean>;
+    failClaimedDataExport(claim: ClaimedDataExport, error: unknown): Promise<boolean>;
+    createBackup(input: {
+        actorUserId: string;
+        storageProvider: string;
+        storageKey: string;
+        retentionUntil?: string;
+        metadata?: Record<string, unknown>;
+        context?: AuditContext;
+    }): Promise<BackupRecord>;
+    listBackups(input: {
+        actorUserId: string;
+        status?: BackupStatus;
+        before?: string;
+        limit: number;
+    }): Promise<Page<BackupRecord>>;
+    updateBackup(input: {
+        actorUserId: string;
+        backupId: string;
+        status: Exclude<BackupStatus, "pending">;
+        checksumSha256?: string;
+        size?: number;
+        lastError?: string;
+        retentionUntil?: string;
+        metadata?: Record<string, unknown>;
+        context?: AuditContext;
+    }): Promise<BackupRecord>;
+    startRetentionRun(input: {
+        actorUserId: string;
+        scope: RetentionScope;
+        details?: Record<string, unknown>;
+        context?: AuditContext;
+    }): Promise<RetentionRun>;
+    listRetentionRuns(input: {
+        actorUserId: string;
+        scope?: RetentionScope;
+        before?: string;
+        limit: number;
+    }): Promise<Page<RetentionRun>>;
+    finishRetentionRun(input: {
+        actorUserId: string;
+        runId: string;
+        status: "complete" | "failed";
+        itemsExamined: number;
+        itemsDeleted: number;
+        details?: Record<string, unknown>;
+        lastError?: string;
+        context?: AuditContext;
+    }): Promise<RetentionRun>;
+    listUserAccess(input: {
+        actorUserId: string;
+        before?: string;
+        limit: number;
+    }): Promise<Page<UserAccessTelemetry>>;
+    private requireActiveUserDb;
+    private requireAdminDb;
+    private requireExistingUserDb;
+    private accountTargetDb;
+    private applyBanInTransaction;
+    private revokeBanInTransaction;
+    private createModerationNotification;
+    private removeMessageInTransaction;
+    private removeFileInTransaction;
+    private deleteUserInTransaction;
+    private recomputeThreadProjection;
+    private nextSequence;
+    private advanceChatMutation;
+    private insertSyncEvent;
+    private syncUserMutation;
+    private closeElapsedBan;
+    private requireReportTargetAccess;
+    private canAccessChat;
+    private banDb;
+    private reportDb;
+    private moderationActionDb;
+    private exportJobDb;
+    private backupDb;
+    private retentionRunDb;
+    private appendAudit;
+    private writeDb;
+}
+export {};
+//# sourceMappingURL=repository.d.ts.map

package/packages/happy2-server/dist/modules/operations/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../sources/modules/operations/repository.ts"],"names":[],"mappings":"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"}