@remit/config-format 0.0.3 → 0.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remit/config-format",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",

package/schema/reader-config.v1.schema.json

@@ -190,6 +190,7 @@
 										"type": "boolean"
 									},
 									"setAt": {
+										"description": "Epoch milliseconds the flag was set. 0 means it was set at an unknown time, on a row written before the field existed.",
 										"type": "integer",
 										"minimum": -9007199254740991,
 										"maximum": 9007199254740991
@@ -293,6 +294,7 @@
 													"type": "boolean"
 												},
 												"setAt": {
+													"description": "Epoch milliseconds the flag was set. 0 means it was set at an unknown time, on a row written before the field existed.",
 													"type": "integer",
 													"minimum": -9007199254740991,
 													"maximum": 9007199254740991
@@ -561,6 +563,7 @@
 										"type": "boolean"
 									},
 									"setAt": {
+										"description": "Epoch milliseconds the flag was set. 0 means it was set at an unknown time, on a row written before the field existed.",
 										"type": "integer",
 										"minimum": -9007199254740991,
 										"maximum": 9007199254740991
@@ -590,6 +593,7 @@
 										"type": "boolean"
 									},
 									"setAt": {
+										"description": "Epoch milliseconds the flag was set. 0 means it was set at an unknown time, on a row written before the field existed.",
 										"type": "integer",
 										"minimum": -9007199254740991,
 										"maximum": 9007199254740991
@@ -619,6 +623,7 @@
 										"type": "boolean"
 									},
 									"setAt": {
+										"description": "Epoch milliseconds the flag was set. 0 means it was set at an unknown time, on a row written before the field existed.",
 										"type": "integer",
 										"minimum": -9007199254740991,
 										"maximum": 9007199254740991
@@ -648,6 +653,7 @@
 										"type": "boolean"
 									},
 									"setAt": {
+										"description": "Epoch milliseconds the flag was set. 0 means it was set at an unknown time, on a row written before the field existed.",
 										"type": "integer",
 										"minimum": -9007199254740991,
 										"maximum": 9007199254740991
@@ -686,6 +692,7 @@
 										]
 									},
 									"setAt": {
+										"description": "Epoch milliseconds the flag was set. 0 means it was set at an unknown time, on a row written before the field existed.",
 										"type": "integer",
 										"minimum": -9007199254740991,
 										"maximum": 9007199254740991
@@ -715,6 +722,7 @@
 										"type": "boolean"
 									},
 									"setAt": {
+										"description": "Epoch milliseconds the flag was set. 0 means it was set at an unknown time, on a row written before the field existed.",
 										"type": "integer",
 										"minimum": -9007199254740991,
 										"maximum": 9007199254740991
@@ -744,6 +752,7 @@
 										"type": "boolean"
 									},
 									"setAt": {
+										"description": "Epoch milliseconds the flag was set. 0 means it was set at an unknown time, on a row written before the field existed.",
 										"type": "integer",
 										"minimum": -9007199254740991,
 										"maximum": 9007199254740991

package/src/document.ts

@@ -24,6 +24,16 @@ const IsoDateTime = z.iso.datetime({ offset: true });
 const Port = z.int().min(1).max(65535);
 const FlagTimestamp = z.int();
 
+/**
+ * When a flag was set. Required, with zero as the sentinel for a flag whose
+ * stored row predates the field: the decision is real, the moment it was made
+ * is not known. An exporter fills the sentinel rather than the export's own
+ * clock, which would date an old decision to the day it was copied.
+ */
+const FlagSetAt = FlagTimestamp.describe(
+	"Epoch milliseconds the flag was set. 0 means it was set at an unknown time, on a row written before the field existed.",
+);
+
 /**
  * An IMAP path, as the server spells it. Folders travel by path rather than by
  * id: the ids are local to the instance that wrote the file, the path is what
@@ -58,7 +68,7 @@ export const ProvenanceSchema = z
 /** The audit metadata every sender-level flag and mute carries. */
 export const FlagMetadataSchema = z.strictObject({
 	value: z.boolean(),
-	setAt: FlagTimestamp,
+	setAt: FlagSetAt,
 	setBy: z.string().optional(),
 	expiresAt: FlagTimestamp.optional(),
 	reason: z.string().optional(),
@@ -68,7 +78,7 @@ export const MutedFlagSchema = FlagMetadataSchema;
 
 const CategoryFlagSchema = z.strictObject({
 	value: z.enum(MessageCategory),
-	setAt: FlagTimestamp,
+	setAt: FlagSetAt,
 	setBy: z.string().optional(),
 	expiresAt: FlagTimestamp.optional(),
 	reason: z.string().optional(),
@@ -273,4 +283,3 @@ export type ConfigFilter = z.infer<typeof FilterSchema>;
 export type ConfigLabel = z.infer<typeof LabelSchema>;
 export type ConfigAddressFlagsEntry = z.infer<typeof AddressFlagsEntrySchema>;
 export type ConfigAddressFlags = z.infer<typeof AddressFlagsSchema>;
-export type ConfigClientPreferences = z.infer<typeof ClientPreferencesSchema>;

package/src/envelope.ts

@@ -11,5 +11,3 @@ export const ConfigEnvelopeSchema = z.object({
 	kind: z.literal(CONFIG_KIND),
 	schemaVersion: z.int().min(1),
 });
-
-export type ConfigEnvelope = z.infer<typeof ConfigEnvelopeSchema>;