@haverstack/wire-types 0.40.0 → 0.41.0

package/dist/index.js

@@ -1,400 +1,23 @@
-import { NATIVE_SORT_FIELDS, StackError, StackValidationError, StackPermissionError, StackNotFoundError, StackConflictError, StackVersionConflictError, StackMigrationError, StackBadRequestError, StackSchemaDriftError, StackPayloadTooLargeError, StackTimeoutError, } from '@haverstack/core';
-/** Copied field by field, so a response never aliases a stored record's object. */
-function serializeActor(a) {
-    const w = { subjectId: a.subjectId };
-    if (a.principalId !== undefined)
-        w.principalId = a.principalId;
-    return w;
-}
-export function serializeRecord(r) {
-    const w = {
-        id: r.id,
-        typeId: r.typeId,
-        createdAt: r.createdAt.toISOString(),
-        updatedAt: r.updatedAt.toISOString(),
-        content: r.content,
-        version: r.version,
-    };
-    if (r.parentId !== undefined)
-        w.parentId = r.parentId;
-    if (r.appId !== undefined)
-        w.appId = r.appId;
-    if (r.createdBy !== undefined)
-        w.createdBy = serializeActor(r.createdBy);
-    if (r.updatedBy !== undefined)
-        w.updatedBy = serializeActor(r.updatedBy);
-    if (r.deletedAt !== undefined)
-        w.deletedAt = r.deletedAt.toISOString();
-    if (r.unlistedAt !== undefined)
-        w.unlistedAt = r.unlistedAt.toISOString();
-    if (r.permissions !== undefined)
-        w.permissions = r.permissions;
-    if (r.associations !== undefined)
-        w.associations = r.associations;
-    return w;
-}
-export function serializeType(t) {
-    const w = {
-        id: t.id,
-        baseId: t.baseId,
-        version: t.version,
-        name: t.name,
-        schema: t.schema,
-        schemaHash: t.schemaHash,
-        createdAt: t.createdAt.toISOString(),
-    };
-    if (t.migratesFrom !== undefined)
-        w.migratesFrom = t.migratesFrom;
-    return w;
-}
-export function serializeVersion(v) {
-    const w = {
-        version: v.version,
-        typeId: v.typeId,
-        content: v.content,
-        updatedAt: v.updatedAt.toISOString(),
-    };
-    if (v.createdBy !== undefined)
-        w.createdBy = serializeActor(v.createdBy);
-    if (v.updatedBy !== undefined)
-        w.updatedBy = serializeActor(v.updatedBy);
-    return w;
-}
-export function serializeJournalEntry(e) {
-    const w = {
-        seq: e.seq,
-        at: e.at.toISOString(),
-        kind: e.kind,
-        // Copied for the same reason serializeChange() copies: the array
-        // belongs to the entry the adapter read, not to this response.
-        ops: [...e.ops],
-        version: e.version,
-        typeId: e.typeId,
-    };
-    if (e.parentId !== undefined)
-        w.parentId = e.parentId;
-    if (e.actor !== undefined)
-        w.actor = serializeChangeActor(e.actor);
-    // Presence, not truthiness: `null` is the root and has to survive.
-    if (e.previousParentId !== undefined)
-        w.previousParentId = e.previousParentId;
-    if (e.associations !== undefined)
-        w.associations = e.associations;
-    return w;
-}
+/**
+ * @haverstack/wire-types
+ * -------------------------------------------------------
+ * The HTTP wire format's shapes and the encodings between them and core's
+ * types, shared by `@haverstack/adapter-api` and any server implementation
+ * so both sides read the same contract. One module per endpoint group, the
+ * same split `@haverstack/conformance-fixtures` uses. See
+ * docs/spec/wire-format.md.
+ */
+export { serializeChangeActor, serializeRecord, serializeType, serializeVersion, } from './records.js';
+export { serializeJournalEntry } from './journal.js';
+export { WIRE_ERROR_STATUS, STATUS_TO_CODE, isWireError, serializeError, deserializeError, errorForStatus, } from './errors.js';
+export { WIRE_PROTOCOL_VERSION, normalizeCapabilities, parseProtocolVersion, isProtocolCompatible, } from './discovery.js';
+export { AUTH_METHOD_DID_CHALLENGE, supportsDidChallenge, WIRE_AUTH_ERROR_STATUS, isWireAuthError, isRetryableAuthError, } from './auth.js';
+export { CHANGE_TRANSPORT_SSE, supportsChangeFeed, serializeChange, CHANGE_FRAME_READY, CHANGE_FRAME_RECORD, CHANGE_FRAME_RESET, isValidCursor, } from './change-feed.js';
+export { supportsInstallRequests } from './installs.js';
 /**
  * Re-exported from `@haverstack/core/wire`, which decodes wire dates on the
  * request side too — one definition, the same way `WireErrorCode` aliases
  * core's `StackErrorCode` rather than restating it.
  */
 export { parseDate } from '@haverstack/core/wire';
-/** Canonical HTTP status for each wire error code. */
-export const WIRE_ERROR_STATUS = {
-    bad_request: 400,
-    permission: 403,
-    not_found: 404,
-    conflict: 409,
-    // 412 (not 409): RFC 7232's status for a failed If-Match precondition,
-    // and distinct from 'conflict' — StackVersionConflictError is not a
-    // StackConflictError subtype (see its doc comment), so each code keeps
-    // its own unambiguous status, including for the status-only fallback
-    // below.
-    version_conflict: 412,
-    validation: 422,
-    /**
-     * No core code path currently produces a StackMigrationError over the
-     * wire (migration-graph errors are thrown during client-side migration
-     * registration, never as a server response) — this entry exists so a
-     * future server-side migration-graph check has a defined status to use.
-     */
-    migration: 500,
-    // Shares 409 with 'conflict', so a schema-drift response without a
-    // parseable body degrades to a generic StackConflictError in
-    // status-only reconstruction. See docs/spec/wire-format.md § Wire error
-    // body.
-    schema_drift: 409,
-    // 413 is unambiguous — no other wire code shares it — so status-only
-    // reconstruction (STATUS_TO_CODE below) recovers this class even from a
-    // bodyless response (e.g. a reverse proxy's own request-entity-too-large
-    // page, not the server's JSON error body).
-    payload_too_large: 413,
-    /**
-     * 503, not 408 or 504: the request arrived fine (408 says it didn't) and
-     * the server is not a gateway (504 says it is) — it declined to keep
-     * spending its own time on this one. Retryable, which is the part a
-     * client acts on, and the reason a query timeout must not reuse
-     * `bad_request`: that code means "malformed, retrying won't help."
-     */
-    timeout: 503,
-};
-/**
- * Statuses that unambiguously imply a wire error code, for reconstructing
- * an error from status alone when a response has no parseable wire error
- * body. 500 is deliberately excluded — it would misclassify ordinary
- * server bugs as StackMigrationError. See docs/spec/wire-format.md
- * § Wire error body.
- */
-export const STATUS_TO_CODE = {
-    400: 'bad_request',
-    403: 'permission',
-    404: 'not_found',
-    409: 'conflict',
-    412: 'version_conflict',
-    422: 'validation',
-    413: 'payload_too_large',
-    // 503 is deliberately excluded, for the same reason as 500: a bodyless
-    // 503 is a load balancer or a restarting process saying "not right now",
-    // and reporting that as StackTimeoutError would tell an app its query
-    // was too expensive when the server never saw it. The typed body is
-    // what distinguishes the two, so `timeout` only reconstructs from one.
-};
-const KNOWN_CODES = new Set(Object.keys(WIRE_ERROR_STATUS));
-/** Type guard: does this parsed JSON body look like a WireError? */
-export function isWireError(body) {
-    if (!body || typeof body !== 'object')
-        return false;
-    const err = body.error;
-    if (!err || typeof err !== 'object')
-        return false;
-    const code = err.code;
-    const message = err.message;
-    return typeof code === 'string' && KNOWN_CODES.has(code) && typeof message === 'string';
-}
-/**
- * Convert a thrown core error into its wire response. Used by server
- * implementations. Returns null for anything that isn't a StackError —
- * callers fall back to their own generic error handling, so an ordinary bug
- * stays a bare 500 rather than being dressed as a protocol error.
- */
-export function serializeError(err) {
-    if (!(err instanceof StackError))
-        return null;
-    const error = { code: err.code, message: err.message };
-    // The three classes carrying structured payload still need instanceof: a
-    // literal `code` doesn't narrow a class type to its subclass in TypeScript.
-    // Order-independent, since these are leaves with no subtype relation.
-    if (err instanceof StackValidationError) {
-        error.details = err.errors;
-    }
-    else if (err instanceof StackVersionConflictError) {
-        error.versionConflict = {
-            recordId: err.recordId,
-            expectedVersion: err.expectedVersion,
-            actualVersion: err.actualVersion,
-        };
-    }
-    else if (err instanceof StackSchemaDriftError) {
-        error.schemaDrift = { typeId: err.typeId, violations: err.violations };
-    }
-    return { status: WIRE_ERROR_STATUS[err.code], body: { error } };
-}
-/** Reconstruct the core error a WireError body describes. */
-export function deserializeError(body) {
-    const { code, message, details, versionConflict, schemaDrift } = body.error;
-    switch (code) {
-        case 'validation':
-            return new StackValidationError(details ?? []);
-        case 'permission':
-            return new StackPermissionError(message);
-        case 'not_found':
-            return new StackNotFoundError(message);
-        case 'conflict':
-            return new StackConflictError(message);
-        case 'version_conflict':
-            return new StackVersionConflictError(message, versionConflict?.recordId ?? '', versionConflict?.expectedVersion ?? -1, versionConflict?.actualVersion ?? -1);
-        case 'bad_request':
-            return new StackBadRequestError(message);
-        case 'migration':
-            return new StackMigrationError(message);
-        case 'schema_drift':
-            return new StackSchemaDriftError(schemaDrift?.typeId ?? '', schemaDrift?.violations ?? []);
-        case 'payload_too_large':
-            return new StackPayloadTooLargeError(message);
-        case 'timeout':
-            return new StackTimeoutError(message);
-    }
-}
-/**
- * Reconstruct a core error from an HTTP status alone (no usable wire error
- * body). Returns null for statuses with no unambiguous code — callers
- * should fall back to a generic adapter-level error.
- */
-export function errorForStatus(status, message) {
-    const code = STATUS_TO_CODE[status];
-    return code ? deserializeError({ error: { code, message } }) : null;
-}
-// -------------------------------------------------------
-// Discovery
-// -------------------------------------------------------
-/**
- * The wire protocol this package describes. Bump the major when a change
- * would make an older client read a response wrongly; bump the minor for
- * additions an older client can ignore. See docs/spec/wire-format.md
- * § Version negotiation.
- */
-export const WIRE_PROTOCOL_VERSION = '1.0';
-const CONTENT_FILTER_REACHES = new Set(['none', 'field', 'path']);
-const SORT_FIELDS = new Set(NATIVE_SORT_FIELDS);
-/**
- * Read a discovery response's capabilities, resolving anything absent,
- * malformed or unrecognized to the least capable value it could stand for
- * — one rule, applied once, rather than a default per key at each call
- * site. Silence is never a claim in either direction: a client that read
- * an omitted flag as support would send a query the server drops and
- * present the unfiltered superset that comes back as a filtered result.
- *
- * A `null` limit is the one entry that reads as permissive, because it
- * says only that this client cannot pre-check; the server's own ceiling
- * still answers with a 413.
- * See docs/spec/adapters.md § Adapter capabilities.
- */
-export function normalizeCapabilities(capabilities) {
-    const filter = capabilities?.filter;
-    const sort = capabilities?.sort;
-    const limits = capabilities?.limits;
-    const reach = filter?.content;
-    return {
-        filter: {
-            content: CONTENT_FILTER_REACHES.has(reach) ? reach : 'none',
-            contentPresent: filter?.contentPresent === true,
-            search: filter?.search === true,
-        },
-        sort: {
-            fields: (sort?.fields ?? []).filter((f) => SORT_FIELDS.has(f)),
-            contentField: sort?.contentField === true,
-        },
-        limits: {
-            attachmentBytes: finiteOrNull(limits?.attachmentBytes),
-            contentBytes: finiteOrNull(limits?.contentBytes),
-        },
-    };
-}
-/** A ceiling this client can compare against, or null for "cannot pre-check". */
-const finiteOrNull = (value) => typeof value === 'number' && Number.isFinite(value) ? value : null;
-/** The challenge–response handshake of docs/spec/wire-format.md § Authentication. */
-export const AUTH_METHOD_DID_CHALLENGE = 'did-challenge';
-/** Whether a server advertises the DID challenge–response handshake. */
-export function supportsDidChallenge(discovery) {
-    return discovery.auth?.methods?.includes(AUTH_METHOD_DID_CHALLENGE) ?? false;
-}
-/** Server→client streaming over `fetch`. The only transport in this version. */
-export const CHANGE_TRANSPORT_SSE = 'sse';
-/**
- * Whether a server offers a change feed this client can consume. A client
- * checks this and fails locally rather than learning it as a 404 partway
- * through a connection — the same reason `auth.methods` exists.
- */
-export function supportsChangeFeed(discovery) {
-    return discovery.changes?.transports?.includes(CHANGE_TRANSPORT_SSE) ?? false;
-}
-export const WIRE_AUTH_ERROR_STATUS = {
-    // Malformed input, not a rejected credential — there is nothing here to
-    // authenticate yet.
-    invalid_did: 400,
-    unknown_nonce: 401,
-    expired_nonce: 401,
-    invalid_signature: 401,
-};
-/** Codes a fresh handshake can resolve. Anything else is fatal to retry. */
-const RETRYABLE_AUTH_CODES = new Set(['unknown_nonce', 'expired_nonce']);
-const KNOWN_AUTH_CODES = new Set(Object.keys(WIRE_AUTH_ERROR_STATUS));
-/** Type guard: does this parsed JSON body look like a WireAuthError? */
-export function isWireAuthError(body) {
-    if (!body || typeof body !== 'object')
-        return false;
-    const err = body.error;
-    if (!err || typeof err !== 'object')
-        return false;
-    const code = err.code;
-    const message = err.message;
-    return typeof code === 'string' && KNOWN_AUTH_CODES.has(code) && typeof message === 'string';
-}
-/** Whether retrying the handshake from a fresh nonce could succeed. */
-export function isRetryableAuthError(code) {
-    return RETRYABLE_AUTH_CODES.has(code);
-}
-/** Shared by a change frame and a journal entry — one actor encoding, not two. */
-export function serializeChangeActor(actor) {
-    const w = serializeActor(actor);
-    if (actor.appId !== undefined)
-        w.appId = actor.appId;
-    return w;
-}
-/**
- * A change as a server frames it. A purge carries neither the record nor
- * its parent, whatever the subscriber asked for: purge is the
- * erasure primitive, and a frame carrying the body — or anything else
- * pointing at it — hands every subscriber a permanent copy of what the
- * stack has just destroyed.
- *
- * The rule lives here rather than at each call site because a server holds
- * the purged record at that moment, for the readability check it can only
- * make before the write, and so is in exactly the position to leak it. See
- * docs/spec/events.md § Purged records carry nothing.
- */
-export function serializeChange(c) {
-    const w = {
-        kind: c.kind,
-        // Copied, not aliased: a frame is serialized once and delivered to
-        // every subscriber, and the array it came from belongs to the emission.
-        ops: [...c.ops],
-        recordId: c.recordId,
-        typeId: c.typeId,
-        version: c.version,
-        updatedAt: c.updatedAt.toISOString(),
-    };
-    if (c.actor !== undefined)
-        w.actor = serializeChangeActor(c.actor);
-    if (c.cursor !== undefined)
-        w.cursor = c.cursor;
-    if (c.kind === 'purged')
-        return w;
-    if (c.parentId !== undefined)
-        w.parentId = c.parentId;
-    if (c.associationsAdded !== undefined)
-        w.associationsAdded = c.associationsAdded;
-    if (c.associationsRemoved !== undefined)
-        w.associationsRemoved = c.associationsRemoved;
-    if (c.record !== undefined)
-        w.record = serializeRecord(c.record);
-    return w;
-}
-/**
- * Frame names. Every frame carries one, and a client MUST ignore a name it
- * does not recognize — which is what makes a new frame an additive, minor
- * change rather than a break. See docs/spec/change-feed.md.
- */
-export const CHANGE_FRAME_READY = 'ready';
-export const CHANGE_FRAME_RECORD = 'record';
-export const CHANGE_FRAME_RESET = 'reset';
-/**
- * A cursor travels in an SSE `id:` field, so a value spanning a line would
- * truncate the frame carrying it. Same charset and same reason as the auth
- * nonce — see docs/spec/wire-format.md § The handshake.
- */
-const CURSOR_FORMAT = /^[A-Za-z0-9_-]+$/;
-/** Whether a cursor is framable: unreserved base64url characters only. */
-export function isValidCursor(cursor) {
-    return CURSOR_FORMAT.test(cursor);
-}
-/** Splits a MAJOR.MINOR protocol version. Returns null if it isn't one. */
-export function parseProtocolVersion(version) {
-    const match = /^(\d+)\.(\d+)$/.exec(version);
-    return match ? { major: Number(match[1]), minor: Number(match[2]) } : null;
-}
-/**
- * Majors must match; minors never have to. A higher server minor is additive
- * fields this client ignores, and a higher client minor is optional fields
- * the server may omit — neither can make a response read wrongly, which is
- * the only thing a major bump signals.
- */
-export function isProtocolCompatible(version, against = WIRE_PROTOCOL_VERSION) {
-    const server = parseProtocolVersion(version);
-    const client = parseProtocolVersion(against);
-    return server !== null && client !== null && server.major === client.major;
-}
-/** Whether a server advertises `POST /installs`. */
-export function supportsInstallRequests(discovery) {
-    return discovery.installs?.requests === true;
-}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGrD,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAYxB,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,oBAAoB,GACrB,MAAM,WAAW,CAAC;AAUnB,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/installs.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Installs
+ * -------------------------------------------------------
+ * `POST /installs`: an app asking the owner to approve its manifest.
+ * See docs/spec/wire-format.md § Installs.
+ */
+import type { AppManifest } from '@haverstack/core';
+import type { WireRecord } from './records.js';
+/**
+ * Whether a server takes install requests at `POST /installs`. Absent means
+ * it does not, and a client says so locally rather than learning it as a
+ * 404. An object for the same reason `changes` is one.
+ * See docs/spec/wire-format.md § Installs.
+ */
+export type DiscoveryInstalls = {
+    requests: boolean;
+};
+/** Whether a server advertises `POST /installs`. */
+export declare function supportsInstallRequests(discovery: {
+    installs?: DiscoveryInstalls;
+}): boolean;
+/** POST /installs. The key being installed is the session's, never named here. */
+export type WireInstallRequest = {
+    manifest: AppManifest;
+};
+/**
+ * POST /installs answers `pending` (202) while the owner has not approved
+ * this manifest for this key, and `installed` (200) once applying it would
+ * change nothing.
+ */
+export type WireInstallResponse = {
+    status: 'pending';
+} | {
+    status: 'installed';
+    install: WireRecord;
+};
+//# sourceMappingURL=installs.d.ts.map

package/dist/installs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installs.d.ts","sourceRoot":"","sources":["../src/installs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,oDAAoD;AACpD,wBAAgB,uBAAuB,CAAC,SAAS,EAAE;IAAE,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAAE,GAAG,OAAO,CAE5F;AAED,kFAAkF;AAClF,MAAM,MAAM,kBAAkB,GAAG;IAAE,QAAQ,EAAE,WAAW,CAAA;CAAE,CAAC;AAE3D;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC"}

package/dist/installs.js

@@ -0,0 +1,11 @@
+/**
+ * Installs
+ * -------------------------------------------------------
+ * `POST /installs`: an app asking the owner to approve its manifest.
+ * See docs/spec/wire-format.md § Installs.
+ */
+/** Whether a server advertises `POST /installs`. */
+export function supportsInstallRequests(discovery) {
+    return discovery.installs?.requests === true;
+}
+//# sourceMappingURL=installs.js.map

package/dist/installs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installs.js","sourceRoot":"","sources":["../src/installs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,oDAAoD;AACpD,MAAM,UAAU,uBAAuB,CAAC,SAA2C;IACjF,OAAO,SAAS,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;AAC/C,CAAC"}

package/dist/journal.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Change journal
+ * -------------------------------------------------------
+ * `GET /records/:id/journal`: the per-record log of what each write did.
+ * See docs/spec/wire-format.md § Journal.
+ */
+import type { AssociationChange, ChangeKind, ChangeOp, RecordJournalEntry } from '@haverstack/core';
+import { type WireChangeActor } from './records.js';
+/**
+ * Every field a `RecordJournalEntry` holds, since the whole entry is what
+ * makes a change recoverable; `content` lives on a snapshot instead. `seq`
+ * is dense per record and never the change feed's `cursor`. See
+ * docs/spec/wire-format.md § Journal.
+ */
+export type WireJournalEntry = {
+    seq: number;
+    at: string;
+    kind: ChangeKind;
+    ops: ChangeOp[];
+    version: number;
+    typeId: string;
+    parentId?: string;
+    actor?: WireChangeActor;
+    /**
+     * The container the move took the record out of — and the one field on
+     * any response where `null` is a value rather than an input spelling.
+     * Absent means this entry is not a reparent; present and `null` means it
+     * moved out of the root. Collapsing the two would lose which one
+     * happened, so the root sentinel travels here as it does on a request.
+     */
+    previousParentId?: string | null;
+    /**
+     * One tagged edit per association the write moved, each carrying its own
+     * `previous` where it had one. Has no counterpart on the change feed,
+     * which reports what is true now across two flat lists.
+     */
+    associations?: AssociationChange[];
+};
+/**
+ * The response envelope of `GET /records/:id/journal`. `cursor` is the only
+ * end-of-log signal, since a server may cap a page below the `limit` asked
+ * for. It carries the `seq` to send as the next `afterSeq`, and is null
+ * once nothing follows.
+ */
+export type WireJournalResponse = {
+    entries: WireJournalEntry[];
+    cursor: number | null;
+};
+export declare function serializeJournalEntry(e: RecordJournalEntry): WireJournalEntry;
+//# sourceMappingURL=journal.d.ts.map

package/dist/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../src/journal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACpG,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,QAAQ,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;;;OAIG;IACH,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACpC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,kBAAkB,GAAG,gBAAgB,CAiB7E"}

package/dist/journal.js

@@ -0,0 +1,30 @@
+/**
+ * Change journal
+ * -------------------------------------------------------
+ * `GET /records/:id/journal`: the per-record log of what each write did.
+ * See docs/spec/wire-format.md § Journal.
+ */
+import { serializeChangeActor } from './records.js';
+export function serializeJournalEntry(e) {
+    const w = {
+        seq: e.seq,
+        at: e.at.toISOString(),
+        kind: e.kind,
+        // Copied for the same reason serializeChange() copies: the array
+        // belongs to the entry the adapter read, not to this response.
+        ops: [...e.ops],
+        version: e.version,
+        typeId: e.typeId,
+    };
+    if (e.parentId !== undefined)
+        w.parentId = e.parentId;
+    if (e.actor !== undefined)
+        w.actor = serializeChangeActor(e.actor);
+    // Presence, not truthiness: `null` is the root and has to survive.
+    if (e.previousParentId !== undefined)
+        w.previousParentId = e.previousParentId;
+    if (e.associations !== undefined)
+        w.associations = e.associations;
+    return w;
+}
+//# sourceMappingURL=journal.js.map

package/dist/journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../src/journal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,oBAAoB,EAAwB,MAAM,cAAc,CAAC;AA4C1E,MAAM,UAAU,qBAAqB,CAAC,CAAqB;IACzD,MAAM,CAAC,GAAqB;QAC1B,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE;QACtB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,iEAAiE;QACjE,+DAA+D;QAC/D,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;QACf,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,MAAM,EAAE,CAAC,CAAC,MAAM;KACjB,CAAC;IACF,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS;QAAE,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;IACtD,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;QAAE,CAAC,CAAC,KAAK,GAAG,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACnE,mEAAmE;IACnE,IAAI,CAAC,CAAC,gBAAgB,KAAK,SAAS;QAAE,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,CAAC;IAC9E,IAAI,CAAC,CAAC,YAAY,KAAK,SAAS;QAAE,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC;IAClE,OAAO,CAAC,CAAC;AACX,CAAC"}