@@ -11,6 +11,18 @@ This reference documents PowerSync error codes organized by component, with trou
11
11
- ** PSYNC_R0001** :
12
12
Catch-all sync rules parsing error, if no more specific error is available
13
13
14
+ ## PSYNC_R11xx: YAML syntax issues
15
+
16
+ ## PSYNC_R12xx: YAML structure (schema) issues
17
+
18
+ ## PSYNC_R21xx: SQL syntax issues
19
+
20
+ ## PSYNC_R22xx: SQL supported feature issues
21
+
22
+ ## PSYNC_R23xx: SQL schema mismatch issues
23
+
24
+ ## PSYNC_R24xx: SQL security warnings
25
+
14
26
# PSYNC_Sxxxx: Service issues
15
27
16
28
- ** PSYNC_S0001** :
@@ -111,6 +123,16 @@ This reference documents PowerSync error codes organized by component, with trou
111
123
- ** PSYNC_S1143** :
112
124
Publication uses publish_via_partition_root.
113
125
126
+ - ** PSYNC_S1144** :
127
+ Invalid Postgres server configuration for replication and sync bucket storage.
128
+
129
+ The same Postgres server, running an unsupported version of Postgres, has been configured for both replication and sync bucket storage.
130
+ Using the same Postgres server is only supported on Postgres 14 and above.
131
+ This error typically indicates that the Postgres version is below 14.
132
+ Either upgrade the Postgres server to version 14 or above, or use a different Postgres server for sync bucket storage.
133
+
134
+ ## PSYNC_S12xx: MySQL replication issues
135
+
114
136
## PSYNC_S13xx: MongoDB replication issues
115
137
116
138
- ** PSYNC_S1301** :
@@ -149,20 +171,42 @@ This reference documents PowerSync error codes organized by component, with trou
149
171
Sharded MongoDB Clusters are not supported yet.
150
172
151
173
- ** PSYNC_S1342** :
152
- Standalone MongoDB instances are not supported - use a replicaset .
174
+ Standalone MongoDB instances are not supported - use a replica-set .
153
175
154
176
- ** PSYNC_S1343** :
155
177
PostImages not enabled on a source collection.
156
178
157
179
Use ` post_images: auto_configure ` to configure post images automatically, or enable manually:
158
-
159
180
```
160
181
db.runCommand({
161
182
collMod: 'collection-name',
162
183
changeStreamPreAndPostImages: { enabled: true }
163
184
});
164
185
```
165
186
187
+ - ** PSYNC_S1344** :
188
+ The MongoDB Change Stream has been invalidated.
189
+
190
+ Possible causes:
191
+ - Some change stream documents do not have postImages.
192
+ - startAfter/resumeToken is not valid anymore.
193
+ - The replication connection has changed.
194
+ - The database has been dropped.
195
+
196
+ Replication will be stopped for this Change Stream. Replication will restart with a new Change Stream.
197
+
198
+ - ** PSYNC_S1345** :
199
+ Failed to read MongoDB Change Stream due to a timeout.
200
+
201
+ This may happen if there is a significant delay on the source database in reading the change stream.
202
+
203
+ If this is not resolved after retries, replication may need to be restarted from scratch.
204
+
205
+ - ** PSYNC_S1346** :
206
+ Failed to read MongoDB Change Stream.
207
+
208
+ See the error cause for more details.
209
+
166
210
## PSYNC_S14xx: MongoDB storage replication issues
167
211
168
212
- ** PSYNC_S1402** :
@@ -183,15 +227,46 @@ This reference documents PowerSync error codes organized by component, with trou
183
227
184
228
Wait a while then retry the request.
185
229
230
+ - ** PSYNC_S2004** :
231
+ 415 unsupported media type.
232
+
233
+ This code always indicates an issue with the client.
234
+
186
235
## PSYNC_S21xx: Auth errors originating on the client.
187
236
188
237
This does not include auth configuration errors on the service.
189
238
190
239
- ** PSYNC_S2101** :
191
240
Generic authentication error.
192
241
242
+ - ** PSYNC_S2102** :
243
+ Could not verify the auth token signature.
244
+
245
+ Typical causes include:
246
+ 1 . Token kid is not found in the keystore.
247
+ 2 . Signature does not match the kid in the keystore.
248
+
249
+ - ** PSYNC_S2103** :
250
+ Token has expired. Check the expiry date on the token.
251
+
252
+ - ** PSYNC_S2104** :
253
+ Token expiration period is too long. Issue shorter-lived tokens.
254
+
255
+ - ** PSYNC_S2105** :
256
+ Token audience does not match expected values.
257
+
258
+ Check the aud value on the token, compared to the audience values allowed in the service config.
259
+
260
+ - ** PSYNC_S2106** :
261
+ No token provided. An auth token is required for every request.
262
+
263
+ The Authorization header must start with "Token" or "Bearer", followed by the JWT.
264
+
193
265
## PSYNC_S22xx: Auth integration errors
194
266
267
+ - ** PSYNC_S2201** :
268
+ Generic auth configuration error. See the message for details.
269
+
195
270
- ** PSYNC_S2202** :
196
271
IPv6 support is not enabled for the JWKS URI.
197
272
@@ -202,6 +277,9 @@ This does not include auth configuration errors on the service.
202
277
203
278
Make sure to use a publically-accessible JWKS URI.
204
279
280
+ - ** PSYNC_S2204** :
281
+ JWKS request failed.
282
+
205
283
## PSYNC_S23xx: Sync API errors
206
284
207
285
- ** PSYNC_S2302** :
@@ -216,11 +294,20 @@ This does not include auth configuration errors on the service.
216
294
- ** PSYNC_S2304** :
217
295
Maximum active concurrent connections limit has been reached.
218
296
297
+ - ** PSYNC_S2305** :
298
+ Too many buckets.
299
+
300
+ There is currently a limit of 1000 buckets per active connection.
301
+
219
302
## PSYNC_S23xx: Sync API errors - MongoDB Storage
220
303
221
304
- ** PSYNC_S2401** :
222
305
Could not get clusterTime.
223
306
307
+ ## PSYNC_S23xx: Sync API errors - Postgres Storage
308
+
309
+ ## PSYNC_S3xxx: Service configuration issues
310
+
224
311
## PSYNC_S31xx: Auth configuration issues
225
312
226
313
- ** PSYNC_S3102** :
0 commit comments