@oxy.so/contracts 6.18.0 → 6.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -135,4 +135,14 @@ exports.IDENTITY_ERROR_CODES = {
135
135
  * person deleted (owner's decision, 2026-11-07).
136
136
  */
137
137
  backupOptedOut: 'IDENTITY_BACKUP_OPTED_OUT',
138
+ /**
139
+ * `POST /identity/backup`: the account has no backup on record (never made
140
+ * one, or deleted it before deletions were recorded) and the upload is not
141
+ * the person's explicit choice to create one (`optIn`). Only re-sealing a
142
+ * backup the account HAS (current or superseded) needs no opt-in, so a
143
+ * client too old to send it (Commons 1.12 or older) never creates one
144
+ * silently after a key rotation; the message asks the person to update
145
+ * Commons (owner's decision, 2026-11-07).
146
+ */
147
+ backupOptInRequired: 'IDENTITY_BACKUP_OPT_IN_REQUIRED',
138
148
  };
@@ -117,13 +117,17 @@ exports.backupUploadRequestSchema = backupEnvelopeFields.extend({
117
117
  replacesLookupId: exports.backupLookupIdSchema.optional(),
118
118
  /**
119
119
  * The person's explicit choice to have a backup (owner's decision,
120
- * 2026-11-07). A person who deleted their backup (`status.optedOut`) gets a
121
- * new one only with it: an upload without it is refused (409
122
- * `IDENTITY_BACKUP_OPTED_OUT`), so a key rotation, a re-seal or another
123
- * device never re-uploads silently. An accepted upload with it clears the
124
- * deletion in the same transaction. Ignored when the person never deleted
125
- * one. Clients send it only from a control the person pressed ("Create
126
- * backup", or the rotation's "Create a backup" choice).
120
+ * 2026-11-07). Required whenever the account has NO backup row: a person
121
+ * who deleted theirs (`status.optedOut`; refused without it, 409
122
+ * `IDENTITY_BACKUP_OPTED_OUT`) and a person with none on record (never
123
+ * made one, or deleted it before deletions were recorded; 409
124
+ * `IDENTITY_BACKUP_OPT_IN_REQUIRED`), so a key rotation, a re-seal, another
125
+ * device or an older client never creates one silently. An accepted upload
126
+ * with it clears a recorded deletion in the same transaction. Not needed to
127
+ * re-seal a backup the account has (current, or superseded with
128
+ * `replacesLookupId`). Clients send it only from a control the person
129
+ * pressed ("Create backup", or the rotation's "Create an encrypted backup"
130
+ * choice).
127
131
  */
128
132
  optIn: zod_1.z.boolean().optional(),
129
133
  });
@@ -130,4 +130,14 @@ export const IDENTITY_ERROR_CODES = {
130
130
  * person deleted (owner's decision, 2026-11-07).
131
131
  */
132
132
  backupOptedOut: 'IDENTITY_BACKUP_OPTED_OUT',
133
+ /**
134
+ * `POST /identity/backup`: the account has no backup on record (never made
135
+ * one, or deleted it before deletions were recorded) and the upload is not
136
+ * the person's explicit choice to create one (`optIn`). Only re-sealing a
137
+ * backup the account HAS (current or superseded) needs no opt-in, so a
138
+ * client too old to send it (Commons 1.12 or older) never creates one
139
+ * silently after a key rotation; the message asks the person to update
140
+ * Commons (owner's decision, 2026-11-07).
141
+ */
142
+ backupOptInRequired: 'IDENTITY_BACKUP_OPT_IN_REQUIRED',
133
143
  };
@@ -114,13 +114,17 @@ export const backupUploadRequestSchema = backupEnvelopeFields.extend({
114
114
  replacesLookupId: backupLookupIdSchema.optional(),
115
115
  /**
116
116
  * The person's explicit choice to have a backup (owner's decision,
117
- * 2026-11-07). A person who deleted their backup (`status.optedOut`) gets a
118
- * new one only with it: an upload without it is refused (409
119
- * `IDENTITY_BACKUP_OPTED_OUT`), so a key rotation, a re-seal or another
120
- * device never re-uploads silently. An accepted upload with it clears the
121
- * deletion in the same transaction. Ignored when the person never deleted
122
- * one. Clients send it only from a control the person pressed ("Create
123
- * backup", or the rotation's "Create a backup" choice).
117
+ * 2026-11-07). Required whenever the account has NO backup row: a person
118
+ * who deleted theirs (`status.optedOut`; refused without it, 409
119
+ * `IDENTITY_BACKUP_OPTED_OUT`) and a person with none on record (never
120
+ * made one, or deleted it before deletions were recorded; 409
121
+ * `IDENTITY_BACKUP_OPT_IN_REQUIRED`), so a key rotation, a re-seal, another
122
+ * device or an older client never creates one silently. An accepted upload
123
+ * with it clears a recorded deletion in the same transaction. Not needed to
124
+ * re-seal a backup the account has (current, or superseded with
125
+ * `replacesLookupId`). Clients send it only from a control the person
126
+ * pressed ("Create backup", or the rotation's "Create an encrypted backup"
127
+ * choice).
124
128
  */
125
129
  optIn: z.boolean().optional(),
126
130
  });
@@ -98,5 +98,15 @@ export declare const IDENTITY_ERROR_CODES: {
98
98
  * person deleted (owner's decision, 2026-11-07).
99
99
  */
100
100
  readonly backupOptedOut: "IDENTITY_BACKUP_OPTED_OUT";
101
+ /**
102
+ * `POST /identity/backup`: the account has no backup on record (never made
103
+ * one, or deleted it before deletions were recorded) and the upload is not
104
+ * the person's explicit choice to create one (`optIn`). Only re-sealing a
105
+ * backup the account HAS (current or superseded) needs no opt-in, so a
106
+ * client too old to send it (Commons 1.12 or older) never creates one
107
+ * silently after a key rotation; the message asks the person to update
108
+ * Commons (owner's decision, 2026-11-07).
109
+ */
110
+ readonly backupOptInRequired: "IDENTITY_BACKUP_OPT_IN_REQUIRED";
101
111
  };
102
112
  export type IdentityErrorCode = (typeof IDENTITY_ERROR_CODES)[keyof typeof IDENTITY_ERROR_CODES];
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@oxy.so/contracts",
3
- "version": "6.18.0",
3
+ "version": "6.19.0",
4
4
  "description": "OxyHQ API contracts — single source of truth for request/response Zod schemas and inferred types, shared by the backend and the client SDKs",
5
5
  "main": "dist/cjs/index.js",
6
6
  "module": "dist/esm/index.js",