@remit/backend 0.0.1

package/src/service/trigger-sync.ts

@@ -0,0 +1,102 @@
+import { randomUUID } from "node:crypto";
+import { SendMessageCommand, type SQSClient } from "@aws-sdk/client-sqs";
+
+interface SyncMailboxesEvent {
+	type: "SYNC_MAILBOXES";
+	eventId: string;
+	timestamp: number;
+	accountId: string;
+}
+
+interface TriggerAccountSyncInput {
+	sqsClient: SQSClient;
+	queueUrl: string;
+	accountId: string;
+	/**
+	 * Override the FIFO `MessageDeduplicationId`. Defaults to a time-bucketed
+	 * manual-trigger id (`buildManualSyncDedupId`) shared by every manual call
+	 * site (POST /sync, OAuth connect, config load, pull-to-refresh, the
+	 * client's online-poll) so a rapid double-tap collapses into one enqueue,
+	 * while distinct triggers a bucket or more apart always pass through.
+	 *
+	 * The scheduled-sync tick (#1247) must NOT share that namespace: pass
+	 * `buildScheduledSyncDedupId()` here instead, so the two paths can never
+	 * suppress each other.
+	 */
+	dedupId?: string;
+}
+
+const isFifoQueue = (queueUrl: string): boolean => queueUrl.endsWith(".fifo");
+
+/**
+ * Bucket window for the manual-trigger dedup id. SQS FIFO's own dedup window
+ * is 5 minutes; a static per-account id (the pre-#1250 behaviour) collided
+ * with the client's 5-minute online poll and swallowed a pull-to-refresh
+ * within 5 minutes of any prior trigger. Bucketing to ~60s keeps a rapid
+ * double-tap deduped while letting distinct polls a minute or more apart
+ * always enqueue.
+ */
+const MANUAL_DEDUP_BUCKET_MS = 60_000;
+
+/**
+ * Build the manual-trigger dedup id (POST /sync, OAuth connect, config load,
+ * pull-to-refresh, client online-poll), bucketed so consecutive triggers a
+ * bucket apart never collide — see `dedupId` above.
+ */
+export const buildManualSyncDedupId = (
+	accountId: string,
+	now: number,
+	bucketMs: number = MANUAL_DEDUP_BUCKET_MS,
+): string => {
+	const bucket = Math.floor(now / bucketMs);
+	return `SYNC_MAILBOXES:manual:${accountId}:${bucket}`;
+};
+
+/**
+ * Build the scheduler's own dedup namespace, bucketed by tick interval so
+ * consecutive ticks each get a fresh id (never colliding with each other)
+ * while still deduping a genuine double-invocation of the same tick (e.g. a
+ * retried Lambda) — see `dedupId` above.
+ */
+export const buildScheduledSyncDedupId = (
+	accountId: string,
+	now: number,
+	bucketMs: number,
+): string => {
+	const bucket = Math.floor(now / bucketMs);
+	return `SYNC_MAILBOXES:scheduled:${accountId}:${bucket}`;
+};
+
+export const buildSyncMailboxesCommand = (
+	input: TriggerAccountSyncInput,
+): SendMessageCommand => {
+	const { queueUrl, accountId, dedupId } = input;
+	const event: SyncMailboxesEvent = {
+		type: "SYNC_MAILBOXES",
+		eventId: randomUUID(),
+		timestamp: Date.now(),
+		accountId,
+	};
+
+	const useFifo = isFifoQueue(queueUrl);
+
+	return new SendMessageCommand({
+		QueueUrl: queueUrl,
+		MessageBody: JSON.stringify(event),
+		...(useFifo && {
+			MessageGroupId: accountId,
+			MessageDeduplicationId:
+				dedupId ?? buildManualSyncDedupId(accountId, event.timestamp),
+		}),
+	});
+};
+
+export const triggerAccountSync = async (
+	input: TriggerAccountSyncInput,
+): Promise<{ eventId: string }> => {
+	const command = buildSyncMailboxesCommand(input);
+	await input.sqsClient.send(command);
+	const body = command.input.MessageBody ?? "{}";
+	const parsed = JSON.parse(body) as SyncMailboxesEvent;
+	return { eventId: parsed.eventId };
+};

package/src/types.ts

@@ -0,0 +1,161 @@
+import type { Context } from "openapi-backend";
+
+type MatchPrefix<
+	Prefix extends string,
+	S extends string,
+> = S extends `${Prefix}${infer _}` ? S : never;
+
+export type OperationIds =
+	| "MeOperations_deleteMe"
+	| "MeOperations_listVipSuggestions"
+	| "MeOperations_createExport"
+	| "MeOperations_getExport"
+	| "ConfigOperations_getConfig"
+	| "AccountOperations_createAccount"
+	| "AccountOperations_testConnection"
+	| "AccountDetailOperations_updateAccount"
+	| "AccountDetailOperations_deleteAccount"
+	| "MicrosoftOAuthOperations_microsoftOAuthStart"
+	| "MicrosoftOAuthOperations_microsoftOAuthCallback"
+	| "MailboxOperations_listMailboxes"
+	| "MailboxOperations_createMailbox"
+	| "MailboxDetailOperations_getMailbox"
+	| "MailboxDetailOperations_renameMailbox"
+	| "MailboxDetailOperations_deleteMailbox"
+	| "FolderRoleOperations_appointFolderRole"
+	| "FilterOperations_listFilters"
+	| "FilterOperations_createFilter"
+	| "FilterDetailOperations_getFilter"
+	| "FilterDetailOperations_updateFilter"
+	| "FilterDetailOperations_deleteFilter"
+	| "OrganizeOperations_createOrganizeJob"
+	| "OrganizeOperations_previewOrganize"
+	| "OrganizeJobDetailOperations_getOrganizeJob"
+	| "SyncOperations_triggerSync"
+	| "SyncOperations_getSyncStatus"
+	| "SemanticSearchOperations_semanticSearch"
+	| "ThreadDetailOperations_listThreadMessages"
+	| "UnifiedThreadOperations_listAllThreads"
+	| "ThreadOperations_listThreads"
+	| "ThreadOperations_searchThreads"
+	| "MessageOperations_describeMessage"
+	| "MessageOperations_getRawMessage"
+	| "MessageOperations_updateMessageFlags"
+	| "MessageBulkOperations_deleteMessages"
+	| "MessageBulkOperations_moveMessages"
+	| "MessageBulkOperations_updateFlags"
+	| "MessageBulkOperations_copyMessages"
+	| "TrashOperations_emptyTrash"
+	| "OutboxOperations_createOutboxMessage"
+	| "OutboxOperations_listOutboxMessages"
+	| "OutboxDetailOperations_getOutboxMessage"
+	| "OutboxDetailOperations_updateOutboxMessage"
+	| "OutboxDetailOperations_deleteOutboxMessage"
+	| "OutboxDetailOperations_sendOutboxMessage"
+	| "AddressOperations_searchAddresses"
+	| "AddressDetailOperations_updateAddress";
+
+export type MeOperationIds = MatchPrefix<"MeOperations_", OperationIds>;
+
+export type ConfigOperationIds = MatchPrefix<"ConfigOperations_", OperationIds>;
+
+export type AccountOperationIds = MatchPrefix<
+	"AccountOperations_",
+	OperationIds
+>;
+
+export type AccountDetailOperationIds = MatchPrefix<
+	"AccountDetailOperations_",
+	OperationIds
+>;
+
+export type MailboxOperationIds = MatchPrefix<
+	"MailboxOperations_",
+	OperationIds
+>;
+
+export type MailboxDetailOperationIds = MatchPrefix<
+	"MailboxDetailOperations_",
+	OperationIds
+>;
+
+export type FolderRoleOperationIds = MatchPrefix<
+	"FolderRoleOperations_",
+	OperationIds
+>;
+
+export type FilterOperationIds = MatchPrefix<"FilterOperations_", OperationIds>;
+
+export type FilterDetailOperationIds = MatchPrefix<
+	"FilterDetailOperations_",
+	OperationIds
+>;
+
+export type OrganizeOperationIds = MatchPrefix<
+	"OrganizeOperations_",
+	OperationIds
+>;
+
+export type OrganizeJobDetailOperationIds = MatchPrefix<
+	"OrganizeJobDetailOperations_",
+	OperationIds
+>;
+
+export type SyncOperationIds = MatchPrefix<"SyncOperations_", OperationIds>;
+
+export type ThreadDetailOperationIds = MatchPrefix<
+	"ThreadDetailOperations_",
+	OperationIds
+>;
+
+export type UnifiedThreadOperationIds = MatchPrefix<
+	"UnifiedThreadOperations_",
+	OperationIds
+>;
+
+export type ThreadOperationIds = MatchPrefix<"ThreadOperations_", OperationIds>;
+
+export type SemanticSearchOperationIds = MatchPrefix<
+	"SemanticSearchOperations_",
+	OperationIds
+>;
+
+export type MessageOperationIds = MatchPrefix<
+	"MessageOperations_",
+	OperationIds
+>;
+
+export type MessageBulkOperationIds = MatchPrefix<
+	"MessageBulkOperations_",
+	OperationIds
+>;
+
+export type TrashOperationIds = MatchPrefix<"TrashOperations_", OperationIds>;
+
+export type OutboxOperationIds = MatchPrefix<"OutboxOperations_", OperationIds>;
+
+export type OutboxDetailOperationIds = MatchPrefix<
+	"OutboxDetailOperations_",
+	OperationIds
+>;
+
+export type AddressOperationIds = MatchPrefix<
+	"AddressOperations_",
+	OperationIds
+>;
+
+export type AddressDetailOperationIds = MatchPrefix<
+	"AddressDetailOperations_",
+	OperationIds
+>;
+
+export type MicrosoftOAuthOperationIds = MatchPrefix<
+	"MicrosoftOAuthOperations_",
+	OperationIds
+>;
+
+// biome-ignore lint/suspicious/noExplicitAny: handler responses vary by operation
+type HandlerResponse = Record<string, any>;
+export type OperationHandler<_T extends OperationIds = OperationIds> = (
+	context: Context,
+) => Promise<HandlerResponse>;

package/tsconfig.json

@@ -0,0 +1,7 @@
+{
+	"extends": "../../tsconfig.json",
+	"compilerOptions": {
+		"outDir": "dist"
+	},
+	"include": ["src/**/*.ts", "dev-server/**/*.ts"]
+}