@serve.zone/coremail 1.0.0

package/ts/index.ts

@@ -0,0 +1,38 @@
+import { CoreMail } from './classes.coremail.js';
+
+export { CoreMail } from './classes.coremail.js';
+export { readCoreMailConfig } from './classes.config.js';
+export type * from './interfaces.js';
+
+export const runCli = async (): Promise<void> => {
+  const coreMail = new CoreMail();
+  let stopping = false;
+  const stop = async (): Promise<void> => {
+    if (stopping) return;
+    stopping = true;
+    process.off('SIGINT', onSigint);
+    process.off('SIGTERM', onSigterm);
+    try {
+      await coreMail.stop();
+      process.exitCode = 0;
+    } catch {
+      process.exitCode = 1;
+    }
+  };
+  const onSigint = () => {
+    void stop();
+  };
+  const onSigterm = () => {
+    void stop();
+  };
+  process.on('SIGINT', onSigint);
+  process.on('SIGTERM', onSigterm);
+  try {
+    await coreMail.start();
+  } catch (error) {
+    process.off('SIGINT', onSigint);
+    process.off('SIGTERM', onSigterm);
+    await coreMail.stop().catch(() => undefined);
+    throw error;
+  }
+};

package/ts/interfaces.ts

@@ -0,0 +1,109 @@
+import type * as plugins from './plugins.js';
+
+export type TCoreMailSessionKind = 'control' | 'workload';
+
+export interface ICoreMailReplicaRuntime {
+  taskId: string;
+  serviceId: string;
+  rolloutId: string;
+  rolloutGeneration: number;
+  imageDigest: plugins.serveZoneInterfaces.data.TCoreMailSha256;
+}
+
+export interface ICoreMailConfig {
+  port: number;
+  hostnames: string[];
+  mongoDescriptor: {
+    mongoDbUrl: string;
+    mongoDbName: string;
+    maxPoolSize: number;
+    maxIdleTimeMS: number;
+    serverSelectionTimeoutMS: number;
+    socketTimeoutMS: number;
+  };
+  storageDescriptor: Record<string, unknown>;
+  bucketName: string;
+  controlBootstrap: plugins.serveZoneInterfaces.data.ICoreMailControlBootstrap;
+  resolveRuntimeSecret: (secretKeyArg: string) => string;
+  replica: ICoreMailReplicaRuntime;
+}
+
+export interface ICoreMailControlSession {
+  kind: 'control';
+  peerId: string;
+  credentialId: string;
+  credentialVersion: number;
+  authenticatedAt: number;
+}
+
+export interface ICoreMailWorkloadSession {
+  kind: 'workload';
+  peerId: string;
+  tenantId: string;
+  serviceId: string;
+  bindingId: string;
+  bindingRevision: number;
+  configEpoch: number;
+  credentialId: string;
+  credentialVersion: number;
+  bindingState: 'active' | 'draining';
+  capabilities: plugins.serveZoneInterfaces.data.TCoreMailCapability[];
+  allowedOperations: plugins.serveZoneInterfaces.data.TCoreMailWorkloadOperation[];
+  coreMailTransferOrigin: string;
+  authenticatedAt: number;
+}
+
+export type TCoreMailSession = ICoreMailControlSession | ICoreMailWorkloadSession;
+
+export type TTransferAuthorityKind = 'control' | 'gateway' | 'workload';
+export type TTransferGrantPurpose =
+  | 'desired-state-upload'
+  | 'outbound-part-upload'
+  | 'outbound-mime-download'
+  | 'inbound-mime-upload'
+  | 'inbound-mime-download';
+
+export interface ITransferAuthority {
+  kind: TTransferAuthorityKind;
+  tenantId: string;
+  serviceId: string;
+  bindingId: string;
+}
+
+export interface ISubmissionPartRecord {
+  partId: string;
+  kind: plugins.serveZoneInterfaces.data.TCoreMailPartKind;
+  contentType: string;
+  filename?: string;
+  contentId?: string;
+  sha256: plugins.serveZoneInterfaces.data.TCoreMailSha256;
+  lengthBytes: number;
+  objectKey: string;
+  state: 'missing' | 'uploading' | 'complete' | 'failed';
+  grantId?: string;
+}
+
+export interface ICoreMailReadiness {
+  live: boolean;
+  database: boolean;
+  objectStorage: boolean;
+  exactUpload: boolean;
+  exactPurge: boolean;
+  controlBootstrap: boolean;
+  gateway: boolean;
+}
+
+export interface ICoreMailAuthLimiterSnapshot {
+  inFlight: number;
+  tokens: number;
+}
+
+export interface ICoreMailPeer {
+  id: string;
+  data: Map<string, unknown>;
+  close(code?: number, reason?: string): void;
+  terminate(): void;
+  context: {
+    state: Record<string, unknown>;
+  };
+}

package/ts/plugins.ts

@@ -0,0 +1,11 @@
+export * as typedrequest from '@api.global/typedrequest';
+export * as typedrequestInterfaces from '@api.global/typedrequest-interfaces';
+export * as typedserver from '@api.global/typedserver';
+export * as typedsocket from '@api.global/typedsocket';
+export * as projectinfo from '@push.rocks/projectinfo';
+export * as smartbucket from '@push.rocks/smartbucket';
+export * as smartdata from '@push.rocks/smartdata';
+export * as smartlog from '@push.rocks/smartlog';
+export * as serveZoneInterfaces from '@serve.zone/interfaces';
+export * as argon2 from 'argon2';
+export * as nodeCrypto from 'node:crypto';