@remit/data-ports 0.0.50 → 0.0.51

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remit/data-ports",
-  "version": "0.0.50",
+  "version": "0.0.51",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",

package/src/errors.ts

@@ -122,6 +122,23 @@ export class MessagePlacementUnsettledError extends ConflictError {
 	}
 }
 
+/**
+ * A configuration import refused because this configuration is not empty
+ * (#1021). The default is to refuse rather than to fold the file in: a person
+ * importing over a configuration they forgot they had should hear about it
+ * before anything moves. `details` counts what is already here, so the client
+ * can say what would be merged, and the same request with `onExisting: merge`
+ * goes through.
+ */
+export class ConfigNotEmptyError extends ConflictError {
+	name = "ConfigNotEmptyError";
+
+	constructor(message: string, details: Record<string, string>) {
+		super(message);
+		this.publicApiError = { code: "config_not_empty", details };
+	}
+}
+
 /**
  * A message exists but its body could not be fetched/parsed after every
  * body-sync retry was spent (issue #1270 / epic #1281 invariant 3). This is

package/src/filter-ttl.ts

@@ -0,0 +1,20 @@
+import { FilterScope } from "@remit/domain-enums";
+import { BadRequestError } from "./errors.js";
+
+/**
+ * Epoch-seconds `ttl` derived from `expiresAt`, set only for a `Temporary`
+ * filter (RFC 034 Decision 1.3). A `Standing` filter never carries `ttl` — the
+ * reserved table-wide TTL attribute must stay absent, or the row would be swept
+ * (Decision 1.4).
+ */
+export const deriveFilterTtl = (
+	scope: string,
+	expiresAt: string | undefined,
+): number | undefined => {
+	if (scope !== FilterScope.Temporary || !expiresAt) return undefined;
+	const ms = new Date(expiresAt).getTime();
+	if (Number.isNaN(ms)) {
+		throw new BadRequestError(`Invalid expiresAt: ${expiresAt}`);
+	}
+	return Math.floor(ms / 1000);
+};

package/src/index.ts

@@ -1,8 +1,10 @@
+export { deriveFilterTtl } from "./filter-ttl.js";
 export type { IAccountRepository } from "./interfaces/account.js";
 export type { IAccountConfigRepository } from "./interfaces/account-config.js";
 export type { IAccountExportRequestRepository } from "./interfaces/account-export-request.js";
 export type { IAccountSettingRepository } from "./interfaces/account-setting.js";
 export type { IAddressRepository } from "./interfaces/address.js";
+export type { IConfigImportRepository } from "./interfaces/config-import.js";
 export type { IEnvelopeRepository } from "./interfaces/envelope.js";
 export type { IFilterRepository } from "./interfaces/filter.js";
 export type { IFilterAnchorRepository } from "./interfaces/filter-anchor.js";
@@ -55,10 +57,13 @@ export type {
 	BodyPartParameterUpsertInput,
 	BodyPartStorageItem,
 	BodyPartUpsertInput,
+	ConfigImportItem,
+	ConfigImportUnresolvedRefItem,
 	CreateAccountConfigInput,
 	CreateAccountExportRequestInput,
 	CreateAccountInput,
 	CreateAddressInput,
+	CreateConfigImportInput,
 	CreateEnvelopeAddressInput,
 	CreateEnvelopeInput,
 	CreateFilterAnchorInput,
@@ -109,6 +114,7 @@ export type {
 	UpdateAccountExportRequestInput,
 	UpdateAccountInput,
 	UpdateAddressInput,
+	UpdateConfigImportInput,
 	UpdateEnvelopeInput,
 	UpdateFilterInput,
 	UpdateLabelInput,

package/src/interfaces/config-import.ts

@@ -0,0 +1,16 @@
+import type {
+	ConfigImportItem,
+	CreateConfigImportInput,
+	UpdateConfigImportInput,
+} from "../types.js";
+
+export interface IConfigImportRepository {
+	create(input: CreateConfigImportInput): Promise<ConfigImportItem>;
+	get(importId: string): Promise<ConfigImportItem>;
+	update(
+		importId: string,
+		input: UpdateConfigImportInput,
+	): Promise<ConfigImportItem>;
+	/** Newest first, so the caller reads the import a person just ran. */
+	listByAccountConfig(accountConfigId: string): Promise<ConfigImportItem[]>;
+}

package/src/types.ts

@@ -6,6 +6,8 @@ import type {
 	BodyPartParameterSchema,
 	BodyPartSchema,
 	BodyPartStorageSchema,
+	ConfigImportSchema,
+	ConfigImportUnresolvedRefSchema,
 	EnvelopeAddressSchema,
 	EnvelopeSchema,
 	FilterAnchorSchema,
@@ -256,6 +258,23 @@ export type UpdateOrganizeJobRequestInput = Partial<
 	>
 >;
 
+export type ConfigImportItem = z.infer<typeof ConfigImportSchema>;
+export type ConfigImportUnresolvedRefItem = z.infer<
+	typeof ConfigImportUnresolvedRefSchema
+>;
+
+export type CreateConfigImportInput = Omit<
+	ConfigImportItem,
+	"importId" | "createdAt" | "updatedAt" | "state" | "completedAt"
+> & {
+	state?: ConfigImportItem["state"];
+	completedAt?: ConfigImportItem["completedAt"];
+};
+
+export type UpdateConfigImportInput = Partial<
+	Pick<ConfigImportItem, "state" | "unresolvedRefs" | "completedAt">
+>;
+
 export type UpsertAccountSettingInput = {
 	accountConfigId: string;
 	name: string;