@electric-sql/client 0.8.0 → 0.9.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.
- package/README.md +10 -4
- package/dist/cjs/index.cjs +31 -31
- package/dist/cjs/index.cjs.map +1 -1
- package/dist/index.browser.mjs +3 -3
- package/dist/index.browser.mjs.map +1 -1
- package/dist/index.d.ts +43 -34
- package/dist/index.legacy-esm.js +31 -31
- package/dist/index.legacy-esm.js.map +1 -1
- package/dist/index.mjs +31 -31
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
- package/src/client.ts +86 -67
- package/src/constants.ts +0 -1
- package/src/fetch.ts +1 -0
- package/src/shape.ts +6 -1
package/README.md
CHANGED
|
@@ -51,17 +51,19 @@ import { ShapeStream } from '@electric-sql/client'
|
|
|
51
51
|
// Passes subscribers rows as they're inserted, updated, or deleted
|
|
52
52
|
const stream = new ShapeStream({
|
|
53
53
|
url: `${BASE_URL}/v1/shape`,
|
|
54
|
-
|
|
54
|
+
params: {
|
|
55
|
+
table: `foo`
|
|
56
|
+
}
|
|
55
57
|
})
|
|
56
58
|
|
|
57
59
|
// You can also add custom headers and URL parameters
|
|
58
60
|
const streamWithParams = new ShapeStream({
|
|
59
61
|
url: `${BASE_URL}/v1/shape`,
|
|
60
|
-
table: `foo`,
|
|
61
62
|
headers: {
|
|
62
63
|
'Authorization': 'Bearer token'
|
|
63
64
|
},
|
|
64
65
|
params: {
|
|
66
|
+
table: `foo`,
|
|
65
67
|
'custom-param': 'value'
|
|
66
68
|
}
|
|
67
69
|
})
|
|
@@ -80,7 +82,9 @@ import { ShapeStream, Shape } from '@electric-sql/client'
|
|
|
80
82
|
|
|
81
83
|
const stream = new ShapeStream({
|
|
82
84
|
url: `${BASE_URL}/v1/shape`,
|
|
83
|
-
|
|
85
|
+
params: {
|
|
86
|
+
table: `foo`
|
|
87
|
+
}
|
|
84
88
|
})
|
|
85
89
|
const shape = new Shape(stream)
|
|
86
90
|
|
|
@@ -101,7 +105,9 @@ The ShapeStream provides two ways to handle errors:
|
|
|
101
105
|
```typescript
|
|
102
106
|
const stream = new ShapeStream({
|
|
103
107
|
url: `${BASE_URL}/v1/shape`,
|
|
104
|
-
|
|
108
|
+
params: {
|
|
109
|
+
table: `foo`
|
|
110
|
+
},
|
|
105
111
|
onError: (error) => {
|
|
106
112
|
// Handle all stream errors here
|
|
107
113
|
console.error('Stream error:', error)
|
package/dist/cjs/index.cjs
CHANGED
|
@@ -299,7 +299,6 @@ var SHAPE_HANDLE_HEADER = `electric-handle`;
|
|
|
299
299
|
var CHUNK_LAST_OFFSET_HEADER = `electric-offset`;
|
|
300
300
|
var SHAPE_SCHEMA_HEADER = `electric-schema`;
|
|
301
301
|
var CHUNK_UP_TO_DATE_HEADER = `electric-up-to-date`;
|
|
302
|
-
var DATABASE_ID_QUERY_PARAM = `database_id`;
|
|
303
302
|
var COLUMNS_QUERY_PARAM = `columns`;
|
|
304
303
|
var LIVE_CACHE_BUSTER_QUERY_PARAM = `cursor`;
|
|
305
304
|
var SHAPE_HANDLE_QUERY_PARAM = `handle`;
|
|
@@ -485,6 +484,7 @@ function getNextChunkUrl(url, res) {
|
|
|
485
484
|
if (nextUrl.searchParams.has(LIVE_QUERY_PARAM)) return;
|
|
486
485
|
nextUrl.searchParams.set(SHAPE_HANDLE_QUERY_PARAM, shapeHandle);
|
|
487
486
|
nextUrl.searchParams.set(OFFSET_QUERY_PARAM, lastOffset);
|
|
487
|
+
nextUrl.searchParams.sort();
|
|
488
488
|
return nextUrl.toString();
|
|
489
489
|
}
|
|
490
490
|
function chainAborter(aborter, sourceSignal) {
|
|
@@ -499,18 +499,20 @@ function chainAborter(aborter, sourceSignal) {
|
|
|
499
499
|
|
|
500
500
|
// src/client.ts
|
|
501
501
|
var RESERVED_PARAMS = /* @__PURE__ */ new Set([
|
|
502
|
-
DATABASE_ID_QUERY_PARAM,
|
|
503
|
-
COLUMNS_QUERY_PARAM,
|
|
504
502
|
LIVE_CACHE_BUSTER_QUERY_PARAM,
|
|
505
503
|
SHAPE_HANDLE_QUERY_PARAM,
|
|
506
504
|
LIVE_QUERY_PARAM,
|
|
507
|
-
OFFSET_QUERY_PARAM
|
|
508
|
-
TABLE_QUERY_PARAM,
|
|
509
|
-
WHERE_QUERY_PARAM,
|
|
510
|
-
REPLICA_PARAM
|
|
505
|
+
OFFSET_QUERY_PARAM
|
|
511
506
|
]);
|
|
512
|
-
|
|
513
|
-
|
|
507
|
+
function toInternalParams(params) {
|
|
508
|
+
const result = {};
|
|
509
|
+
for (const [key, value] of Object.entries(params)) {
|
|
510
|
+
result[key] = Array.isArray(value) ? value.join(`,`) : value;
|
|
511
|
+
}
|
|
512
|
+
return result;
|
|
513
|
+
}
|
|
514
|
+
var _error, _fetchClient2, _messageParser, _subscribers, _lastOffset, _liveCacheBuster, _lastSyncedAt, _isUpToDate, _connected, _shapeHandle, _schema, _onError, _ShapeStream_instances, start_fn, publish_fn, sendErrorToSubscribers_fn, reset_fn;
|
|
515
|
+
var ShapeStream = class {
|
|
514
516
|
constructor(options) {
|
|
515
517
|
__privateAdd(this, _ShapeStream_instances);
|
|
516
518
|
__privateAdd(this, _error, null);
|
|
@@ -525,19 +527,15 @@ var _ShapeStream = class _ShapeStream {
|
|
|
525
527
|
__privateAdd(this, _isUpToDate, false);
|
|
526
528
|
__privateAdd(this, _connected, false);
|
|
527
529
|
__privateAdd(this, _shapeHandle);
|
|
528
|
-
__privateAdd(this, _databaseId);
|
|
529
530
|
__privateAdd(this, _schema);
|
|
530
531
|
__privateAdd(this, _onError);
|
|
531
|
-
__privateAdd(this, _replica);
|
|
532
532
|
var _a, _b, _c;
|
|
533
533
|
this.options = __spreadValues({ subscribe: true }, options);
|
|
534
534
|
validateOptions(this.options);
|
|
535
535
|
__privateSet(this, _lastOffset, (_a = this.options.offset) != null ? _a : `-1`);
|
|
536
536
|
__privateSet(this, _liveCacheBuster, ``);
|
|
537
537
|
__privateSet(this, _shapeHandle, this.options.handle);
|
|
538
|
-
__privateSet(this, _databaseId, this.options.databaseId);
|
|
539
538
|
__privateSet(this, _messageParser, new MessageParser(options.parser));
|
|
540
|
-
__privateSet(this, _replica, this.options.replica);
|
|
541
539
|
__privateSet(this, _onError, this.options.onError);
|
|
542
540
|
const baseFetchClient = (_b = options.fetchClient) != null ? _b : (...args) => fetch(...args);
|
|
543
541
|
const fetchWithBackoffClient = createFetchWithBackoff(baseFetchClient, __spreadProps(__spreadValues({}, (_c = options.backoffOptions) != null ? _c : BackoffDefaults), {
|
|
@@ -603,17 +601,15 @@ _lastSyncedAt = new WeakMap();
|
|
|
603
601
|
_isUpToDate = new WeakMap();
|
|
604
602
|
_connected = new WeakMap();
|
|
605
603
|
_shapeHandle = new WeakMap();
|
|
606
|
-
_databaseId = new WeakMap();
|
|
607
604
|
_schema = new WeakMap();
|
|
608
605
|
_onError = new WeakMap();
|
|
609
|
-
_replica = new WeakMap();
|
|
610
606
|
_ShapeStream_instances = new WeakSet();
|
|
611
607
|
start_fn = function() {
|
|
612
608
|
return __async(this, null, function* () {
|
|
613
|
-
var _a, _b
|
|
609
|
+
var _a, _b;
|
|
614
610
|
try {
|
|
615
611
|
while (!((_a = this.options.signal) == null ? void 0 : _a.aborted) && !__privateGet(this, _isUpToDate) || this.options.subscribe) {
|
|
616
|
-
const { url,
|
|
612
|
+
const { url, signal } = this.options;
|
|
617
613
|
const fetchUrl = new URL(url);
|
|
618
614
|
if (this.options.params) {
|
|
619
615
|
const reservedParams = Object.keys(this.options.params).filter(
|
|
@@ -624,14 +620,24 @@ start_fn = function() {
|
|
|
624
620
|
`Cannot use reserved Electric parameter names in custom params: ${reservedParams.join(`, `)}`
|
|
625
621
|
);
|
|
626
622
|
}
|
|
627
|
-
|
|
623
|
+
const params = toInternalParams(this.options.params);
|
|
624
|
+
if (params.table)
|
|
625
|
+
fetchUrl.searchParams.set(TABLE_QUERY_PARAM, params.table);
|
|
626
|
+
if (params.where)
|
|
627
|
+
fetchUrl.searchParams.set(WHERE_QUERY_PARAM, params.where);
|
|
628
|
+
if (params.columns)
|
|
629
|
+
fetchUrl.searchParams.set(COLUMNS_QUERY_PARAM, params.columns);
|
|
630
|
+
if (params.replica)
|
|
631
|
+
fetchUrl.searchParams.set(REPLICA_PARAM, params.replica);
|
|
632
|
+
const customParams = __spreadValues({}, params);
|
|
633
|
+
delete customParams.table;
|
|
634
|
+
delete customParams.where;
|
|
635
|
+
delete customParams.columns;
|
|
636
|
+
delete customParams.replica;
|
|
637
|
+
for (const [key, value] of Object.entries(customParams)) {
|
|
628
638
|
fetchUrl.searchParams.set(key, value);
|
|
629
639
|
}
|
|
630
640
|
}
|
|
631
|
-
if (table) fetchUrl.searchParams.set(TABLE_QUERY_PARAM, table);
|
|
632
|
-
if (where) fetchUrl.searchParams.set(WHERE_QUERY_PARAM, where);
|
|
633
|
-
if (columns && columns.length > 0)
|
|
634
|
-
fetchUrl.searchParams.set(COLUMNS_QUERY_PARAM, columns.join(`,`));
|
|
635
641
|
fetchUrl.searchParams.set(OFFSET_QUERY_PARAM, __privateGet(this, _lastOffset));
|
|
636
642
|
if (__privateGet(this, _isUpToDate)) {
|
|
637
643
|
fetchUrl.searchParams.set(LIVE_QUERY_PARAM, `true`);
|
|
@@ -646,12 +652,7 @@ start_fn = function() {
|
|
|
646
652
|
__privateGet(this, _shapeHandle)
|
|
647
653
|
);
|
|
648
654
|
}
|
|
649
|
-
|
|
650
|
-
fetchUrl.searchParams.set(DATABASE_ID_QUERY_PARAM, __privateGet(this, _databaseId));
|
|
651
|
-
}
|
|
652
|
-
if (((_b = __privateGet(this, _replica)) != null ? _b : _ShapeStream.Replica.DEFAULT) != _ShapeStream.Replica.DEFAULT) {
|
|
653
|
-
fetchUrl.searchParams.set(REPLICA_PARAM, __privateGet(this, _replica));
|
|
654
|
-
}
|
|
655
|
+
fetchUrl.searchParams.sort();
|
|
655
656
|
let response;
|
|
656
657
|
try {
|
|
657
658
|
response = yield __privateGet(this, _fetchClient2).call(this, fetchUrl.toString(), {
|
|
@@ -689,7 +690,7 @@ start_fn = function() {
|
|
|
689
690
|
const schemaHeader = headers.get(SHAPE_SCHEMA_HEADER);
|
|
690
691
|
return schemaHeader ? JSON.parse(schemaHeader) : {};
|
|
691
692
|
};
|
|
692
|
-
__privateSet(this, _schema, (
|
|
693
|
+
__privateSet(this, _schema, (_b = __privateGet(this, _schema)) != null ? _b : getSchema());
|
|
693
694
|
const messages = status === 204 ? `[]` : yield response.text();
|
|
694
695
|
if (status === 204) {
|
|
695
696
|
__privateSet(this, _lastSyncedAt, Date.now());
|
|
@@ -758,11 +759,10 @@ reset_fn = function(handle) {
|
|
|
758
759
|
__privateSet(this, _connected, false);
|
|
759
760
|
__privateSet(this, _schema, void 0);
|
|
760
761
|
};
|
|
761
|
-
|
|
762
|
+
ShapeStream.Replica = {
|
|
762
763
|
FULL: `full`,
|
|
763
764
|
DEFAULT: `default`
|
|
764
765
|
};
|
|
765
|
-
var ShapeStream = _ShapeStream;
|
|
766
766
|
function validateOptions(options) {
|
|
767
767
|
if (!options.url) {
|
|
768
768
|
throw new MissingShapeUrlError();
|
package/dist/cjs/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/index.ts","../../src/error.ts","../../src/parser.ts","../../src/helpers.ts","../../src/constants.ts","../../src/fetch.ts","../../src/client.ts","../../src/shape.ts"],"sourcesContent":["export * from './client'\nexport * from './shape'\nexport * from './types'\nexport { isChangeMessage, isControlMessage } from './helpers'\nexport { FetchError } from './error'\nexport { type BackoffOptions, BackoffDefaults } from './fetch'\n","export class FetchError extends Error {\n status: number\n text?: string\n json?: object\n headers: Record<string, string>\n\n constructor(\n status: number,\n text: string | undefined,\n json: object | undefined,\n headers: Record<string, string>,\n public url: string,\n message?: string\n ) {\n super(\n message ||\n `HTTP Error ${status} at ${url}: ${text ?? JSON.stringify(json)}`\n )\n this.name = `FetchError`\n this.status = status\n this.text = text\n this.json = json\n this.headers = headers\n }\n\n static async fromResponse(\n response: Response,\n url: string\n ): Promise<FetchError> {\n const status = response.status\n const headers = Object.fromEntries([...response.headers.entries()])\n let text: string | undefined = undefined\n let json: object | undefined = undefined\n\n const contentType = response.headers.get(`content-type`)\n if (contentType && contentType.includes(`application/json`)) {\n json = (await response.json()) as object\n } else {\n text = await response.text()\n }\n\n return new FetchError(status, text, json, headers, url)\n }\n}\n\nexport class FetchBackoffAbortError extends Error {\n constructor() {\n super(`Fetch with backoff aborted`)\n this.name = `FetchBackoffAbortError`\n }\n}\n\nexport class InvalidShapeOptionsError extends Error {\n constructor(message: string) {\n super(message)\n this.name = `InvalidShapeOptionsError`\n }\n}\n\nexport class MissingShapeUrlError extends Error {\n constructor() {\n super(`Invalid shape options: missing required url parameter`)\n this.name = `MissingShapeUrlError`\n }\n}\n\nexport class InvalidSignalError extends Error {\n constructor() {\n super(`Invalid signal option. It must be an instance of AbortSignal.`)\n this.name = `InvalidSignalError`\n }\n}\n\nexport class MissingShapeHandleError extends Error {\n constructor() {\n super(\n `shapeHandle is required if this isn't an initial fetch (i.e. offset > -1)`\n )\n this.name = `MissingShapeHandleError`\n }\n}\n\nexport class ReservedParamError extends Error {\n constructor(reservedParams: string[]) {\n super(\n `Cannot use reserved Electric parameter names in custom params: ${reservedParams.join(`, `)}`\n )\n this.name = `ReservedParamError`\n }\n}\n\nexport class ParserNullValueError extends Error {\n constructor(columnName: string) {\n super(`Column \"${columnName ?? `unknown`}\" does not allow NULL values`)\n this.name = `ParserNullValueError`\n }\n}\n\nexport class ShapeStreamAlreadyRunningError extends Error {\n constructor() {\n super(`ShapeStream is already running`)\n this.name = `ShapeStreamAlreadyRunningError`\n }\n}\n\nexport class MissingHeadersError extends Error {\n constructor(url: string, missingHeaders: Array<string>) {\n let msg = `The response for the shape request to ${url} didn't include the following required headers:\\n`\n missingHeaders.forEach((h) => {\n msg += `- ${h}\\n`\n })\n msg += `\\nThis is often due to a proxy not setting CORS correctly so that all Electric headers can be read by the client.`\n msg += `\\nFor more information visit the troubleshooting guide: /docs/guides/troubleshooting/missing-headers`\n super(msg)\n }\n}\n","import { ColumnInfo, GetExtensions, Message, Row, Schema, Value } from './types'\nimport { ParserNullValueError } from './error'\n\ntype NullToken = null | `NULL`\ntype Token = Exclude<string, NullToken>\ntype NullableToken = Token | NullToken\nexport type ParseFunction<Extensions = never> = (\n value: Token,\n additionalInfo?: Omit<ColumnInfo, `type` | `dims`>\n) => Value<Extensions>\ntype NullableParseFunction<Extensions = never> = (\n value: NullableToken,\n additionalInfo?: Omit<ColumnInfo, `type` | `dims`>\n) => Value<Extensions>\n/**\n * @typeParam Extensions - Additional types that can be parsed by this parser beyond the standard SQL types.\n * Defaults to no additional types.\n */\nexport type Parser<Extensions = never> = {\n [key: string]: ParseFunction<Extensions>\n}\n\nconst parseNumber = (value: string) => Number(value)\nconst parseBool = (value: string) => value === `true` || value === `t`\nconst parseBigInt = (value: string) => BigInt(value)\nconst parseJson = (value: string) => JSON.parse(value)\nconst identityParser: ParseFunction = (v: string) => v\n\nexport const defaultParser: Parser = {\n int2: parseNumber,\n int4: parseNumber,\n int8: parseBigInt,\n bool: parseBool,\n float4: parseNumber,\n float8: parseNumber,\n json: parseJson,\n jsonb: parseJson,\n}\n\n// Taken from: https://github.com/electric-sql/pglite/blob/main/packages/pglite/src/types.ts#L233-L279\nexport function pgArrayParser<Extensions>(\n value: Token,\n parser?: ParseFunction<Extensions>\n): Value<Extensions> {\n let i = 0\n let char = null\n let str = ``\n let quoted = false\n let last = 0\n let p: string | undefined = undefined\n\n function loop(x: string): Array<Value<Extensions>> {\n const xs = []\n for (; i < x.length; i++) {\n char = x[i]\n if (quoted) {\n if (char === `\\\\`) {\n str += x[++i]\n } else if (char === `\"`) {\n xs.push(parser ? parser(str) : str)\n str = ``\n quoted = x[i + 1] === `\"`\n last = i + 2\n } else {\n str += char\n }\n } else if (char === `\"`) {\n quoted = true\n } else if (char === `{`) {\n last = ++i\n xs.push(loop(x))\n } else if (char === `}`) {\n quoted = false\n last < i &&\n xs.push(parser ? parser(x.slice(last, i)) : x.slice(last, i))\n last = i + 1\n break\n } else if (char === `,` && p !== `}` && p !== `\"`) {\n xs.push(parser ? parser(x.slice(last, i)) : x.slice(last, i))\n last = i + 1\n }\n p = char\n }\n last < i &&\n xs.push(parser ? parser(x.slice(last, i + 1)) : x.slice(last, i + 1))\n return xs\n }\n\n return loop(value)[0]\n}\n\nexport class MessageParser<T extends Row<unknown>> {\n private parser: Parser<GetExtensions<T>>\n constructor(parser?: Parser<GetExtensions<T>>) {\n // Merge the provided parser with the default parser\n // to use the provided parser whenever defined\n // and otherwise fall back to the default parser\n this.parser = { ...defaultParser, ...parser }\n }\n\n parse(messages: string, schema: Schema): Message<T>[] {\n return JSON.parse(messages, (key, value) => {\n // typeof value === `object` && value !== null\n // is needed because there could be a column named `value`\n // and the value associated to that column will be a string or null.\n // But `typeof null === 'object'` so we need to make an explicit check.\n if (key === `value` && typeof value === `object` && value !== null) {\n // Parse the row values\n const row = value as Record<string, Value<GetExtensions<T>>>\n Object.keys(row).forEach((key) => {\n row[key] = this.parseRow(key, row[key] as NullableToken, schema)\n })\n }\n return value\n }) as Message<T>[]\n }\n\n // Parses the message values using the provided parser based on the schema information\n private parseRow(\n key: string,\n value: NullableToken,\n schema: Schema\n ): Value<GetExtensions<T>> {\n const columnInfo = schema[key]\n if (!columnInfo) {\n // We don't have information about the value\n // so we just return it\n return value\n }\n\n // Copy the object but don't include `dimensions` and `type`\n const { type: typ, dims: dimensions, ...additionalInfo } = columnInfo\n\n // Pick the right parser for the type\n // and support parsing null values if needed\n // if no parser is provided for the given type, just return the value as is\n const typeParser = this.parser[typ] ?? identityParser\n const parser = makeNullableParser(typeParser, columnInfo, key)\n\n if (dimensions && dimensions > 0) {\n // It's an array\n const nullablePgArrayParser = makeNullableParser(\n (value, _) => pgArrayParser(value, parser),\n columnInfo,\n key\n )\n return nullablePgArrayParser(value)\n }\n\n return parser(value, additionalInfo)\n }\n}\n\nfunction makeNullableParser<Extensions>(\n parser: ParseFunction<Extensions>,\n columnInfo: ColumnInfo,\n columnName?: string\n): NullableParseFunction<Extensions> {\n const isNullable = !(columnInfo.not_null ?? false)\n // The sync service contains `null` value for a column whose value is NULL\n // but if the column value is an array that contains a NULL value\n // then it will be included in the array string as `NULL`, e.g.: `\"{1,NULL,3}\"`\n return (value: NullableToken) => {\n if (isPgNull(value)) {\n if (!isNullable) {\n throw new ParserNullValueError(columnName ?? `unknown`)\n }\n return null\n }\n return parser(value, columnInfo)\n }\n}\n\nfunction isPgNull(value: NullableToken): value is NullToken {\n return value === null || value === `NULL`\n}\n","import { ChangeMessage, ControlMessage, Message, Row } from './types'\n\n/**\n * Type guard for checking {@link Message} is {@link ChangeMessage}.\n *\n * See [TS docs](https://www.typescriptlang.org/docs/handbook/advanced-types.html#user-defined-type-guards)\n * for information on how to use type guards.\n *\n * @param message - the message to check\n * @returns true if the message is a {@link ChangeMessage}\n *\n * @example\n * ```ts\n * if (isChangeMessage(message)) {\n * const msgChng: ChangeMessage = message // Ok\n * const msgCtrl: ControlMessage = message // Err, type mismatch\n * }\n * ```\n */\nexport function isChangeMessage<T extends Row<unknown> = Row>(\n message: Message<T>\n): message is ChangeMessage<T> {\n return `key` in message\n}\n\n/**\n * Type guard for checking {@link Message} is {@link ControlMessage}.\n *\n * See [TS docs](https://www.typescriptlang.org/docs/handbook/advanced-types.html#user-defined-type-guards)\n * for information on how to use type guards.\n *\n * @param message - the message to check\n * @returns true if the message is a {@link ControlMessage}\n *\n * * @example\n * ```ts\n * if (isControlMessage(message)) {\n * const msgChng: ChangeMessage = message // Err, type mismatch\n * const msgCtrl: ControlMessage = message // Ok\n * }\n * ```\n */\nexport function isControlMessage<T extends Row<unknown> = Row>(\n message: Message<T>\n): message is ControlMessage {\n return !isChangeMessage(message)\n}\n\nexport function isUpToDateMessage<T extends Row<unknown> = Row>(\n message: Message<T>\n): message is ControlMessage & { up_to_date: true } {\n return isControlMessage(message) && message.headers.control === `up-to-date`\n}\n","export const LIVE_CACHE_BUSTER_HEADER = `electric-cursor`\nexport const SHAPE_HANDLE_HEADER = `electric-handle`\nexport const CHUNK_LAST_OFFSET_HEADER = `electric-offset`\nexport const SHAPE_SCHEMA_HEADER = `electric-schema`\nexport const CHUNK_UP_TO_DATE_HEADER = `electric-up-to-date`\nexport const DATABASE_ID_QUERY_PARAM = `database_id`\nexport const COLUMNS_QUERY_PARAM = `columns`\nexport const LIVE_CACHE_BUSTER_QUERY_PARAM = `cursor`\nexport const SHAPE_HANDLE_QUERY_PARAM = `handle`\nexport const LIVE_QUERY_PARAM = `live`\nexport const OFFSET_QUERY_PARAM = `offset`\nexport const TABLE_QUERY_PARAM = `table`\nexport const WHERE_QUERY_PARAM = `where`\nexport const REPLICA_PARAM = `replica`\n","import {\n CHUNK_LAST_OFFSET_HEADER,\n CHUNK_UP_TO_DATE_HEADER,\n LIVE_QUERY_PARAM,\n OFFSET_QUERY_PARAM,\n SHAPE_HANDLE_HEADER,\n SHAPE_HANDLE_QUERY_PARAM,\n} from './constants'\nimport {\n FetchError,\n FetchBackoffAbortError,\n MissingHeadersError,\n} from './error'\n\n// Some specific 4xx and 5xx HTTP status codes that we definitely\n// want to retry\nconst HTTP_RETRY_STATUS_CODES = [429]\n\nexport interface BackoffOptions {\n /**\n * Initial delay before retrying in milliseconds\n */\n initialDelay: number\n /**\n * Maximum retry delay in milliseconds\n */\n maxDelay: number\n multiplier: number\n onFailedAttempt?: () => void\n debug?: boolean\n}\n\nexport const BackoffDefaults = {\n initialDelay: 100,\n maxDelay: 10_000,\n multiplier: 1.3,\n}\n\nexport function createFetchWithBackoff(\n fetchClient: typeof fetch,\n backoffOptions: BackoffOptions = BackoffDefaults\n): typeof fetch {\n const {\n initialDelay,\n maxDelay,\n multiplier,\n debug = false,\n onFailedAttempt,\n } = backoffOptions\n return async (...args: Parameters<typeof fetch>): Promise<Response> => {\n const url = args[0]\n const options = args[1]\n\n let delay = initialDelay\n let attempt = 0\n\n /* eslint-disable no-constant-condition -- we re-fetch the shape log\n * continuously until we get a non-ok response. For recoverable errors,\n * we retry the fetch with exponential backoff. Users can pass in an\n * AbortController to abort the fetching an any point.\n * */\n while (true) {\n /* eslint-enable no-constant-condition */\n try {\n const result = await fetchClient(...args)\n if (result.ok) return result\n else throw await FetchError.fromResponse(result, url.toString())\n } catch (e) {\n onFailedAttempt?.()\n if (options?.signal?.aborted) {\n throw new FetchBackoffAbortError()\n } else if (\n e instanceof FetchError &&\n !HTTP_RETRY_STATUS_CODES.includes(e.status) &&\n e.status >= 400 &&\n e.status < 500\n ) {\n // Any client errors cannot be backed off on, leave it to the caller to handle.\n throw e\n } else {\n // Exponentially backoff on errors.\n // Wait for the current delay duration\n await new Promise((resolve) => setTimeout(resolve, delay))\n\n // Increase the delay for the next attempt\n delay = Math.min(delay * multiplier, maxDelay)\n\n if (debug) {\n attempt++\n console.log(`Retry attempt #${attempt} after ${delay}ms`)\n }\n }\n }\n }\n }\n}\n\ninterface ChunkPrefetchOptions {\n maxChunksToPrefetch: number\n}\n\nconst ChunkPrefetchDefaults = {\n maxChunksToPrefetch: 2,\n}\n\n/**\n * Creates a fetch client that prefetches subsequent log chunks for\n * consumption by the shape stream without waiting for the chunk bodies\n * themselves to be loaded.\n *\n * @param fetchClient the client to wrap\n * @param prefetchOptions options to configure prefetching\n * @returns wrapped client with prefetch capabilities\n */\nexport function createFetchWithChunkBuffer(\n fetchClient: typeof fetch,\n prefetchOptions: ChunkPrefetchOptions = ChunkPrefetchDefaults\n): typeof fetch {\n const { maxChunksToPrefetch } = prefetchOptions\n\n let prefetchQueue: PrefetchQueue\n\n const prefetchClient = async (...args: Parameters<typeof fetchClient>) => {\n const url = args[0].toString()\n\n // try to consume from the prefetch queue first, and if request is\n // not present abort the prefetch queue as it must no longer be valid\n const prefetchedRequest = prefetchQueue?.consume(...args)\n if (prefetchedRequest) {\n return prefetchedRequest\n }\n\n prefetchQueue?.abort()\n\n // perform request and fire off prefetch queue if request is eligible\n const response = await fetchClient(...args)\n const nextUrl = getNextChunkUrl(url, response)\n if (nextUrl) {\n prefetchQueue = new PrefetchQueue({\n fetchClient,\n maxPrefetchedRequests: maxChunksToPrefetch,\n url: nextUrl,\n requestInit: args[1],\n })\n }\n\n return response\n }\n\n return prefetchClient\n}\n\nexport const requiredElectricResponseHeaders = [\n `electric-offset`,\n `electric-handle`,\n]\n\nexport const requiredLiveResponseHeaders = [`electric-cursor`]\n\nexport const requiredNonLiveResponseHeaders = [`electric-schema`]\n\nexport function createFetchWithResponseHeadersCheck(\n fetchClient: typeof fetch\n): typeof fetch {\n return async (...args: Parameters<typeof fetchClient>) => {\n const response = await fetchClient(...args)\n\n if (response.ok) {\n // Check that the necessary Electric headers are present on the response\n const headers = response.headers\n const missingHeaders: Array<string> = []\n\n const addMissingHeaders = (requiredHeaders: Array<string>) =>\n missingHeaders.push(...requiredHeaders.filter((h) => !headers.has(h)))\n addMissingHeaders(requiredElectricResponseHeaders)\n\n const input = args[0]\n const urlString = input.toString()\n const url = new URL(urlString)\n if (url.searchParams.has(LIVE_QUERY_PARAM, `true`)) {\n addMissingHeaders(requiredLiveResponseHeaders)\n }\n\n if (\n !url.searchParams.has(LIVE_QUERY_PARAM) ||\n url.searchParams.has(LIVE_QUERY_PARAM, `false`)\n ) {\n addMissingHeaders(requiredNonLiveResponseHeaders)\n }\n\n if (missingHeaders.length > 0) {\n throw new MissingHeadersError(urlString, missingHeaders)\n }\n }\n\n return response\n }\n}\n\nclass PrefetchQueue {\n readonly #fetchClient: typeof fetch\n readonly #maxPrefetchedRequests: number\n readonly #prefetchQueue = new Map<\n string,\n [Promise<Response>, AbortController]\n >()\n #queueHeadUrl: string | void\n #queueTailUrl: string | void\n\n constructor(options: {\n url: Parameters<typeof fetch>[0]\n requestInit: Parameters<typeof fetch>[1]\n maxPrefetchedRequests: number\n fetchClient?: typeof fetch\n }) {\n this.#fetchClient =\n options.fetchClient ??\n ((...args: Parameters<typeof fetch>) => fetch(...args))\n this.#maxPrefetchedRequests = options.maxPrefetchedRequests\n this.#queueHeadUrl = options.url.toString()\n this.#queueTailUrl = this.#queueHeadUrl\n this.#prefetch(options.url, options.requestInit)\n }\n\n abort(): void {\n this.#prefetchQueue.forEach(([_, aborter]) => aborter.abort())\n }\n\n consume(...args: Parameters<typeof fetch>): Promise<Response> | void {\n const url = args[0].toString()\n\n const request = this.#prefetchQueue.get(url)?.[0]\n // only consume if request is in queue and is the queue \"head\"\n // if request is in the queue but not the head, the queue is being\n // consumed out of order and should be restarted\n if (!request || url !== this.#queueHeadUrl) return\n this.#prefetchQueue.delete(url)\n\n // fire off new prefetch since request has been consumed\n request\n .then((response) => {\n const nextUrl = getNextChunkUrl(url, response)\n this.#queueHeadUrl = nextUrl\n if (\n this.#queueTailUrl &&\n !this.#prefetchQueue.has(this.#queueTailUrl)\n ) {\n this.#prefetch(this.#queueTailUrl, args[1])\n }\n })\n .catch(() => {})\n\n return request\n }\n\n #prefetch(...args: Parameters<typeof fetch>): void {\n const url = args[0].toString()\n\n // only prefetch when queue is not full\n if (this.#prefetchQueue.size >= this.#maxPrefetchedRequests) return\n\n // initialize aborter per request, to avoid aborting consumed requests that\n // are still streaming their bodies to the consumer\n const aborter = new AbortController()\n\n try {\n const request = this.#fetchClient(url, {\n ...(args[1] ?? {}),\n signal: chainAborter(aborter, args[1]?.signal),\n })\n this.#prefetchQueue.set(url, [request, aborter])\n request\n .then((response) => {\n // only keep prefetching if response chain is uninterrupted\n if (!response.ok || aborter.signal.aborted) return\n\n const nextUrl = getNextChunkUrl(url, response)\n\n // only prefetch when there is a next URL\n if (!nextUrl || nextUrl === url) {\n this.#queueTailUrl = undefined\n return\n }\n\n this.#queueTailUrl = nextUrl\n return this.#prefetch(nextUrl, args[1])\n })\n .catch(() => {})\n } catch (_) {\n // ignore prefetch errors\n }\n }\n}\n\n/**\n * Generate the next chunk's URL if the url and response are valid\n */\nfunction getNextChunkUrl(url: string, res: Response): string | void {\n const shapeHandle = res.headers.get(SHAPE_HANDLE_HEADER)\n const lastOffset = res.headers.get(CHUNK_LAST_OFFSET_HEADER)\n const isUpToDate = res.headers.has(CHUNK_UP_TO_DATE_HEADER)\n\n // only prefetch if shape handle and offset for next chunk are available, and\n // response is not already up-to-date\n if (!shapeHandle || !lastOffset || isUpToDate) return\n\n const nextUrl = new URL(url)\n\n // don't prefetch live requests, rushing them will only\n // potentially miss more recent data\n if (nextUrl.searchParams.has(LIVE_QUERY_PARAM)) return\n\n nextUrl.searchParams.set(SHAPE_HANDLE_QUERY_PARAM, shapeHandle)\n nextUrl.searchParams.set(OFFSET_QUERY_PARAM, lastOffset)\n return nextUrl.toString()\n}\n\n/**\n * Chains an abort controller on an optional source signal's\n * aborted state - if the source signal is aborted, the provided abort\n * controller will also abort\n */\nfunction chainAborter(\n aborter: AbortController,\n sourceSignal?: AbortSignal | null\n): AbortSignal {\n if (!sourceSignal) return aborter.signal\n if (sourceSignal.aborted) aborter.abort()\n else\n sourceSignal.addEventListener(`abort`, () => aborter.abort(), {\n once: true,\n })\n return aborter.signal\n}\n","import {\n Message,\n Offset,\n Schema,\n Row,\n MaybePromise,\n GetExtensions,\n} from './types'\nimport { MessageParser, Parser } from './parser'\nimport { isUpToDateMessage } from './helpers'\nimport {\n FetchError,\n FetchBackoffAbortError,\n MissingShapeUrlError,\n InvalidSignalError,\n MissingShapeHandleError,\n ReservedParamError,\n} from './error'\nimport {\n BackoffDefaults,\n BackoffOptions,\n createFetchWithBackoff,\n createFetchWithChunkBuffer,\n createFetchWithResponseHeadersCheck,\n} from './fetch'\nimport {\n CHUNK_LAST_OFFSET_HEADER,\n LIVE_CACHE_BUSTER_HEADER,\n LIVE_CACHE_BUSTER_QUERY_PARAM,\n COLUMNS_QUERY_PARAM,\n LIVE_QUERY_PARAM,\n OFFSET_QUERY_PARAM,\n SHAPE_HANDLE_HEADER,\n SHAPE_HANDLE_QUERY_PARAM,\n SHAPE_SCHEMA_HEADER,\n WHERE_QUERY_PARAM,\n DATABASE_ID_QUERY_PARAM,\n TABLE_QUERY_PARAM,\n REPLICA_PARAM,\n} from './constants'\n\nconst RESERVED_PARAMS = new Set([\n DATABASE_ID_QUERY_PARAM,\n COLUMNS_QUERY_PARAM,\n LIVE_CACHE_BUSTER_QUERY_PARAM,\n SHAPE_HANDLE_QUERY_PARAM,\n LIVE_QUERY_PARAM,\n OFFSET_QUERY_PARAM,\n TABLE_QUERY_PARAM,\n WHERE_QUERY_PARAM,\n REPLICA_PARAM,\n])\n\ntype Replica = `full` | `default`\n\ntype ReservedParamKeys =\n | typeof DATABASE_ID_QUERY_PARAM\n | typeof COLUMNS_QUERY_PARAM\n | typeof LIVE_CACHE_BUSTER_QUERY_PARAM\n | typeof SHAPE_HANDLE_QUERY_PARAM\n | typeof LIVE_QUERY_PARAM\n | typeof OFFSET_QUERY_PARAM\n | typeof TABLE_QUERY_PARAM\n | typeof WHERE_QUERY_PARAM\n | typeof REPLICA_PARAM\n\ntype ParamsRecord = Omit<Record<string, string>, ReservedParamKeys>\n\ntype RetryOpts = {\n params?: ParamsRecord\n headers?: Record<string, string>\n}\ntype ShapeStreamErrorHandler = (\n error: Error\n) => void | RetryOpts | Promise<void | RetryOpts>\n\n/**\n * Options for constructing a ShapeStream.\n */\nexport interface ShapeStreamOptions<T = never> {\n /**\n * The full URL to where the Shape is served. This can either be the Electric server\n * directly or a proxy. E.g. for a local Electric instance, you might set `http://localhost:3000/v1/shape`\n */\n url: string\n\n /**\n * Which database to use.\n * This is optional unless Electric is used with multiple databases.\n */\n databaseId?: string\n\n /**\n * The root table for the shape. Passed as a query parameter. Not required if you set the table in your proxy.\n */\n table?: string\n\n /**\n * The where clauses for the shape.\n */\n where?: string\n\n /**\n * The columns to include in the shape.\n * Must include primary keys, and can only inlude valid columns.\n */\n columns?: string[]\n\n /**\n * If `replica` is `default` (the default) then Electric will only send the\n * changed columns in an update.\n *\n * If it's `full` Electric will send the entire row with both changed and\n * unchanged values.\n *\n * Setting `replica` to `full` will obviously result in higher bandwidth\n * usage and so is not recommended.\n */\n replica?: Replica\n\n /**\n * The \"offset\" on the shape log. This is typically not set as the ShapeStream\n * will handle this automatically. A common scenario where you might pass an offset\n * is if you're maintaining a local cache of the log. If you've gone offline\n * and are re-starting a ShapeStream to catch-up to the latest state of the Shape,\n * you'd pass in the last offset and shapeHandle you'd seen from the Electric server\n * so it knows at what point in the shape to catch you up from.\n */\n offset?: Offset\n\n /**\n * Similar to `offset`, this isn't typically used unless you're maintaining\n * a cache of the shape log.\n */\n handle?: string\n\n /**\n * HTTP headers to attach to requests made by the client.\n * Can be used for adding authentication headers.\n */\n headers?: Record<string, string>\n\n /**\n * Additional request parameters to attach to the URL.\n * These will be merged with Electric's standard parameters.\n * Note: You cannot use Electric's reserved parameter names\n * (table, where, columns, offset, handle, live, cursor, database_id, replica).\n */\n params?: ParamsRecord\n\n /**\n * Automatically fetch updates to the Shape. If you just want to sync the current\n * shape and stop, pass false.\n */\n subscribe?: boolean\n\n signal?: AbortSignal\n fetchClient?: typeof fetch\n backoffOptions?: BackoffOptions\n parser?: Parser<T>\n\n /**\n * A function for handling shapestream errors.\n * This is optional, when it is not provided any shapestream errors will be thrown.\n * If the function is provided and returns an object containing parameters and/or headers\n * the shapestream will apply those changes and try syncing again.\n * If the function returns void the shapestream is stopped.\n */\n onError?: ShapeStreamErrorHandler\n}\n\nexport interface ShapeStreamInterface<T extends Row<unknown> = Row> {\n subscribe(\n callback: (messages: Message<T>[]) => MaybePromise<void>,\n onError?: (error: FetchError | Error) => void\n ): void\n unsubscribeAll(): void\n\n isLoading(): boolean\n lastSyncedAt(): number | undefined\n lastSynced(): number\n isConnected(): boolean\n\n isUpToDate: boolean\n lastOffset: Offset\n shapeHandle?: string\n error?: unknown\n}\n\n/**\n * Reads updates to a shape from Electric using HTTP requests and long polling. Notifies subscribers\n * when new messages come in. Doesn't maintain any history of the\n * log but does keep track of the offset position and is the best way\n * to consume the HTTP `GET /v1/shape` api.\n *\n * @constructor\n * @param {ShapeStreamOptions} options - configure the shape stream\n * @example\n * Register a callback function to subscribe to the messages.\n * ```\n * const stream = new ShapeStream(options)\n * stream.subscribe(messages => {\n * // messages is 1 or more row updates\n * })\n * ```\n *\n * To abort the stream, abort the `signal`\n * passed in via the `ShapeStreamOptions`.\n * ```\n * const aborter = new AbortController()\n * const issueStream = new ShapeStream({\n * url: `${BASE_URL}/${table}`\n * subscribe: true,\n * signal: aborter.signal,\n * })\n * // Later...\n * aborter.abort()\n * ```\n */\n\nexport class ShapeStream<T extends Row<unknown> = Row>\n implements ShapeStreamInterface<T>\n{\n static readonly Replica = {\n FULL: `full` as Replica,\n DEFAULT: `default` as Replica,\n }\n\n readonly options: ShapeStreamOptions<GetExtensions<T>>\n #error: unknown = null\n\n readonly #fetchClient: typeof fetch\n readonly #messageParser: MessageParser<T>\n\n readonly #subscribers = new Map<\n number,\n [\n (messages: Message<T>[]) => MaybePromise<void>,\n ((error: Error) => void) | undefined,\n ]\n >()\n\n #lastOffset: Offset\n #liveCacheBuster: string // Seconds since our Electric Epoch 😎\n #lastSyncedAt?: number // unix time\n #isUpToDate: boolean = false\n #connected: boolean = false\n #shapeHandle?: string\n #databaseId?: string\n #schema?: Schema\n #onError?: ShapeStreamErrorHandler\n #replica?: Replica\n\n constructor(options: ShapeStreamOptions<GetExtensions<T>>) {\n this.options = { subscribe: true, ...options }\n validateOptions(this.options)\n this.#lastOffset = this.options.offset ?? `-1`\n this.#liveCacheBuster = ``\n this.#shapeHandle = this.options.handle\n this.#databaseId = this.options.databaseId\n this.#messageParser = new MessageParser<T>(options.parser)\n this.#replica = this.options.replica\n this.#onError = this.options.onError\n\n const baseFetchClient =\n options.fetchClient ??\n ((...args: Parameters<typeof fetch>) => fetch(...args))\n\n const fetchWithBackoffClient = createFetchWithBackoff(baseFetchClient, {\n ...(options.backoffOptions ?? BackoffDefaults),\n onFailedAttempt: () => {\n this.#connected = false\n options.backoffOptions?.onFailedAttempt?.()\n },\n })\n\n this.#fetchClient = createFetchWithResponseHeadersCheck(\n createFetchWithChunkBuffer(fetchWithBackoffClient)\n )\n\n this.#start()\n }\n\n get shapeHandle() {\n return this.#shapeHandle\n }\n\n get error() {\n return this.#error\n }\n\n get isUpToDate() {\n return this.#isUpToDate\n }\n\n get lastOffset() {\n return this.#lastOffset\n }\n\n async #start() {\n try {\n while (\n (!this.options.signal?.aborted && !this.#isUpToDate) ||\n this.options.subscribe\n ) {\n const { url, table, where, columns, signal } = this.options\n\n const fetchUrl = new URL(url)\n\n // Add any custom parameters first\n if (this.options.params) {\n // Check for reserved parameter names\n const reservedParams = Object.keys(this.options.params).filter(\n (key) => RESERVED_PARAMS.has(key)\n )\n if (reservedParams.length > 0) {\n throw new Error(\n `Cannot use reserved Electric parameter names in custom params: ${reservedParams.join(`, `)}`\n )\n }\n\n for (const [key, value] of Object.entries(this.options.params)) {\n fetchUrl.searchParams.set(key, value)\n }\n }\n\n // Add Electric's internal parameters\n if (table) fetchUrl.searchParams.set(TABLE_QUERY_PARAM, table)\n if (where) fetchUrl.searchParams.set(WHERE_QUERY_PARAM, where)\n if (columns && columns.length > 0)\n fetchUrl.searchParams.set(COLUMNS_QUERY_PARAM, columns.join(`,`))\n fetchUrl.searchParams.set(OFFSET_QUERY_PARAM, this.#lastOffset)\n\n if (this.#isUpToDate) {\n fetchUrl.searchParams.set(LIVE_QUERY_PARAM, `true`)\n fetchUrl.searchParams.set(\n LIVE_CACHE_BUSTER_QUERY_PARAM,\n this.#liveCacheBuster\n )\n }\n\n if (this.#shapeHandle) {\n // This should probably be a header for better cache breaking?\n fetchUrl.searchParams.set(\n SHAPE_HANDLE_QUERY_PARAM,\n this.#shapeHandle!\n )\n }\n\n if (this.#databaseId) {\n fetchUrl.searchParams.set(DATABASE_ID_QUERY_PARAM, this.#databaseId!)\n }\n\n if (\n (this.#replica ?? ShapeStream.Replica.DEFAULT) !=\n ShapeStream.Replica.DEFAULT\n ) {\n fetchUrl.searchParams.set(REPLICA_PARAM, this.#replica as string)\n }\n\n let response!: Response\n try {\n response = await this.#fetchClient(fetchUrl.toString(), {\n signal,\n headers: this.options.headers,\n })\n this.#connected = true\n } catch (e) {\n if (e instanceof FetchBackoffAbortError) break // interrupted\n if (!(e instanceof FetchError)) throw e // should never happen\n if (e.status == 409) {\n // Upon receiving a 409, we should start from scratch\n // with the newly provided shape handle\n const newShapeHandle = e.headers[SHAPE_HANDLE_HEADER]\n this.#reset(newShapeHandle)\n await this.#publish(e.json as Message<T>[])\n continue\n } else if (e.status >= 400 && e.status < 500) {\n // Notify subscribers\n this.#sendErrorToSubscribers(e)\n\n // 400 errors are not actionable without additional user input,\n // so we exit the loop\n throw e\n }\n }\n\n const { headers, status } = response\n const shapeHandle = headers.get(SHAPE_HANDLE_HEADER)\n if (shapeHandle) {\n this.#shapeHandle = shapeHandle\n }\n\n const lastOffset = headers.get(CHUNK_LAST_OFFSET_HEADER)\n if (lastOffset) {\n this.#lastOffset = lastOffset as Offset\n }\n\n const liveCacheBuster = headers.get(LIVE_CACHE_BUSTER_HEADER)\n if (liveCacheBuster) {\n this.#liveCacheBuster = liveCacheBuster\n }\n\n const getSchema = (): Schema => {\n const schemaHeader = headers.get(SHAPE_SCHEMA_HEADER)\n return schemaHeader ? JSON.parse(schemaHeader) : {}\n }\n this.#schema = this.#schema ?? getSchema()\n\n const messages = status === 204 ? `[]` : await response.text()\n\n if (status === 204) {\n // There's no content so we are live and up to date\n this.#lastSyncedAt = Date.now()\n }\n\n const batch = this.#messageParser.parse(messages, this.#schema)\n\n // Update isUpToDate\n if (batch.length > 0) {\n const lastMessage = batch[batch.length - 1]\n if (isUpToDateMessage(lastMessage)) {\n this.#lastSyncedAt = Date.now()\n this.#isUpToDate = true\n }\n\n await this.#publish(batch)\n }\n }\n } catch (err) {\n this.#error = err\n if (this.#onError) {\n const retryOpts = await this.#onError(err as Error)\n if (typeof retryOpts === `object`) {\n this.#reset()\n\n if (`params` in retryOpts) {\n this.options.params = retryOpts.params\n }\n\n if (`headers` in retryOpts) {\n this.options.headers = retryOpts.headers\n }\n\n // Restart\n this.#start()\n }\n return\n }\n\n // If no handler is provided for errors just throw so the error still bubbles up.\n throw err\n } finally {\n this.#connected = false\n }\n }\n\n subscribe(\n callback: (messages: Message<T>[]) => MaybePromise<void>,\n onError: (error: Error) => void = () => {}\n ) {\n const subscriptionId = Math.random()\n\n this.#subscribers.set(subscriptionId, [callback, onError])\n\n return () => {\n this.#subscribers.delete(subscriptionId)\n }\n }\n\n unsubscribeAll(): void {\n this.#subscribers.clear()\n }\n\n /** Unix time at which we last synced. Undefined when `isLoading` is true. */\n lastSyncedAt(): number | undefined {\n return this.#lastSyncedAt\n }\n\n /** Time elapsed since last sync (in ms). Infinity if we did not yet sync. */\n lastSynced(): number {\n if (this.#lastSyncedAt === undefined) return Infinity\n return Date.now() - this.#lastSyncedAt\n }\n\n /** Indicates if we are connected to the Electric sync service. */\n isConnected(): boolean {\n return this.#connected\n }\n\n /** True during initial fetch. False afterwise. */\n isLoading(): boolean {\n return !this.#isUpToDate\n }\n\n async #publish(messages: Message<T>[]): Promise<void> {\n await Promise.all(\n Array.from(this.#subscribers.values()).map(async ([callback, __]) => {\n try {\n await callback(messages)\n } catch (err) {\n queueMicrotask(() => {\n throw err\n })\n }\n })\n )\n }\n\n #sendErrorToSubscribers(error: Error) {\n this.#subscribers.forEach(([_, errorFn]) => {\n errorFn?.(error)\n })\n }\n\n /**\n * Resets the state of the stream, optionally with a provided\n * shape handle\n */\n #reset(handle?: string) {\n this.#lastOffset = `-1`\n this.#liveCacheBuster = ``\n this.#shapeHandle = handle\n this.#isUpToDate = false\n this.#connected = false\n this.#schema = undefined\n }\n}\n\nfunction validateOptions<T>(options: Partial<ShapeStreamOptions<T>>): void {\n if (!options.url) {\n throw new MissingShapeUrlError()\n }\n if (options.signal && !(options.signal instanceof AbortSignal)) {\n throw new InvalidSignalError()\n }\n\n if (\n options.offset !== undefined &&\n options.offset !== `-1` &&\n !options.handle\n ) {\n throw new MissingShapeHandleError()\n }\n\n // Check for reserved parameter names\n if (options.params) {\n const reservedParams = Object.keys(options.params).filter((key) =>\n RESERVED_PARAMS.has(key)\n )\n if (reservedParams.length > 0) {\n throw new ReservedParamError(reservedParams)\n }\n }\n return\n}\n","import { Message, Offset, Row } from './types'\nimport { isChangeMessage, isControlMessage } from './helpers'\nimport { FetchError } from './error'\nimport { ShapeStreamInterface } from './client'\n\nexport type ShapeData<T extends Row<unknown> = Row> = Map<string, T>\nexport type ShapeChangedCallback<T extends Row<unknown> = Row> = (data: {\n value: ShapeData<T>\n rows: T[]\n}) => void\n\n/**\n * A Shape is an object that subscribes to a shape log,\n * keeps a materialised shape `.rows` in memory and\n * notifies subscribers when the value has changed.\n *\n * It can be used without a framework and as a primitive\n * to simplify developing framework hooks.\n *\n * @constructor\n * @param {ShapeStream<T extends Row>} - the underlying shape stream\n * @example\n * ```\n * const shapeStream = new ShapeStream<{ foo: number }>(url: `http://localhost:3000/v1/shape`, table: `foo`})\n * const shape = new Shape(shapeStream)\n * ```\n *\n * `rows` returns a promise that resolves the Shape data once the Shape has been\n * fully loaded (and when resuming from being offline):\n *\n * const rows = await shape.rows\n *\n * `currentRows` returns the current data synchronously:\n *\n * const rows = shape.currentRows\n *\n * Subscribe to updates. Called whenever the shape updates in Postgres.\n *\n * shape.subscribe(({ rows }) => {\n * console.log(rows)\n * })\n */\nexport class Shape<T extends Row<unknown> = Row> {\n readonly #stream: ShapeStreamInterface<T>\n\n readonly #data: ShapeData<T> = new Map()\n readonly #subscribers = new Map<number, ShapeChangedCallback<T>>()\n\n #hasNotifiedSubscribersUpToDate: boolean = false\n #error: FetchError | false = false\n\n constructor(stream: ShapeStreamInterface<T>) {\n this.#stream = stream\n this.#stream.subscribe(\n this.#process.bind(this),\n this.#handleError.bind(this)\n )\n }\n\n get isUpToDate(): boolean {\n return this.#stream.isUpToDate\n }\n\n get lastOffset(): Offset {\n return this.#stream.lastOffset\n }\n\n get handle(): string | undefined {\n return this.#stream.shapeHandle\n }\n\n get rows(): Promise<T[]> {\n return this.value.then((v) => Array.from(v.values()))\n }\n\n get currentRows(): T[] {\n return Array.from(this.currentValue.values())\n }\n\n get value(): Promise<ShapeData<T>> {\n return new Promise((resolve, reject) => {\n if (this.#stream.isUpToDate) {\n resolve(this.currentValue)\n } else {\n const unsubscribe = this.subscribe(({ value }) => {\n unsubscribe()\n if (this.#error) reject(this.#error)\n resolve(value)\n })\n }\n })\n }\n\n get currentValue() {\n return this.#data\n }\n\n get error() {\n return this.#error\n }\n\n /** Unix time at which we last synced. Undefined when `isLoading` is true. */\n lastSyncedAt(): number | undefined {\n return this.#stream.lastSyncedAt()\n }\n\n /** Time elapsed since last sync (in ms). Infinity if we did not yet sync. */\n lastSynced() {\n return this.#stream.lastSynced()\n }\n\n /** True during initial fetch. False afterwise. */\n isLoading() {\n return this.#stream.isLoading()\n }\n\n /** Indicates if we are connected to the Electric sync service. */\n isConnected(): boolean {\n return this.#stream.isConnected()\n }\n\n subscribe(callback: ShapeChangedCallback<T>): () => void {\n const subscriptionId = Math.random()\n\n this.#subscribers.set(subscriptionId, callback)\n\n return () => {\n this.#subscribers.delete(subscriptionId)\n }\n }\n\n unsubscribeAll(): void {\n this.#subscribers.clear()\n }\n\n get numSubscribers() {\n return this.#subscribers.size\n }\n\n #process(messages: Message<T>[]): void {\n let dataMayHaveChanged = false\n let isUpToDate = false\n let newlyUpToDate = false\n\n messages.forEach((message) => {\n if (isChangeMessage(message)) {\n dataMayHaveChanged = [`insert`, `update`, `delete`].includes(\n message.headers.operation\n )\n\n switch (message.headers.operation) {\n case `insert`:\n this.#data.set(message.key, message.value)\n break\n case `update`:\n this.#data.set(message.key, {\n ...this.#data.get(message.key)!,\n ...message.value,\n })\n break\n case `delete`:\n this.#data.delete(message.key)\n break\n }\n }\n\n if (isControlMessage(message)) {\n switch (message.headers.control) {\n case `up-to-date`:\n isUpToDate = true\n if (!this.#hasNotifiedSubscribersUpToDate) {\n newlyUpToDate = true\n }\n break\n case `must-refetch`:\n this.#data.clear()\n this.#error = false\n this.#hasNotifiedSubscribersUpToDate = false\n isUpToDate = false\n newlyUpToDate = false\n break\n }\n }\n })\n\n // Always notify subscribers when the Shape first is up to date.\n // FIXME this would be cleaner with a simple state machine.\n if (newlyUpToDate || (isUpToDate && dataMayHaveChanged)) {\n this.#hasNotifiedSubscribersUpToDate = true\n this.#notify()\n }\n }\n\n #handleError(e: Error): void {\n if (e instanceof FetchError) {\n this.#error = e\n this.#notify()\n }\n }\n\n #notify(): void {\n this.#subscribers.forEach((callback) => {\n callback({ value: this.currentValue, rows: this.currentRows })\n })\n }\n}\n"],"mappings":"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","names":["key","value","_fetchClient","_a","_b","_subscribers","_error"]}
|
|
1
|
+
{"version":3,"sources":["../../src/index.ts","../../src/error.ts","../../src/parser.ts","../../src/helpers.ts","../../src/constants.ts","../../src/fetch.ts","../../src/client.ts","../../src/shape.ts"],"sourcesContent":["export * from './client'\nexport * from './shape'\nexport * from './types'\nexport { isChangeMessage, isControlMessage } from './helpers'\nexport { FetchError } from './error'\nexport { type BackoffOptions, BackoffDefaults } from './fetch'\n","export class FetchError extends Error {\n status: number\n text?: string\n json?: object\n headers: Record<string, string>\n\n constructor(\n status: number,\n text: string | undefined,\n json: object | undefined,\n headers: Record<string, string>,\n public url: string,\n message?: string\n ) {\n super(\n message ||\n `HTTP Error ${status} at ${url}: ${text ?? JSON.stringify(json)}`\n )\n this.name = `FetchError`\n this.status = status\n this.text = text\n this.json = json\n this.headers = headers\n }\n\n static async fromResponse(\n response: Response,\n url: string\n ): Promise<FetchError> {\n const status = response.status\n const headers = Object.fromEntries([...response.headers.entries()])\n let text: string | undefined = undefined\n let json: object | undefined = undefined\n\n const contentType = response.headers.get(`content-type`)\n if (contentType && contentType.includes(`application/json`)) {\n json = (await response.json()) as object\n } else {\n text = await response.text()\n }\n\n return new FetchError(status, text, json, headers, url)\n }\n}\n\nexport class FetchBackoffAbortError extends Error {\n constructor() {\n super(`Fetch with backoff aborted`)\n this.name = `FetchBackoffAbortError`\n }\n}\n\nexport class InvalidShapeOptionsError extends Error {\n constructor(message: string) {\n super(message)\n this.name = `InvalidShapeOptionsError`\n }\n}\n\nexport class MissingShapeUrlError extends Error {\n constructor() {\n super(`Invalid shape options: missing required url parameter`)\n this.name = `MissingShapeUrlError`\n }\n}\n\nexport class InvalidSignalError extends Error {\n constructor() {\n super(`Invalid signal option. It must be an instance of AbortSignal.`)\n this.name = `InvalidSignalError`\n }\n}\n\nexport class MissingShapeHandleError extends Error {\n constructor() {\n super(\n `shapeHandle is required if this isn't an initial fetch (i.e. offset > -1)`\n )\n this.name = `MissingShapeHandleError`\n }\n}\n\nexport class ReservedParamError extends Error {\n constructor(reservedParams: string[]) {\n super(\n `Cannot use reserved Electric parameter names in custom params: ${reservedParams.join(`, `)}`\n )\n this.name = `ReservedParamError`\n }\n}\n\nexport class ParserNullValueError extends Error {\n constructor(columnName: string) {\n super(`Column \"${columnName ?? `unknown`}\" does not allow NULL values`)\n this.name = `ParserNullValueError`\n }\n}\n\nexport class ShapeStreamAlreadyRunningError extends Error {\n constructor() {\n super(`ShapeStream is already running`)\n this.name = `ShapeStreamAlreadyRunningError`\n }\n}\n\nexport class MissingHeadersError extends Error {\n constructor(url: string, missingHeaders: Array<string>) {\n let msg = `The response for the shape request to ${url} didn't include the following required headers:\\n`\n missingHeaders.forEach((h) => {\n msg += `- ${h}\\n`\n })\n msg += `\\nThis is often due to a proxy not setting CORS correctly so that all Electric headers can be read by the client.`\n msg += `\\nFor more information visit the troubleshooting guide: /docs/guides/troubleshooting/missing-headers`\n super(msg)\n }\n}\n","import { ColumnInfo, GetExtensions, Message, Row, Schema, Value } from './types'\nimport { ParserNullValueError } from './error'\n\ntype NullToken = null | `NULL`\ntype Token = Exclude<string, NullToken>\ntype NullableToken = Token | NullToken\nexport type ParseFunction<Extensions = never> = (\n value: Token,\n additionalInfo?: Omit<ColumnInfo, `type` | `dims`>\n) => Value<Extensions>\ntype NullableParseFunction<Extensions = never> = (\n value: NullableToken,\n additionalInfo?: Omit<ColumnInfo, `type` | `dims`>\n) => Value<Extensions>\n/**\n * @typeParam Extensions - Additional types that can be parsed by this parser beyond the standard SQL types.\n * Defaults to no additional types.\n */\nexport type Parser<Extensions = never> = {\n [key: string]: ParseFunction<Extensions>\n}\n\nconst parseNumber = (value: string) => Number(value)\nconst parseBool = (value: string) => value === `true` || value === `t`\nconst parseBigInt = (value: string) => BigInt(value)\nconst parseJson = (value: string) => JSON.parse(value)\nconst identityParser: ParseFunction = (v: string) => v\n\nexport const defaultParser: Parser = {\n int2: parseNumber,\n int4: parseNumber,\n int8: parseBigInt,\n bool: parseBool,\n float4: parseNumber,\n float8: parseNumber,\n json: parseJson,\n jsonb: parseJson,\n}\n\n// Taken from: https://github.com/electric-sql/pglite/blob/main/packages/pglite/src/types.ts#L233-L279\nexport function pgArrayParser<Extensions>(\n value: Token,\n parser?: ParseFunction<Extensions>\n): Value<Extensions> {\n let i = 0\n let char = null\n let str = ``\n let quoted = false\n let last = 0\n let p: string | undefined = undefined\n\n function loop(x: string): Array<Value<Extensions>> {\n const xs = []\n for (; i < x.length; i++) {\n char = x[i]\n if (quoted) {\n if (char === `\\\\`) {\n str += x[++i]\n } else if (char === `\"`) {\n xs.push(parser ? parser(str) : str)\n str = ``\n quoted = x[i + 1] === `\"`\n last = i + 2\n } else {\n str += char\n }\n } else if (char === `\"`) {\n quoted = true\n } else if (char === `{`) {\n last = ++i\n xs.push(loop(x))\n } else if (char === `}`) {\n quoted = false\n last < i &&\n xs.push(parser ? parser(x.slice(last, i)) : x.slice(last, i))\n last = i + 1\n break\n } else if (char === `,` && p !== `}` && p !== `\"`) {\n xs.push(parser ? parser(x.slice(last, i)) : x.slice(last, i))\n last = i + 1\n }\n p = char\n }\n last < i &&\n xs.push(parser ? parser(x.slice(last, i + 1)) : x.slice(last, i + 1))\n return xs\n }\n\n return loop(value)[0]\n}\n\nexport class MessageParser<T extends Row<unknown>> {\n private parser: Parser<GetExtensions<T>>\n constructor(parser?: Parser<GetExtensions<T>>) {\n // Merge the provided parser with the default parser\n // to use the provided parser whenever defined\n // and otherwise fall back to the default parser\n this.parser = { ...defaultParser, ...parser }\n }\n\n parse(messages: string, schema: Schema): Message<T>[] {\n return JSON.parse(messages, (key, value) => {\n // typeof value === `object` && value !== null\n // is needed because there could be a column named `value`\n // and the value associated to that column will be a string or null.\n // But `typeof null === 'object'` so we need to make an explicit check.\n if (key === `value` && typeof value === `object` && value !== null) {\n // Parse the row values\n const row = value as Record<string, Value<GetExtensions<T>>>\n Object.keys(row).forEach((key) => {\n row[key] = this.parseRow(key, row[key] as NullableToken, schema)\n })\n }\n return value\n }) as Message<T>[]\n }\n\n // Parses the message values using the provided parser based on the schema information\n private parseRow(\n key: string,\n value: NullableToken,\n schema: Schema\n ): Value<GetExtensions<T>> {\n const columnInfo = schema[key]\n if (!columnInfo) {\n // We don't have information about the value\n // so we just return it\n return value\n }\n\n // Copy the object but don't include `dimensions` and `type`\n const { type: typ, dims: dimensions, ...additionalInfo } = columnInfo\n\n // Pick the right parser for the type\n // and support parsing null values if needed\n // if no parser is provided for the given type, just return the value as is\n const typeParser = this.parser[typ] ?? identityParser\n const parser = makeNullableParser(typeParser, columnInfo, key)\n\n if (dimensions && dimensions > 0) {\n // It's an array\n const nullablePgArrayParser = makeNullableParser(\n (value, _) => pgArrayParser(value, parser),\n columnInfo,\n key\n )\n return nullablePgArrayParser(value)\n }\n\n return parser(value, additionalInfo)\n }\n}\n\nfunction makeNullableParser<Extensions>(\n parser: ParseFunction<Extensions>,\n columnInfo: ColumnInfo,\n columnName?: string\n): NullableParseFunction<Extensions> {\n const isNullable = !(columnInfo.not_null ?? false)\n // The sync service contains `null` value for a column whose value is NULL\n // but if the column value is an array that contains a NULL value\n // then it will be included in the array string as `NULL`, e.g.: `\"{1,NULL,3}\"`\n return (value: NullableToken) => {\n if (isPgNull(value)) {\n if (!isNullable) {\n throw new ParserNullValueError(columnName ?? `unknown`)\n }\n return null\n }\n return parser(value, columnInfo)\n }\n}\n\nfunction isPgNull(value: NullableToken): value is NullToken {\n return value === null || value === `NULL`\n}\n","import { ChangeMessage, ControlMessage, Message, Row } from './types'\n\n/**\n * Type guard for checking {@link Message} is {@link ChangeMessage}.\n *\n * See [TS docs](https://www.typescriptlang.org/docs/handbook/advanced-types.html#user-defined-type-guards)\n * for information on how to use type guards.\n *\n * @param message - the message to check\n * @returns true if the message is a {@link ChangeMessage}\n *\n * @example\n * ```ts\n * if (isChangeMessage(message)) {\n * const msgChng: ChangeMessage = message // Ok\n * const msgCtrl: ControlMessage = message // Err, type mismatch\n * }\n * ```\n */\nexport function isChangeMessage<T extends Row<unknown> = Row>(\n message: Message<T>\n): message is ChangeMessage<T> {\n return `key` in message\n}\n\n/**\n * Type guard for checking {@link Message} is {@link ControlMessage}.\n *\n * See [TS docs](https://www.typescriptlang.org/docs/handbook/advanced-types.html#user-defined-type-guards)\n * for information on how to use type guards.\n *\n * @param message - the message to check\n * @returns true if the message is a {@link ControlMessage}\n *\n * * @example\n * ```ts\n * if (isControlMessage(message)) {\n * const msgChng: ChangeMessage = message // Err, type mismatch\n * const msgCtrl: ControlMessage = message // Ok\n * }\n * ```\n */\nexport function isControlMessage<T extends Row<unknown> = Row>(\n message: Message<T>\n): message is ControlMessage {\n return !isChangeMessage(message)\n}\n\nexport function isUpToDateMessage<T extends Row<unknown> = Row>(\n message: Message<T>\n): message is ControlMessage & { up_to_date: true } {\n return isControlMessage(message) && message.headers.control === `up-to-date`\n}\n","export const LIVE_CACHE_BUSTER_HEADER = `electric-cursor`\nexport const SHAPE_HANDLE_HEADER = `electric-handle`\nexport const CHUNK_LAST_OFFSET_HEADER = `electric-offset`\nexport const SHAPE_SCHEMA_HEADER = `electric-schema`\nexport const CHUNK_UP_TO_DATE_HEADER = `electric-up-to-date`\nexport const COLUMNS_QUERY_PARAM = `columns`\nexport const LIVE_CACHE_BUSTER_QUERY_PARAM = `cursor`\nexport const SHAPE_HANDLE_QUERY_PARAM = `handle`\nexport const LIVE_QUERY_PARAM = `live`\nexport const OFFSET_QUERY_PARAM = `offset`\nexport const TABLE_QUERY_PARAM = `table`\nexport const WHERE_QUERY_PARAM = `where`\nexport const REPLICA_PARAM = `replica`\n","import {\n CHUNK_LAST_OFFSET_HEADER,\n CHUNK_UP_TO_DATE_HEADER,\n LIVE_QUERY_PARAM,\n OFFSET_QUERY_PARAM,\n SHAPE_HANDLE_HEADER,\n SHAPE_HANDLE_QUERY_PARAM,\n} from './constants'\nimport {\n FetchError,\n FetchBackoffAbortError,\n MissingHeadersError,\n} from './error'\n\n// Some specific 4xx and 5xx HTTP status codes that we definitely\n// want to retry\nconst HTTP_RETRY_STATUS_CODES = [429]\n\nexport interface BackoffOptions {\n /**\n * Initial delay before retrying in milliseconds\n */\n initialDelay: number\n /**\n * Maximum retry delay in milliseconds\n */\n maxDelay: number\n multiplier: number\n onFailedAttempt?: () => void\n debug?: boolean\n}\n\nexport const BackoffDefaults = {\n initialDelay: 100,\n maxDelay: 10_000,\n multiplier: 1.3,\n}\n\nexport function createFetchWithBackoff(\n fetchClient: typeof fetch,\n backoffOptions: BackoffOptions = BackoffDefaults\n): typeof fetch {\n const {\n initialDelay,\n maxDelay,\n multiplier,\n debug = false,\n onFailedAttempt,\n } = backoffOptions\n return async (...args: Parameters<typeof fetch>): Promise<Response> => {\n const url = args[0]\n const options = args[1]\n\n let delay = initialDelay\n let attempt = 0\n\n /* eslint-disable no-constant-condition -- we re-fetch the shape log\n * continuously until we get a non-ok response. For recoverable errors,\n * we retry the fetch with exponential backoff. Users can pass in an\n * AbortController to abort the fetching an any point.\n * */\n while (true) {\n /* eslint-enable no-constant-condition */\n try {\n const result = await fetchClient(...args)\n if (result.ok) return result\n else throw await FetchError.fromResponse(result, url.toString())\n } catch (e) {\n onFailedAttempt?.()\n if (options?.signal?.aborted) {\n throw new FetchBackoffAbortError()\n } else if (\n e instanceof FetchError &&\n !HTTP_RETRY_STATUS_CODES.includes(e.status) &&\n e.status >= 400 &&\n e.status < 500\n ) {\n // Any client errors cannot be backed off on, leave it to the caller to handle.\n throw e\n } else {\n // Exponentially backoff on errors.\n // Wait for the current delay duration\n await new Promise((resolve) => setTimeout(resolve, delay))\n\n // Increase the delay for the next attempt\n delay = Math.min(delay * multiplier, maxDelay)\n\n if (debug) {\n attempt++\n console.log(`Retry attempt #${attempt} after ${delay}ms`)\n }\n }\n }\n }\n }\n}\n\ninterface ChunkPrefetchOptions {\n maxChunksToPrefetch: number\n}\n\nconst ChunkPrefetchDefaults = {\n maxChunksToPrefetch: 2,\n}\n\n/**\n * Creates a fetch client that prefetches subsequent log chunks for\n * consumption by the shape stream without waiting for the chunk bodies\n * themselves to be loaded.\n *\n * @param fetchClient the client to wrap\n * @param prefetchOptions options to configure prefetching\n * @returns wrapped client with prefetch capabilities\n */\nexport function createFetchWithChunkBuffer(\n fetchClient: typeof fetch,\n prefetchOptions: ChunkPrefetchOptions = ChunkPrefetchDefaults\n): typeof fetch {\n const { maxChunksToPrefetch } = prefetchOptions\n\n let prefetchQueue: PrefetchQueue\n\n const prefetchClient = async (...args: Parameters<typeof fetchClient>) => {\n const url = args[0].toString()\n\n // try to consume from the prefetch queue first, and if request is\n // not present abort the prefetch queue as it must no longer be valid\n const prefetchedRequest = prefetchQueue?.consume(...args)\n if (prefetchedRequest) {\n return prefetchedRequest\n }\n\n prefetchQueue?.abort()\n\n // perform request and fire off prefetch queue if request is eligible\n const response = await fetchClient(...args)\n const nextUrl = getNextChunkUrl(url, response)\n if (nextUrl) {\n prefetchQueue = new PrefetchQueue({\n fetchClient,\n maxPrefetchedRequests: maxChunksToPrefetch,\n url: nextUrl,\n requestInit: args[1],\n })\n }\n\n return response\n }\n\n return prefetchClient\n}\n\nexport const requiredElectricResponseHeaders = [\n `electric-offset`,\n `electric-handle`,\n]\n\nexport const requiredLiveResponseHeaders = [`electric-cursor`]\n\nexport const requiredNonLiveResponseHeaders = [`electric-schema`]\n\nexport function createFetchWithResponseHeadersCheck(\n fetchClient: typeof fetch\n): typeof fetch {\n return async (...args: Parameters<typeof fetchClient>) => {\n const response = await fetchClient(...args)\n\n if (response.ok) {\n // Check that the necessary Electric headers are present on the response\n const headers = response.headers\n const missingHeaders: Array<string> = []\n\n const addMissingHeaders = (requiredHeaders: Array<string>) =>\n missingHeaders.push(...requiredHeaders.filter((h) => !headers.has(h)))\n addMissingHeaders(requiredElectricResponseHeaders)\n\n const input = args[0]\n const urlString = input.toString()\n const url = new URL(urlString)\n if (url.searchParams.has(LIVE_QUERY_PARAM, `true`)) {\n addMissingHeaders(requiredLiveResponseHeaders)\n }\n\n if (\n !url.searchParams.has(LIVE_QUERY_PARAM) ||\n url.searchParams.has(LIVE_QUERY_PARAM, `false`)\n ) {\n addMissingHeaders(requiredNonLiveResponseHeaders)\n }\n\n if (missingHeaders.length > 0) {\n throw new MissingHeadersError(urlString, missingHeaders)\n }\n }\n\n return response\n }\n}\n\nclass PrefetchQueue {\n readonly #fetchClient: typeof fetch\n readonly #maxPrefetchedRequests: number\n readonly #prefetchQueue = new Map<\n string,\n [Promise<Response>, AbortController]\n >()\n #queueHeadUrl: string | void\n #queueTailUrl: string | void\n\n constructor(options: {\n url: Parameters<typeof fetch>[0]\n requestInit: Parameters<typeof fetch>[1]\n maxPrefetchedRequests: number\n fetchClient?: typeof fetch\n }) {\n this.#fetchClient =\n options.fetchClient ??\n ((...args: Parameters<typeof fetch>) => fetch(...args))\n this.#maxPrefetchedRequests = options.maxPrefetchedRequests\n this.#queueHeadUrl = options.url.toString()\n this.#queueTailUrl = this.#queueHeadUrl\n this.#prefetch(options.url, options.requestInit)\n }\n\n abort(): void {\n this.#prefetchQueue.forEach(([_, aborter]) => aborter.abort())\n }\n\n consume(...args: Parameters<typeof fetch>): Promise<Response> | void {\n const url = args[0].toString()\n\n const request = this.#prefetchQueue.get(url)?.[0]\n // only consume if request is in queue and is the queue \"head\"\n // if request is in the queue but not the head, the queue is being\n // consumed out of order and should be restarted\n if (!request || url !== this.#queueHeadUrl) return\n this.#prefetchQueue.delete(url)\n\n // fire off new prefetch since request has been consumed\n request\n .then((response) => {\n const nextUrl = getNextChunkUrl(url, response)\n this.#queueHeadUrl = nextUrl\n if (\n this.#queueTailUrl &&\n !this.#prefetchQueue.has(this.#queueTailUrl)\n ) {\n this.#prefetch(this.#queueTailUrl, args[1])\n }\n })\n .catch(() => {})\n\n return request\n }\n\n #prefetch(...args: Parameters<typeof fetch>): void {\n const url = args[0].toString()\n\n // only prefetch when queue is not full\n if (this.#prefetchQueue.size >= this.#maxPrefetchedRequests) return\n\n // initialize aborter per request, to avoid aborting consumed requests that\n // are still streaming their bodies to the consumer\n const aborter = new AbortController()\n\n try {\n const request = this.#fetchClient(url, {\n ...(args[1] ?? {}),\n signal: chainAborter(aborter, args[1]?.signal),\n })\n this.#prefetchQueue.set(url, [request, aborter])\n request\n .then((response) => {\n // only keep prefetching if response chain is uninterrupted\n if (!response.ok || aborter.signal.aborted) return\n\n const nextUrl = getNextChunkUrl(url, response)\n\n // only prefetch when there is a next URL\n if (!nextUrl || nextUrl === url) {\n this.#queueTailUrl = undefined\n return\n }\n\n this.#queueTailUrl = nextUrl\n return this.#prefetch(nextUrl, args[1])\n })\n .catch(() => {})\n } catch (_) {\n // ignore prefetch errors\n }\n }\n}\n\n/**\n * Generate the next chunk's URL if the url and response are valid\n */\nfunction getNextChunkUrl(url: string, res: Response): string | void {\n const shapeHandle = res.headers.get(SHAPE_HANDLE_HEADER)\n const lastOffset = res.headers.get(CHUNK_LAST_OFFSET_HEADER)\n const isUpToDate = res.headers.has(CHUNK_UP_TO_DATE_HEADER)\n\n // only prefetch if shape handle and offset for next chunk are available, and\n // response is not already up-to-date\n if (!shapeHandle || !lastOffset || isUpToDate) return\n\n const nextUrl = new URL(url)\n\n // don't prefetch live requests, rushing them will only\n // potentially miss more recent data\n if (nextUrl.searchParams.has(LIVE_QUERY_PARAM)) return\n\n nextUrl.searchParams.set(SHAPE_HANDLE_QUERY_PARAM, shapeHandle)\n nextUrl.searchParams.set(OFFSET_QUERY_PARAM, lastOffset)\n nextUrl.searchParams.sort()\n return nextUrl.toString()\n}\n\n/**\n * Chains an abort controller on an optional source signal's\n * aborted state - if the source signal is aborted, the provided abort\n * controller will also abort\n */\nfunction chainAborter(\n aborter: AbortController,\n sourceSignal?: AbortSignal | null\n): AbortSignal {\n if (!sourceSignal) return aborter.signal\n if (sourceSignal.aborted) aborter.abort()\n else\n sourceSignal.addEventListener(`abort`, () => aborter.abort(), {\n once: true,\n })\n return aborter.signal\n}\n","import {\n Message,\n Offset,\n Schema,\n Row,\n MaybePromise,\n GetExtensions,\n} from './types'\nimport { MessageParser, Parser } from './parser'\nimport { isUpToDateMessage } from './helpers'\nimport {\n FetchError,\n FetchBackoffAbortError,\n MissingShapeUrlError,\n InvalidSignalError,\n MissingShapeHandleError,\n ReservedParamError,\n} from './error'\nimport {\n BackoffDefaults,\n BackoffOptions,\n createFetchWithBackoff,\n createFetchWithChunkBuffer,\n createFetchWithResponseHeadersCheck,\n} from './fetch'\nimport {\n CHUNK_LAST_OFFSET_HEADER,\n LIVE_CACHE_BUSTER_HEADER,\n LIVE_CACHE_BUSTER_QUERY_PARAM,\n COLUMNS_QUERY_PARAM,\n LIVE_QUERY_PARAM,\n OFFSET_QUERY_PARAM,\n SHAPE_HANDLE_HEADER,\n SHAPE_HANDLE_QUERY_PARAM,\n SHAPE_SCHEMA_HEADER,\n WHERE_QUERY_PARAM,\n TABLE_QUERY_PARAM,\n REPLICA_PARAM,\n} from './constants'\n\nconst RESERVED_PARAMS = new Set([\n LIVE_CACHE_BUSTER_QUERY_PARAM,\n SHAPE_HANDLE_QUERY_PARAM,\n LIVE_QUERY_PARAM,\n OFFSET_QUERY_PARAM,\n])\n\ntype Replica = `full` | `default`\n\n/**\n * PostgreSQL-specific shape parameters that can be provided externally\n */\ntype PostgresParams = {\n /** The root table for the shape. Not required if you set the table in your proxy. */\n table?: string\n\n /**\n * The columns to include in the shape.\n * Must include primary keys, and can only include valid columns.\n */\n columns?: string[]\n\n /** The where clauses for the shape */\n where?: string\n\n /**\n * If `replica` is `default` (the default) then Electric will only send the\n * changed columns in an update.\n *\n * If it's `full` Electric will send the entire row with both changed and\n * unchanged values.\n *\n * Setting `replica` to `full` will result in higher bandwidth\n * usage and so is not generally recommended.\n */\n replica?: Replica\n}\n\ntype ReservedParamKeys =\n | typeof COLUMNS_QUERY_PARAM\n | typeof LIVE_CACHE_BUSTER_QUERY_PARAM\n | typeof SHAPE_HANDLE_QUERY_PARAM\n | typeof LIVE_QUERY_PARAM\n | typeof OFFSET_QUERY_PARAM\n | typeof TABLE_QUERY_PARAM\n | typeof WHERE_QUERY_PARAM\n | typeof REPLICA_PARAM\n\n/**\n * External params type - what users provide.\n * Includes documented PostgreSQL params and allows string or string[] values for any additional params.\n */\ntype ExternalParamsRecord = Partial<PostgresParams> & {\n [K in string as K extends ReservedParamKeys ? never : K]: string | string[]\n}\n\n/**\n * Internal params type - used within the library.\n * All values are converted to strings.\n */\ntype InternalParamsRecord = {\n [K in string as K extends ReservedParamKeys ? never : K]: string\n}\n\n/**\n * Helper function to convert external params to internal format\n */\nfunction toInternalParams(params: ExternalParamsRecord): InternalParamsRecord {\n const result: InternalParamsRecord = {}\n for (const [key, value] of Object.entries(params)) {\n result[key] = Array.isArray(value) ? value.join(`,`) : value\n }\n return result\n}\n\ntype RetryOpts = {\n params?: ExternalParamsRecord\n headers?: Record<string, string>\n}\n\ntype ShapeStreamErrorHandler = (\n error: Error\n) => void | RetryOpts | Promise<void | RetryOpts>\n\n/**\n * Options for constructing a ShapeStream.\n */\nexport interface ShapeStreamOptions<T = never> {\n /**\n * The full URL to where the Shape is served. This can either be the Electric server\n * directly or a proxy. E.g. for a local Electric instance, you might set `http://localhost:3000/v1/shape`\n */\n url: string\n\n /**\n * The \"offset\" on the shape log. This is typically not set as the ShapeStream\n * will handle this automatically. A common scenario where you might pass an offset\n * is if you're maintaining a local cache of the log. If you've gone offline\n * and are re-starting a ShapeStream to catch-up to the latest state of the Shape,\n * you'd pass in the last offset and shapeHandle you'd seen from the Electric server\n * so it knows at what point in the shape to catch you up from.\n */\n offset?: Offset\n\n /**\n * Similar to `offset`, this isn't typically used unless you're maintaining\n * a cache of the shape log.\n */\n handle?: string\n\n /**\n * HTTP headers to attach to requests made by the client.\n * Can be used for adding authentication headers.\n */\n headers?: Record<string, string>\n\n /**\n * Additional request parameters to attach to the URL.\n * These will be merged with Electric's standard parameters.\n * Note: You cannot use Electric's reserved parameter names\n * (offset, handle, live, cursor).\n *\n * PostgreSQL-specific options like table, where, columns, and replica\n * should be specified here.\n */\n params?: ExternalParamsRecord\n\n /**\n * Automatically fetch updates to the Shape. If you just want to sync the current\n * shape and stop, pass false.\n */\n subscribe?: boolean\n\n signal?: AbortSignal\n fetchClient?: typeof fetch\n backoffOptions?: BackoffOptions\n parser?: Parser<T>\n\n /**\n * A function for handling shapestream errors.\n * This is optional, when it is not provided any shapestream errors will be thrown.\n * If the function returns an object containing parameters and/or headers\n * the shapestream will apply those changes and try syncing again.\n * If the function returns void the shapestream is stopped.\n */\n onError?: ShapeStreamErrorHandler\n}\n\nexport interface ShapeStreamInterface<T extends Row<unknown> = Row> {\n subscribe(\n callback: (messages: Message<T>[]) => MaybePromise<void>,\n onError?: (error: FetchError | Error) => void\n ): void\n unsubscribeAll(): void\n\n isLoading(): boolean\n lastSyncedAt(): number | undefined\n lastSynced(): number\n isConnected(): boolean\n\n isUpToDate: boolean\n lastOffset: Offset\n shapeHandle?: string\n error?: unknown\n}\n\n/**\n * Reads updates to a shape from Electric using HTTP requests and long polling. Notifies subscribers\n * when new messages come in. Doesn't maintain any history of the\n * log but does keep track of the offset position and is the best way\n * to consume the HTTP `GET /v1/shape` api.\n *\n * @constructor\n * @param {ShapeStreamOptions} options - configure the shape stream\n * @example\n * Register a callback function to subscribe to the messages.\n * ```\n * const stream = new ShapeStream(options)\n * stream.subscribe(messages => {\n * // messages is 1 or more row updates\n * })\n * ```\n *\n * To abort the stream, abort the `signal`\n * passed in via the `ShapeStreamOptions`.\n * ```\n * const aborter = new AbortController()\n * const issueStream = new ShapeStream({\n * url: `${BASE_URL}/${table}`\n * subscribe: true,\n * signal: aborter.signal,\n * })\n * // Later...\n * aborter.abort()\n * ```\n */\n\nexport class ShapeStream<T extends Row<unknown> = Row>\n implements ShapeStreamInterface<T>\n{\n static readonly Replica = {\n FULL: `full` as Replica,\n DEFAULT: `default` as Replica,\n }\n\n readonly options: ShapeStreamOptions<GetExtensions<T>>\n #error: unknown = null\n\n readonly #fetchClient: typeof fetch\n readonly #messageParser: MessageParser<T>\n\n readonly #subscribers = new Map<\n number,\n [\n (messages: Message<T>[]) => MaybePromise<void>,\n ((error: Error) => void) | undefined,\n ]\n >()\n\n #lastOffset: Offset\n #liveCacheBuster: string // Seconds since our Electric Epoch 😎\n #lastSyncedAt?: number // unix time\n #isUpToDate: boolean = false\n #connected: boolean = false\n #shapeHandle?: string\n #schema?: Schema\n #onError?: ShapeStreamErrorHandler\n\n constructor(options: ShapeStreamOptions<GetExtensions<T>>) {\n this.options = { subscribe: true, ...options }\n validateOptions(this.options)\n this.#lastOffset = this.options.offset ?? `-1`\n this.#liveCacheBuster = ``\n this.#shapeHandle = this.options.handle\n this.#messageParser = new MessageParser<T>(options.parser)\n this.#onError = this.options.onError\n\n const baseFetchClient =\n options.fetchClient ??\n ((...args: Parameters<typeof fetch>) => fetch(...args))\n\n const fetchWithBackoffClient = createFetchWithBackoff(baseFetchClient, {\n ...(options.backoffOptions ?? BackoffDefaults),\n onFailedAttempt: () => {\n this.#connected = false\n options.backoffOptions?.onFailedAttempt?.()\n },\n })\n\n this.#fetchClient = createFetchWithResponseHeadersCheck(\n createFetchWithChunkBuffer(fetchWithBackoffClient)\n )\n\n this.#start()\n }\n\n get shapeHandle() {\n return this.#shapeHandle\n }\n\n get error() {\n return this.#error\n }\n\n get isUpToDate() {\n return this.#isUpToDate\n }\n\n get lastOffset() {\n return this.#lastOffset\n }\n\n async #start() {\n try {\n while (\n (!this.options.signal?.aborted && !this.#isUpToDate) ||\n this.options.subscribe\n ) {\n const { url, signal } = this.options\n\n const fetchUrl = new URL(url)\n\n // Add any custom parameters first\n if (this.options.params) {\n // Check for reserved parameter names\n const reservedParams = Object.keys(this.options.params).filter(\n (key) => RESERVED_PARAMS.has(key)\n )\n if (reservedParams.length > 0) {\n throw new Error(\n `Cannot use reserved Electric parameter names in custom params: ${reservedParams.join(`, `)}`\n )\n }\n\n // Add PostgreSQL-specific parameters from params\n const params = toInternalParams(this.options.params)\n if (params.table)\n fetchUrl.searchParams.set(TABLE_QUERY_PARAM, params.table)\n if (params.where)\n fetchUrl.searchParams.set(WHERE_QUERY_PARAM, params.where)\n if (params.columns)\n fetchUrl.searchParams.set(COLUMNS_QUERY_PARAM, params.columns)\n if (params.replica)\n fetchUrl.searchParams.set(REPLICA_PARAM, params.replica)\n\n // Add any remaining custom parameters\n const customParams = { ...params }\n delete customParams.table\n delete customParams.where\n delete customParams.columns\n delete customParams.replica\n\n for (const [key, value] of Object.entries(customParams)) {\n fetchUrl.searchParams.set(key, value as string)\n }\n }\n\n // Add Electric's internal parameters\n fetchUrl.searchParams.set(OFFSET_QUERY_PARAM, this.#lastOffset)\n\n if (this.#isUpToDate) {\n fetchUrl.searchParams.set(LIVE_QUERY_PARAM, `true`)\n fetchUrl.searchParams.set(\n LIVE_CACHE_BUSTER_QUERY_PARAM,\n this.#liveCacheBuster\n )\n }\n\n if (this.#shapeHandle) {\n // This should probably be a header for better cache breaking?\n fetchUrl.searchParams.set(\n SHAPE_HANDLE_QUERY_PARAM,\n this.#shapeHandle!\n )\n }\n\n // sort query params in-place for stable URLs and improved cache hits\n fetchUrl.searchParams.sort()\n\n let response!: Response\n try {\n response = await this.#fetchClient(fetchUrl.toString(), {\n signal,\n headers: this.options.headers,\n })\n this.#connected = true\n } catch (e) {\n if (e instanceof FetchBackoffAbortError) break // interrupted\n if (!(e instanceof FetchError)) throw e // should never happen\n if (e.status == 409) {\n // Upon receiving a 409, we should start from scratch\n // with the newly provided shape handle\n const newShapeHandle = e.headers[SHAPE_HANDLE_HEADER]\n this.#reset(newShapeHandle)\n await this.#publish(e.json as Message<T>[])\n continue\n } else if (e.status >= 400 && e.status < 500) {\n // Notify subscribers\n this.#sendErrorToSubscribers(e)\n\n // 400 errors are not actionable without additional user input,\n // so we exit the loop\n throw e\n }\n }\n\n const { headers, status } = response\n const shapeHandle = headers.get(SHAPE_HANDLE_HEADER)\n if (shapeHandle) {\n this.#shapeHandle = shapeHandle\n }\n\n const lastOffset = headers.get(CHUNK_LAST_OFFSET_HEADER)\n if (lastOffset) {\n this.#lastOffset = lastOffset as Offset\n }\n\n const liveCacheBuster = headers.get(LIVE_CACHE_BUSTER_HEADER)\n if (liveCacheBuster) {\n this.#liveCacheBuster = liveCacheBuster\n }\n\n const getSchema = (): Schema => {\n const schemaHeader = headers.get(SHAPE_SCHEMA_HEADER)\n return schemaHeader ? JSON.parse(schemaHeader) : {}\n }\n this.#schema = this.#schema ?? getSchema()\n\n const messages = status === 204 ? `[]` : await response.text()\n\n if (status === 204) {\n // There's no content so we are live and up to date\n this.#lastSyncedAt = Date.now()\n }\n\n const batch = this.#messageParser.parse(messages, this.#schema)\n\n // Update isUpToDate\n if (batch.length > 0) {\n const lastMessage = batch[batch.length - 1]\n if (isUpToDateMessage(lastMessage)) {\n this.#lastSyncedAt = Date.now()\n this.#isUpToDate = true\n }\n\n await this.#publish(batch)\n }\n }\n } catch (err) {\n this.#error = err\n if (this.#onError) {\n const retryOpts = await this.#onError(err as Error)\n if (typeof retryOpts === `object`) {\n this.#reset()\n\n if (`params` in retryOpts) {\n this.options.params = retryOpts.params\n }\n\n if (`headers` in retryOpts) {\n this.options.headers = retryOpts.headers\n }\n\n // Restart\n this.#start()\n }\n return\n }\n\n // If no handler is provided for errors just throw so the error still bubbles up.\n throw err\n } finally {\n this.#connected = false\n }\n }\n\n subscribe(\n callback: (messages: Message<T>[]) => MaybePromise<void>,\n onError: (error: Error) => void = () => {}\n ) {\n const subscriptionId = Math.random()\n\n this.#subscribers.set(subscriptionId, [callback, onError])\n\n return () => {\n this.#subscribers.delete(subscriptionId)\n }\n }\n\n unsubscribeAll(): void {\n this.#subscribers.clear()\n }\n\n /** Unix time at which we last synced. Undefined when `isLoading` is true. */\n lastSyncedAt(): number | undefined {\n return this.#lastSyncedAt\n }\n\n /** Time elapsed since last sync (in ms). Infinity if we did not yet sync. */\n lastSynced(): number {\n if (this.#lastSyncedAt === undefined) return Infinity\n return Date.now() - this.#lastSyncedAt\n }\n\n /** Indicates if we are connected to the Electric sync service. */\n isConnected(): boolean {\n return this.#connected\n }\n\n /** True during initial fetch. False afterwise. */\n isLoading(): boolean {\n return !this.#isUpToDate\n }\n\n async #publish(messages: Message<T>[]): Promise<void> {\n await Promise.all(\n Array.from(this.#subscribers.values()).map(async ([callback, __]) => {\n try {\n await callback(messages)\n } catch (err) {\n queueMicrotask(() => {\n throw err\n })\n }\n })\n )\n }\n\n #sendErrorToSubscribers(error: Error) {\n this.#subscribers.forEach(([_, errorFn]) => {\n errorFn?.(error)\n })\n }\n\n /**\n * Resets the state of the stream, optionally with a provided\n * shape handle\n */\n #reset(handle?: string) {\n this.#lastOffset = `-1`\n this.#liveCacheBuster = ``\n this.#shapeHandle = handle\n this.#isUpToDate = false\n this.#connected = false\n this.#schema = undefined\n }\n}\n\nfunction validateOptions<T>(options: Partial<ShapeStreamOptions<T>>): void {\n if (!options.url) {\n throw new MissingShapeUrlError()\n }\n if (options.signal && !(options.signal instanceof AbortSignal)) {\n throw new InvalidSignalError()\n }\n\n if (\n options.offset !== undefined &&\n options.offset !== `-1` &&\n !options.handle\n ) {\n throw new MissingShapeHandleError()\n }\n\n // Check for reserved parameter names\n if (options.params) {\n const reservedParams = Object.keys(options.params).filter((key) =>\n RESERVED_PARAMS.has(key)\n )\n if (reservedParams.length > 0) {\n throw new ReservedParamError(reservedParams)\n }\n }\n return\n}\n","import { Message, Offset, Row } from './types'\nimport { isChangeMessage, isControlMessage } from './helpers'\nimport { FetchError } from './error'\nimport { ShapeStreamInterface } from './client'\n\nexport type ShapeData<T extends Row<unknown> = Row> = Map<string, T>\nexport type ShapeChangedCallback<T extends Row<unknown> = Row> = (data: {\n value: ShapeData<T>\n rows: T[]\n}) => void\n\n/**\n * A Shape is an object that subscribes to a shape log,\n * keeps a materialised shape `.rows` in memory and\n * notifies subscribers when the value has changed.\n *\n * It can be used without a framework and as a primitive\n * to simplify developing framework hooks.\n *\n * @constructor\n * @param {ShapeStream<T extends Row>} - the underlying shape stream\n * @example\n * ```\n * const shapeStream = new ShapeStream<{ foo: number }>({\n * url: `http://localhost:3000/v1/shape`,\n * params: {\n * table: `foo`\n * }\n * })\n * const shape = new Shape(shapeStream)\n * ```\n *\n * `rows` returns a promise that resolves the Shape data once the Shape has been\n * fully loaded (and when resuming from being offline):\n *\n * const rows = await shape.rows\n *\n * `currentRows` returns the current data synchronously:\n *\n * const rows = shape.currentRows\n *\n * Subscribe to updates. Called whenever the shape updates in Postgres.\n *\n * shape.subscribe(({ rows }) => {\n * console.log(rows)\n * })\n */\nexport class Shape<T extends Row<unknown> = Row> {\n readonly #stream: ShapeStreamInterface<T>\n\n readonly #data: ShapeData<T> = new Map()\n readonly #subscribers = new Map<number, ShapeChangedCallback<T>>()\n\n #hasNotifiedSubscribersUpToDate: boolean = false\n #error: FetchError | false = false\n\n constructor(stream: ShapeStreamInterface<T>) {\n this.#stream = stream\n this.#stream.subscribe(\n this.#process.bind(this),\n this.#handleError.bind(this)\n )\n }\n\n get isUpToDate(): boolean {\n return this.#stream.isUpToDate\n }\n\n get lastOffset(): Offset {\n return this.#stream.lastOffset\n }\n\n get handle(): string | undefined {\n return this.#stream.shapeHandle\n }\n\n get rows(): Promise<T[]> {\n return this.value.then((v) => Array.from(v.values()))\n }\n\n get currentRows(): T[] {\n return Array.from(this.currentValue.values())\n }\n\n get value(): Promise<ShapeData<T>> {\n return new Promise((resolve, reject) => {\n if (this.#stream.isUpToDate) {\n resolve(this.currentValue)\n } else {\n const unsubscribe = this.subscribe(({ value }) => {\n unsubscribe()\n if (this.#error) reject(this.#error)\n resolve(value)\n })\n }\n })\n }\n\n get currentValue() {\n return this.#data\n }\n\n get error() {\n return this.#error\n }\n\n /** Unix time at which we last synced. Undefined when `isLoading` is true. */\n lastSyncedAt(): number | undefined {\n return this.#stream.lastSyncedAt()\n }\n\n /** Time elapsed since last sync (in ms). Infinity if we did not yet sync. */\n lastSynced() {\n return this.#stream.lastSynced()\n }\n\n /** True during initial fetch. False afterwise. */\n isLoading() {\n return this.#stream.isLoading()\n }\n\n /** Indicates if we are connected to the Electric sync service. */\n isConnected(): boolean {\n return this.#stream.isConnected()\n }\n\n subscribe(callback: ShapeChangedCallback<T>): () => void {\n const subscriptionId = Math.random()\n\n this.#subscribers.set(subscriptionId, callback)\n\n return () => {\n this.#subscribers.delete(subscriptionId)\n }\n }\n\n unsubscribeAll(): void {\n this.#subscribers.clear()\n }\n\n get numSubscribers() {\n return this.#subscribers.size\n }\n\n #process(messages: Message<T>[]): void {\n let dataMayHaveChanged = false\n let isUpToDate = false\n let newlyUpToDate = false\n\n messages.forEach((message) => {\n if (isChangeMessage(message)) {\n dataMayHaveChanged = [`insert`, `update`, `delete`].includes(\n message.headers.operation\n )\n\n switch (message.headers.operation) {\n case `insert`:\n this.#data.set(message.key, message.value)\n break\n case `update`:\n this.#data.set(message.key, {\n ...this.#data.get(message.key)!,\n ...message.value,\n })\n break\n case `delete`:\n this.#data.delete(message.key)\n break\n }\n }\n\n if (isControlMessage(message)) {\n switch (message.headers.control) {\n case `up-to-date`:\n isUpToDate = true\n if (!this.#hasNotifiedSubscribersUpToDate) {\n newlyUpToDate = true\n }\n break\n case `must-refetch`:\n this.#data.clear()\n this.#error = false\n this.#hasNotifiedSubscribersUpToDate = false\n isUpToDate = false\n newlyUpToDate = false\n break\n }\n }\n })\n\n // Always notify subscribers when the Shape first is up to date.\n // FIXME this would be cleaner with a simple state machine.\n if (newlyUpToDate || (isUpToDate && dataMayHaveChanged)) {\n this.#hasNotifiedSubscribersUpToDate = true\n this.#notify()\n }\n }\n\n #handleError(e: Error): void {\n if (e instanceof FetchError) {\n this.#error = e\n this.#notify()\n }\n }\n\n #notify(): void {\n this.#subscribers.forEach((callback) => {\n callback({ value: this.currentValue, rows: this.currentRows })\n })\n }\n}\n"],"mappings":"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","names":["key","value","_fetchClient","_a","_b","_subscribers","_error"]}
|
package/dist/index.browser.mjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
var
|
|
2
|
-
`;t.forEach(
|
|
1
|
+
var Je=Object.defineProperty,ze=Object.defineProperties;var Xe=Object.getOwnPropertyDescriptors;var te=Object.getOwnPropertySymbols;var Se=Object.prototype.hasOwnProperty,Ce=Object.prototype.propertyIsEnumerable;var Me=s=>{throw TypeError(s)};var xe=(s,e,t)=>e in s?Je(s,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):s[e]=t,b=(s,e)=>{for(var t in e||(e={}))Se.call(e,t)&&xe(s,t,e[t]);if(te)for(var t of te(e))Ce.call(e,t)&&xe(s,t,e[t]);return s},se=(s,e)=>ze(s,Xe(e));var ke=(s,e)=>{var t={};for(var r in s)Se.call(s,r)&&e.indexOf(r)<0&&(t[r]=s[r]);if(s!=null&&te)for(var r of te(s))e.indexOf(r)<0&&Ce.call(s,r)&&(t[r]=s[r]);return t};var ge=(s,e,t)=>e.has(s)||Me("Cannot "+t);var a=(s,e,t)=>(ge(s,e,"read from private field"),t?t.call(s):e.get(s)),u=(s,e,t)=>e.has(s)?Me("Cannot add the same private member more than once"):e instanceof WeakSet?e.add(s):e.set(s,t),l=(s,e,t,r)=>(ge(s,e,"write to private field"),r?r.call(s,t):e.set(s,t),t),m=(s,e,t)=>(ge(s,e,"access private method"),t);var A=(s,e,t)=>new Promise((r,o)=>{var n=h=>{try{c(t.next(h))}catch(f){o(f)}},i=h=>{try{c(t.throw(h))}catch(f){o(f)}},c=h=>h.done?r(h.value):Promise.resolve(h.value).then(n,i);c((t=t.apply(s,e)).next())});var y=class s extends Error{constructor(t,r,o,n,i,c){super(c||`HTTP Error ${t} at ${i}: ${r!=null?r:JSON.stringify(o)}`);this.url=i;this.name="FetchError",this.status=t,this.text=r,this.json=o,this.headers=n}static fromResponse(t,r){return A(this,null,function*(){let o=t.status,n=Object.fromEntries([...t.headers.entries()]),i,c,h=t.headers.get("content-type");return h&&h.includes("application/json")?c=yield t.json():i=yield t.text(),new s(o,i,c,n,r)})}},Y=class extends Error{constructor(){super("Fetch with backoff aborted"),this.name="FetchBackoffAbortError"}};var re=class extends Error{constructor(){super("Invalid shape options: missing required url parameter"),this.name="MissingShapeUrlError"}},ne=class extends Error{constructor(){super("Invalid signal option. It must be an instance of AbortSignal."),this.name="InvalidSignalError"}},ae=class extends Error{constructor(){super("shapeHandle is required if this isn't an initial fetch (i.e. offset > -1)"),this.name="MissingShapeHandleError"}},oe=class extends Error{constructor(e){super(`Cannot use reserved Electric parameter names in custom params: ${e.join(", ")}`),this.name="ReservedParamError"}},ie=class extends Error{constructor(e){super(`Column "${e!=null?e:"unknown"}" does not allow NULL values`),this.name="ParserNullValueError"}};var ce=class extends Error{constructor(e,t){let r=`The response for the shape request to ${e} didn't include the following required headers:
|
|
2
|
+
`;t.forEach(o=>{r+=`- ${o}
|
|
3
3
|
`}),r+=`
|
|
4
4
|
This is often due to a proxy not setting CORS correctly so that all Electric headers can be read by the client.`,r+=`
|
|
5
|
-
For more information visit the troubleshooting guide: /docs/guides/troubleshooting/missing-headers`,super(r)}};var ue=s=>Number(s),ot=s=>s==="true"||s==="t",at=s=>BigInt(s),Fe=s=>JSON.parse(s),it=s=>s,ct={int2:ue,int4:ue,int8:at,bool:ot,float4:ue,float8:ue,json:Fe,jsonb:Fe};function lt(s,e){let t=0,r=null,a="",o=!1,i=0,h;function f(l){let p=[];for(;t<l.length;t++){if(r=l[t],o)r==="\\"?a+=l[++t]:r==='"'?(p.push(e?e(a):a),a="",o=l[t+1]==='"',i=t+2):a+=r;else if(r==='"')o=!0;else if(r==="{")i=++t,p.push(f(l));else if(r==="}"){o=!1,i<t&&p.push(e?e(l.slice(i,t)):l.slice(i,t)),i=t+1;break}else r===","&&h!=="}"&&h!=='"'&&(p.push(e?e(l.slice(i,t)):l.slice(i,t)),i=t+1);h=r}return i<t&&p.push(e?e(l.slice(i,t+1)):l.slice(i,t+1)),p}return f(s)[0]}var pe=class{constructor(e){this.parser=A(A({},ct),e)}parse(e,t){return JSON.parse(e,(r,a)=>{if(r==="value"&&typeof a=="object"&&a!==null){let o=a;Object.keys(o).forEach(i=>{o[i]=this.parseRow(i,o[i],t)})}return a})}parseRow(e,t,r){var b;let a=r[e];if(!a)return t;let p=a,{type:o,dims:i}=p,h=Ie(p,["type","dims"]),f=(b=this.parser[o])!=null?b:it,l=Ne(f,a,e);return i&&i>0?Ne((m,W)=>lt(m,l),a,e)(t):l(t,h)}};function Ne(s,e,t){var a;let r=!((a=e.not_null)!=null&&a);return o=>{if(ht(o)){if(!r)throw new he(t!=null?t:"unknown");return null}return s(o,e)}}function ht(s){return s===null||s==="NULL"}function de(s){return"key"in s}function Ee(s){return!de(s)}function Be(s){return Ee(s)&&s.headers.control==="up-to-date"}var Ye="electric-cursor",G="electric-handle",me="electric-offset",Qe="electric-schema",Ve="electric-up-to-date",be="database_id",Pe="columns",ye="cursor",K="handle",C="live",J="offset",Te="table",_e="where",we="replica";var ft=[429],Re={initialDelay:100,maxDelay:1e4,multiplier:1.3};function je(s,e=Re){let{initialDelay:t,maxDelay:r,multiplier:a,debug:o=!1,onFailedAttempt:i}=e;return(...h)=>P(this,null,function*(){var N;let f=h[0],l=h[1],p=t,b=0;for(;;)try{let m=yield s(...h);if(m.ok)return m;throw yield y.fromResponse(m,f.toString())}catch(m){if(i==null||i(),(N=l==null?void 0:l.signal)!=null&&N.aborted)throw new B;if(m instanceof y&&!ft.includes(m.status)&&m.status>=400&&m.status<500)throw m;yield new Promise(W=>setTimeout(W,p)),p=Math.min(p*a,r),o&&(b++,console.log(`Retry attempt #${b} after ${p}ms`))}})}var ut={maxChunksToPrefetch:2};function qe(s,e=ut){let{maxChunksToPrefetch:t}=e,r;return(...o)=>P(this,null,function*(){let i=o[0].toString(),h=r==null?void 0:r.consume(...o);if(h)return h;r==null||r.abort();let f=yield s(...o),l=xe(i,f);return l&&(r=new Se({fetchClient:s,maxPrefetchedRequests:t,url:l,requestInit:o[1]})),f})}var pt=["electric-offset","electric-handle"],dt=["electric-cursor"],Et=["electric-schema"];function We(s){return(...e)=>P(this,null,function*(){let t=yield s(...e);if(t.ok){let r=t.headers,a=[],o=l=>a.push(...l.filter(p=>!r.has(p)));o(pt);let h=e[0].toString(),f=new URL(h);if(f.searchParams.has(C,"true")&&o(dt),(!f.searchParams.has(C)||f.searchParams.has(C,"false"))&&o(Et),a.length>0)throw new fe(h,a)}return t})}var z,X,T,L,_,Y,ge,Se=class{constructor(e){u(this,Y);u(this,z);u(this,X);u(this,T,new Map);u(this,L);u(this,_);var t;c(this,z,(t=e.fetchClient)!=null?t:(...r)=>fetch(...r)),c(this,X,e.maxPrefetchedRequests),c(this,L,e.url.toString()),c(this,_,n(this,L)),E(this,Y,ge).call(this,e.url,e.requestInit)}abort(){n(this,T).forEach(([e,t])=>t.abort())}consume(...e){var a;let t=e[0].toString(),r=(a=n(this,T).get(t))==null?void 0:a[0];if(!(!r||t!==n(this,L)))return n(this,T).delete(t),r.then(o=>{let i=xe(t,o);c(this,L,i),n(this,_)&&!n(this,T).has(n(this,_))&&E(this,Y,ge).call(this,n(this,_),e[1])}).catch(()=>{}),r}};z=new WeakMap,X=new WeakMap,T=new WeakMap,L=new WeakMap,_=new WeakMap,Y=new WeakSet,ge=function(...e){var a,o;let t=e[0].toString();if(n(this,T).size>=n(this,X))return;let r=new AbortController;try{let i=n(this,z).call(this,t,oe(A({},(a=e[1])!=null?a:{}),{signal:mt(r,(o=e[1])==null?void 0:o.signal)}));n(this,T).set(t,[i,r]),i.then(h=>{if(!h.ok||r.signal.aborted)return;let f=xe(t,h);if(!f||f===t){c(this,_,void 0);return}return c(this,_,f),E(this,Y,ge).call(this,f,e[1])}).catch(()=>{})}catch(i){}};function xe(s,e){let t=e.headers.get(G),r=e.headers.get(me),a=e.headers.has(Ve);if(!t||!r||a)return;let o=new URL(s);if(!o.searchParams.has(C))return o.searchParams.set(K,t),o.searchParams.set(J,r),o.toString()}function mt(s,e){return e&&(e.aborted?s.abort():e.addEventListener("abort",()=>s.abort(),{once:!0})),s.signal}var Ge=new Set([be,Pe,ye,K,C,J,Te,_e,we]),ee,te,se,k,U,I,H,w,D,S,Q,F,V,j,g,Me,Ce,Ke,ke,Z=class Z{constructor(e){u(this,g);u(this,ee,null);u(this,te);u(this,se);u(this,k,new Map);u(this,U);u(this,I);u(this,H);u(this,w,!1);u(this,D,!1);u(this,S);u(this,Q);u(this,F);u(this,V);u(this,j);var a,o,i;this.options=A({subscribe:!0},e),gt(this.options),c(this,U,(a=this.options.offset)!=null?a:"-1"),c(this,I,""),c(this,S,this.options.handle),c(this,Q,this.options.databaseId),c(this,se,new pe(e.parser)),c(this,j,this.options.replica),c(this,V,this.options.onError);let t=(o=e.fetchClient)!=null?o:(...h)=>fetch(...h),r=je(t,oe(A({},(i=e.backoffOptions)!=null?i:Re),{onFailedAttempt:()=>{var h,f;c(this,D,!1),(f=(h=e.backoffOptions)==null?void 0:h.onFailedAttempt)==null||f.call(h)}}));c(this,te,We(qe(r))),E(this,g,Me).call(this)}get shapeHandle(){return n(this,S)}get error(){return n(this,ee)}get isUpToDate(){return n(this,w)}get lastOffset(){return n(this,U)}subscribe(e,t=()=>{}){let r=Math.random();return n(this,k).set(r,[e,t]),()=>{n(this,k).delete(r)}}unsubscribeAll(){n(this,k).clear()}lastSyncedAt(){return n(this,H)}lastSynced(){return n(this,H)===void 0?1/0:Date.now()-n(this,H)}isConnected(){return n(this,D)}isLoading(){return!n(this,w)}};ee=new WeakMap,te=new WeakMap,se=new WeakMap,k=new WeakMap,U=new WeakMap,I=new WeakMap,H=new WeakMap,w=new WeakMap,D=new WeakMap,S=new WeakMap,Q=new WeakMap,F=new WeakMap,V=new WeakMap,j=new WeakMap,g=new WeakSet,Me=function(){return P(this,null,function*(){var e,t,r;try{for(;!((e=this.options.signal)!=null&&e.aborted)&&!n(this,w)||this.options.subscribe;){let{url:a,table:o,where:i,columns:h,signal:f}=this.options,l=new URL(a);if(this.options.params){let d=Object.keys(this.options.params).filter($=>Ge.has($));if(d.length>0)throw new Error(`Cannot use reserved Electric parameter names in custom params: ${d.join(", ")}`);for(let[$,tt]of Object.entries(this.options.params))l.searchParams.set($,tt)}o&&l.searchParams.set(Te,o),i&&l.searchParams.set(_e,i),h&&h.length>0&&l.searchParams.set(Pe,h.join(",")),l.searchParams.set(J,n(this,U)),n(this,w)&&(l.searchParams.set(C,"true"),l.searchParams.set(ye,n(this,I))),n(this,S)&&l.searchParams.set(K,n(this,S)),n(this,Q)&&l.searchParams.set(be,n(this,Q)),((t=n(this,j))!=null?t:Z.Replica.DEFAULT)!=Z.Replica.DEFAULT&&l.searchParams.set(we,n(this,j));let p;try{p=yield n(this,te).call(this,l.toString(),{signal:f,headers:this.options.headers}),c(this,D,!0)}catch(d){if(d instanceof B)break;if(!(d instanceof y))throw d;if(d.status==409){let $=d.headers[G];E(this,g,ke).call(this,$),yield E(this,g,Ce).call(this,d.json);continue}else if(d.status>=400&&d.status<500)throw E(this,g,Ke).call(this,d),d}let{headers:b,status:N}=p,m=b.get(G);m&&c(this,S,m);let W=b.get(me);W&&c(this,U,W);let He=b.get(Ye);He&&c(this,I,He);let Ze=()=>{let d=b.get(Qe);return d?JSON.parse(d):{}};c(this,F,(r=n(this,F))!=null?r:Ze());let et=N===204?"[]":yield p.text();N===204&&c(this,H,Date.now());let re=n(this,se).parse(et,n(this,F));if(re.length>0){let d=re[re.length-1];Be(d)&&(c(this,H,Date.now()),c(this,w,!0)),yield E(this,g,Ce).call(this,re)}}}catch(a){if(c(this,ee,a),n(this,V)){let o=yield n(this,V).call(this,a);typeof o=="object"&&(E(this,g,ke).call(this),"params"in o&&(this.options.params=o.params),"headers"in o&&(this.options.headers=o.headers),E(this,g,Me).call(this));return}throw a}finally{c(this,D,!1)}})},Ce=function(e){return P(this,null,function*(){yield Promise.all(Array.from(n(this,k).values()).map(a=>P(this,[a],function*([t,r]){try{yield t(e)}catch(o){queueMicrotask(()=>{throw o})}})))})},Ke=function(e){n(this,k).forEach(([t,r])=>{r==null||r(e)})},ke=function(e){c(this,U,"-1"),c(this,I,""),c(this,S,e),c(this,w,!1),c(this,D,!1),c(this,F,void 0)},Z.Replica={FULL:"full",DEFAULT:"default"};var $e=Z;function gt(s){if(!s.url)throw new ae;if(s.signal&&!(s.signal instanceof AbortSignal))throw new ie;if(s.offset!==void 0&&s.offset!=="-1"&&!s.handle)throw new ce;if(s.params){let e=Object.keys(s.params).filter(t=>Ge.has(t));if(e.length>0)throw new le(e)}}var R,x,O,q,v,M,ze,Xe,Ue,Je=class{constructor(e){u(this,M);u(this,R);u(this,x,new Map);u(this,O,new Map);u(this,q,!1);u(this,v,!1);c(this,R,e),n(this,R).subscribe(E(this,M,ze).bind(this),E(this,M,Xe).bind(this))}get isUpToDate(){return n(this,R).isUpToDate}get lastOffset(){return n(this,R).lastOffset}get handle(){return n(this,R).shapeHandle}get rows(){return this.value.then(e=>Array.from(e.values()))}get currentRows(){return Array.from(this.currentValue.values())}get value(){return new Promise((e,t)=>{if(n(this,R).isUpToDate)e(this.currentValue);else{let r=this.subscribe(({value:a})=>{r(),n(this,v)&&t(n(this,v)),e(a)})}})}get currentValue(){return n(this,x)}get error(){return n(this,v)}lastSyncedAt(){return n(this,R).lastSyncedAt()}lastSynced(){return n(this,R).lastSynced()}isLoading(){return n(this,R).isLoading()}isConnected(){return n(this,R).isConnected()}subscribe(e){let t=Math.random();return n(this,O).set(t,e),()=>{n(this,O).delete(t)}}unsubscribeAll(){n(this,O).clear()}get numSubscribers(){return n(this,O).size}};R=new WeakMap,x=new WeakMap,O=new WeakMap,q=new WeakMap,v=new WeakMap,M=new WeakSet,ze=function(e){let t=!1,r=!1,a=!1;e.forEach(o=>{if(de(o))switch(t=["insert","update","delete"].includes(o.headers.operation),o.headers.operation){case"insert":n(this,x).set(o.key,o.value);break;case"update":n(this,x).set(o.key,A(A({},n(this,x).get(o.key)),o.value));break;case"delete":n(this,x).delete(o.key);break}if(Ee(o))switch(o.headers.control){case"up-to-date":r=!0,n(this,q)||(a=!0);break;case"must-refetch":n(this,x).clear(),c(this,v,!1),c(this,q,!1),r=!1,a=!1;break}}),(a||r&&t)&&(c(this,q,!0),E(this,M,Ue).call(this))},Xe=function(e){e instanceof y&&(c(this,v,e),E(this,M,Ue).call(this))},Ue=function(){n(this,O).forEach(e=>{e({value:this.currentValue,rows:this.currentRows})})};export{Re as BackoffDefaults,y as FetchError,Je as Shape,$e as ShapeStream,de as isChangeMessage,Ee as isControlMessage};
|
|
5
|
+
For more information visit the troubleshooting guide: /docs/guides/troubleshooting/missing-headers`,super(r)}};var le=s=>Number(s),Ze=s=>s==="true"||s==="t",et=s=>BigInt(s),Ue=s=>JSON.parse(s),tt=s=>s,st={int2:le,int4:le,int8:et,bool:Ze,float4:le,float8:le,json:Ue,jsonb:Ue};function rt(s,e){let t=0,r=null,o="",n=!1,i=0,c;function h(f){let p=[];for(;t<f.length;t++){if(r=f[t],n)r==="\\"?o+=f[++t]:r==='"'?(p.push(e?e(o):o),o="",n=f[t+1]==='"',i=t+2):o+=r;else if(r==='"')n=!0;else if(r==="{")i=++t,p.push(h(f));else if(r==="}"){n=!1,i<t&&p.push(e?e(f.slice(i,t)):f.slice(i,t)),i=t+1;break}else r===","&&c!=="}"&&c!=='"'&&(p.push(e?e(f.slice(i,t)):f.slice(i,t)),i=t+1);c=r}return i<t&&p.push(e?e(f.slice(i,t+1)):f.slice(i,t+1)),p}return h(s)[0]}var he=class{constructor(e){this.parser=b(b({},st),e)}parse(e,t){return JSON.parse(e,(r,o)=>{if(r==="value"&&typeof o=="object"&&o!==null){let n=o;Object.keys(n).forEach(i=>{n[i]=this.parseRow(i,n[i],t)})}return o})}parseRow(e,t,r){var M;let o=r[e];if(!o)return t;let p=o,{type:n,dims:i}=p,c=ke(p,["type","dims"]),h=(M=this.parser[n])!=null?M:tt,f=He(h,o,e);return i&&i>0?He((E,I)=>rt(E,f),o,e)(t):f(t,c)}};function He(s,e,t){var o;let r=!((o=e.not_null)!=null&&o);return n=>{if(nt(n)){if(!r)throw new ie(t!=null?t:"unknown");return null}return s(n,e)}}function nt(s){return s===null||s==="NULL"}function fe(s){return"key"in s}function ue(s){return!fe(s)}function ve(s){return ue(s)&&s.headers.control==="up-to-date"}var Oe="electric-cursor",W="electric-handle",pe="electric-offset",De="electric-schema",Le="electric-up-to-date",Ie="columns",Re="cursor",$="handle",k="live",G="offset",Fe="table",Ne="where",Be="replica";var at=[429],me={initialDelay:100,maxDelay:1e4,multiplier:1.3};function Ye(s,e=me){let{initialDelay:t,maxDelay:r,multiplier:o,debug:n=!1,onFailedAttempt:i}=e;return(...c)=>A(this,null,function*(){var q;let h=c[0],f=c[1],p=t,M=0;for(;;)try{let E=yield s(...c);if(E.ok)return E;throw yield y.fromResponse(E,h.toString())}catch(E){if(i==null||i(),(q=f==null?void 0:f.signal)!=null&&q.aborted)throw new Y;if(E instanceof y&&!at.includes(E.status)&&E.status>=400&&E.status<500)throw E;yield new Promise(I=>setTimeout(I,p)),p=Math.min(p*o,r),n&&(M++,console.log(`Retry attempt #${M} after ${p}ms`))}})}var ot={maxChunksToPrefetch:2};function je(s,e=ot){let{maxChunksToPrefetch:t}=e,r;return(...n)=>A(this,null,function*(){let i=n[0].toString(),c=r==null?void 0:r.consume(...n);if(c)return c;r==null||r.abort();let h=yield s(...n),f=Pe(i,h);return f&&(r=new be({fetchClient:s,maxPrefetchedRequests:t,url:f,requestInit:n[1]})),h})}var it=["electric-offset","electric-handle"],ct=["electric-cursor"],lt=["electric-schema"];function Qe(s){return(...e)=>A(this,null,function*(){let t=yield s(...e);if(t.ok){let r=t.headers,o=[],n=f=>o.push(...f.filter(p=>!r.has(p)));n(it);let c=e[0].toString(),h=new URL(c);if(h.searchParams.has(k,"true")&&n(ct),(!h.searchParams.has(k)||h.searchParams.has(k,"false"))&&n(lt),o.length>0)throw new ce(c,o)}return t})}var J,z,T,F,w,j,de,be=class{constructor(e){u(this,j);u(this,J);u(this,z);u(this,T,new Map);u(this,F);u(this,w);var t;l(this,J,(t=e.fetchClient)!=null?t:(...r)=>fetch(...r)),l(this,z,e.maxPrefetchedRequests),l(this,F,e.url.toString()),l(this,w,a(this,F)),m(this,j,de).call(this,e.url,e.requestInit)}abort(){a(this,T).forEach(([e,t])=>t.abort())}consume(...e){var o;let t=e[0].toString(),r=(o=a(this,T).get(t))==null?void 0:o[0];if(!(!r||t!==a(this,F)))return a(this,T).delete(t),r.then(n=>{let i=Pe(t,n);l(this,F,i),a(this,w)&&!a(this,T).has(a(this,w))&&m(this,j,de).call(this,a(this,w),e[1])}).catch(()=>{}),r}};J=new WeakMap,z=new WeakMap,T=new WeakMap,F=new WeakMap,w=new WeakMap,j=new WeakSet,de=function(...e){var o,n;let t=e[0].toString();if(a(this,T).size>=a(this,z))return;let r=new AbortController;try{let i=a(this,J).call(this,t,se(b({},(o=e[1])!=null?o:{}),{signal:ht(r,(n=e[1])==null?void 0:n.signal)}));a(this,T).set(t,[i,r]),i.then(c=>{if(!c.ok||r.signal.aborted)return;let h=Pe(t,c);if(!h||h===t){l(this,w,void 0);return}return l(this,w,h),m(this,j,de).call(this,h,e[1])}).catch(()=>{})}catch(i){}};function Pe(s,e){let t=e.headers.get(W),r=e.headers.get(pe),o=e.headers.has(Le);if(!t||!r||o)return;let n=new URL(s);if(!n.searchParams.has(k))return n.searchParams.set($,t),n.searchParams.set(G,r),n.searchParams.sort(),n.toString()}function ht(s,e){return e&&(e.aborted?s.abort():e.addEventListener("abort",()=>s.abort(),{once:!0})),s.signal}var Ve=new Set([Re,$,k,G]);function ft(s){let e={};for(let[t,r]of Object.entries(s))e[t]=Array.isArray(r)?r.join(","):r;return e}var X,Z,ee,U,H,N,v,_,O,x,B,Q,g,ye,Te,qe,we,Ae=class{constructor(e){u(this,g);u(this,X,null);u(this,Z);u(this,ee);u(this,U,new Map);u(this,H);u(this,N);u(this,v);u(this,_,!1);u(this,O,!1);u(this,x);u(this,B);u(this,Q);var o,n,i;this.options=b({subscribe:!0},e),ut(this.options),l(this,H,(o=this.options.offset)!=null?o:"-1"),l(this,N,""),l(this,x,this.options.handle),l(this,ee,new he(e.parser)),l(this,Q,this.options.onError);let t=(n=e.fetchClient)!=null?n:(...c)=>fetch(...c),r=Ye(t,se(b({},(i=e.backoffOptions)!=null?i:me),{onFailedAttempt:()=>{var c,h;l(this,O,!1),(h=(c=e.backoffOptions)==null?void 0:c.onFailedAttempt)==null||h.call(c)}}));l(this,Z,Qe(je(r))),m(this,g,ye).call(this)}get shapeHandle(){return a(this,x)}get error(){return a(this,X)}get isUpToDate(){return a(this,_)}get lastOffset(){return a(this,H)}subscribe(e,t=()=>{}){let r=Math.random();return a(this,U).set(r,[e,t]),()=>{a(this,U).delete(r)}}unsubscribeAll(){a(this,U).clear()}lastSyncedAt(){return a(this,v)}lastSynced(){return a(this,v)===void 0?1/0:Date.now()-a(this,v)}isConnected(){return a(this,O)}isLoading(){return!a(this,_)}};X=new WeakMap,Z=new WeakMap,ee=new WeakMap,U=new WeakMap,H=new WeakMap,N=new WeakMap,v=new WeakMap,_=new WeakMap,O=new WeakMap,x=new WeakMap,B=new WeakMap,Q=new WeakMap,g=new WeakSet,ye=function(){return A(this,null,function*(){var e,t;try{for(;!((e=this.options.signal)!=null&&e.aborted)&&!a(this,_)||this.options.subscribe;){let{url:r,signal:o}=this.options,n=new URL(r);if(this.options.params){let d=Object.keys(this.options.params).filter(Ee=>Ve.has(Ee));if(d.length>0)throw new Error(`Cannot use reserved Electric parameter names in custom params: ${d.join(", ")}`);let P=ft(this.options.params);P.table&&n.searchParams.set(Fe,P.table),P.where&&n.searchParams.set(Ne,P.where),P.columns&&n.searchParams.set(Ie,P.columns),P.replica&&n.searchParams.set(Be,P.replica);let K=b({},P);delete K.table,delete K.where,delete K.columns,delete K.replica;for(let[Ee,Ge]of Object.entries(K))n.searchParams.set(Ee,Ge)}n.searchParams.set(G,a(this,H)),a(this,_)&&(n.searchParams.set(k,"true"),n.searchParams.set(Re,a(this,N))),a(this,x)&&n.searchParams.set($,a(this,x)),n.searchParams.sort();let i;try{i=yield a(this,Z).call(this,n.toString(),{signal:o,headers:this.options.headers}),l(this,O,!0)}catch(d){if(d instanceof Y)break;if(!(d instanceof y))throw d;if(d.status==409){let P=d.headers[W];m(this,g,we).call(this,P),yield m(this,g,Te).call(this,d.json);continue}else if(d.status>=400&&d.status<500)throw m(this,g,qe).call(this,d),d}let{headers:c,status:h}=i,f=c.get(W);f&&l(this,x,f);let p=c.get(pe);p&&l(this,H,p);let M=c.get(Oe);M&&l(this,N,M);let q=()=>{let d=c.get(De);return d?JSON.parse(d):{}};l(this,B,(t=a(this,B))!=null?t:q());let E=h===204?"[]":yield i.text();h===204&&l(this,v,Date.now());let I=a(this,ee).parse(E,a(this,B));if(I.length>0){let d=I[I.length-1];ve(d)&&(l(this,v,Date.now()),l(this,_,!0)),yield m(this,g,Te).call(this,I)}}}catch(r){if(l(this,X,r),a(this,Q)){let o=yield a(this,Q).call(this,r);typeof o=="object"&&(m(this,g,we).call(this),"params"in o&&(this.options.params=o.params),"headers"in o&&(this.options.headers=o.headers),m(this,g,ye).call(this));return}throw r}finally{l(this,O,!1)}})},Te=function(e){return A(this,null,function*(){yield Promise.all(Array.from(a(this,U).values()).map(o=>A(this,[o],function*([t,r]){try{yield t(e)}catch(n){queueMicrotask(()=>{throw n})}})))})},qe=function(e){a(this,U).forEach(([t,r])=>{r==null||r(e)})},we=function(e){l(this,H,"-1"),l(this,N,""),l(this,x,e),l(this,_,!1),l(this,O,!1),l(this,B,void 0)},Ae.Replica={FULL:"full",DEFAULT:"default"};function ut(s){if(!s.url)throw new re;if(s.signal&&!(s.signal instanceof AbortSignal))throw new ne;if(s.offset!==void 0&&s.offset!=="-1"&&!s.handle)throw new ae;if(s.params){let e=Object.keys(s.params).filter(t=>Ve.has(t));if(e.length>0)throw new oe(e)}}var R,S,D,V,L,C,We,$e,_e,Ke=class{constructor(e){u(this,C);u(this,R);u(this,S,new Map);u(this,D,new Map);u(this,V,!1);u(this,L,!1);l(this,R,e),a(this,R).subscribe(m(this,C,We).bind(this),m(this,C,$e).bind(this))}get isUpToDate(){return a(this,R).isUpToDate}get lastOffset(){return a(this,R).lastOffset}get handle(){return a(this,R).shapeHandle}get rows(){return this.value.then(e=>Array.from(e.values()))}get currentRows(){return Array.from(this.currentValue.values())}get value(){return new Promise((e,t)=>{if(a(this,R).isUpToDate)e(this.currentValue);else{let r=this.subscribe(({value:o})=>{r(),a(this,L)&&t(a(this,L)),e(o)})}})}get currentValue(){return a(this,S)}get error(){return a(this,L)}lastSyncedAt(){return a(this,R).lastSyncedAt()}lastSynced(){return a(this,R).lastSynced()}isLoading(){return a(this,R).isLoading()}isConnected(){return a(this,R).isConnected()}subscribe(e){let t=Math.random();return a(this,D).set(t,e),()=>{a(this,D).delete(t)}}unsubscribeAll(){a(this,D).clear()}get numSubscribers(){return a(this,D).size}};R=new WeakMap,S=new WeakMap,D=new WeakMap,V=new WeakMap,L=new WeakMap,C=new WeakSet,We=function(e){let t=!1,r=!1,o=!1;e.forEach(n=>{if(fe(n))switch(t=["insert","update","delete"].includes(n.headers.operation),n.headers.operation){case"insert":a(this,S).set(n.key,n.value);break;case"update":a(this,S).set(n.key,b(b({},a(this,S).get(n.key)),n.value));break;case"delete":a(this,S).delete(n.key);break}if(ue(n))switch(n.headers.control){case"up-to-date":r=!0,a(this,V)||(o=!0);break;case"must-refetch":a(this,S).clear(),l(this,L,!1),l(this,V,!1),r=!1,o=!1;break}}),(o||r&&t)&&(l(this,V,!0),m(this,C,_e).call(this))},$e=function(e){e instanceof y&&(l(this,L,e),m(this,C,_e).call(this))},_e=function(){a(this,D).forEach(e=>{e({value:this.currentValue,rows:this.currentRows})})};export{me as BackoffDefaults,y as FetchError,Ke as Shape,Ae as ShapeStream,fe as isChangeMessage,ue as isControlMessage};
|
|
6
6
|
//# sourceMappingURL=index.browser.mjs.map
|