mapples 0.1.0

package/README.md

@@ -0,0 +1,42 @@
+# mapples
+
+Two-way code sync between **Mapples Creator** and your Expo project (RFC-0002, over the JPATCH/1
+protocol from RFC-0001). Screens live as generated, editable TSX in your repo — `$sid`-tagged JSX
+is the code-side truth, extracted back into RenderDom and merged 3-way against the canvas.
+
+```bash
+npx mapples create my-app --project <projectId>   # scaffold a connected Expo app
+npx mapples init --project <projectId>            # link an existing Expo app
+npx mapples sync                                  # pull + push in one run
+npx mapples adopt app/settings.tsx                # force-adopt a plain RN screen
+npx mapples doctor                                # $sid lint + drift check
+```
+
+## What sync does
+
+1. Extracts every `*Mapplet.tsx` (`$sid` JSX → RenderDom; hooks/handlers/wrappers are invisible).
+2. Pulls the delta since the last synced HEAD (`GET ?since`, cold bootstrap when too far behind).
+3. 3-way merges per `$sid` node, per prop key: disjoint edits auto-merge; same-prop or
+   delete-vs-edit conflicts **deprecate** the file (`_depr_<ts>_<name>.tsx.old` — your version is
+   never overwritten or deleted) and regenerate it from Creator.
+4. Writes remote changes into your files **surgically** — user code is preserved byte-for-byte.
+5. Pushes your edits as one JPATCH transaction; 409s rebase and retry with the same txId; going
+   offline parks ops in `.mapples/outbox/` and drains them next run.
+6. Rewrites client-minted `c_` ids to server ids from the response `idMap`.
+
+Also synced: navigation ↔ `app/(mapples)/` route tree (layouts CLI-owned, wrappers create-once —
+rename a wrapper file to rename the route), style ↔ `mapples/theme.ts`, and assets ↔
+`mapples/assets/` + generated `assetMap.ts`.
+
+## Project state
+
+```
+.mapples/
+  config.json    # projectId, apiUrl, appDir, routesDir
+  head           # last synced HEAD + seq
+  pages.json     # pageId <-> file mapping
+  base/          # canonical JSON per entity at the last synced HEAD
+  outbox/        # parked transactions (offline)
+```
+
+Auth: set `MAPPLES_TOKEN` in the environment.

package/dist/adopt/mappingTable.d.ts

@@ -0,0 +1 @@
+export declare const PRIMITIVE_MAPPING: Record<string, string>;

package/dist/adopt/mappingTable.js

@@ -0,0 +1,18 @@
+// THE primitive mapping table (RFC-0002 §2) — react-native element name ->
+// Mapples registered component type. Target names verified against the
+// @mapples/ui schematics registry in mapples-open-kit (canonical), 2026-09-01:
+// the registered types are View, Text, Image, ScrollView, Button, TextInput,
+// FlatList (no "Styled*"/"Input"/"List" variants exist).
+// Swappable + snapshot-tested, same pattern as the figma-connector heuristics.
+export const PRIMITIVE_MAPPING = {
+    View: 'View',
+    Text: 'Text',
+    Image: 'Image',
+    ScrollView: 'ScrollView',
+    SafeAreaView: 'SafeAreaView',
+    Pressable: 'Button',
+    TouchableOpacity: 'Button',
+    TextInput: 'TextInput',
+    FlatList: 'FlatList',
+};
+//# sourceMappingURL=mappingTable.js.map

package/dist/adopt/mappingTable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappingTable.js","sourceRoot":"","sources":["../../src/adopt/mappingTable.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,uEAAuE;AACvE,+EAA+E;AAC/E,6EAA6E;AAC7E,yDAAyD;AACzD,+EAA+E;AAE/E,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,UAAU,EAAE,YAAY;IACxB,YAAY,EAAE,cAAc;IAC5B,SAAS,EAAE,QAAQ;IACnB,gBAAgB,EAAE,QAAQ;IAC1B,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;CACrB,CAAC"}

package/dist/adopt/scan.d.ts

@@ -0,0 +1,4 @@
+import type { PagesMap } from '../project/pagesMap.js';
+import type { AdoptCandidate } from '../types.js';
+export declare function scanForCandidates(root: string, pagesMap: PagesMap): AdoptCandidate[];
+export declare function toRelative(root: string, file: string): string;

package/dist/adopt/scan.js

@@ -0,0 +1,51 @@
+// Adoption scan: exported React components under app/ + mapples/ with no $sid
+// and absent from the pages manifest. Unadopted files are never touched.
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+import { scanComponents } from '@mapples/sid-ast';
+const SCAN_DIRS = ['app', 'mapples'];
+export function scanForCandidates(root, pagesMap) {
+    const managed = new Set(Object.values(pagesMap).map((m) => m.file));
+    const candidates = [];
+    const walk = (dir) => {
+        const abs = join(root, dir);
+        if (!existsSync(abs))
+            return;
+        for (const entry of readdirSync(abs, { withFileTypes: true })) {
+            const rel = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (entry.name === 'node_modules' || entry.name.startsWith('.'))
+                    continue;
+                walk(rel);
+                continue;
+            }
+            if (!entry.name.endsWith('.tsx'))
+                continue;
+            if (entry.name === '_layout.tsx' || entry.name.startsWith('_depr_'))
+                continue;
+            if (managed.has(rel))
+                continue;
+            const source = readFileSync(join(root, rel), 'utf8');
+            const info = scanComponents(source);
+            if (info.hasSid || !info.hasJsx)
+                continue;
+            if (info.markers.length > 0)
+                continue; // route wrappers / generated files
+            const componentName = info.exportedComponents[0];
+            if (!componentName)
+                continue;
+            candidates.push({
+                file: rel,
+                componentName,
+                kind: rel.split(sep)[0] === 'app' ? 'page' : 'component',
+            });
+        }
+    };
+    for (const dir of SCAN_DIRS)
+        walk(dir);
+    return candidates.sort((a, b) => (a.file < b.file ? -1 : 1));
+}
+export function toRelative(root, file) {
+    return relative(root, file);
+}
+//# sourceMappingURL=scan.js.map

package/dist/adopt/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../../src/adopt/scan.ts"],"names":[],"mappings":"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"}

package/dist/api/canonical.d.ts

@@ -0,0 +1,12 @@
+export declare const HASH_PREFIX = "b3:";
+export declare const PREFIX_HEX = 20;
+/**
+ * Compare two strings by their UTF-8 encoded bytes. UTF-8 byte order equals
+ * Unicode code-point order, so we compare code points — NOT UTF-16 code units
+ * (naive `sort()`), which diverge above the BMP (e.g. U+FF61 vs U+1F341).
+ */
+export declare function compareUtf8(a: string, b: string): number;
+export declare function canonicalJson(obj: unknown): string;
+export declare function canonicalBytes(obj: unknown): Uint8Array;
+/** `"b3:" + hex(blake3(canonical_bytes(obj)))[:20]` — the 80-bit wire prefix. */
+export declare function contentHash(obj: unknown): string;

package/dist/api/canonical.js

@@ -0,0 +1,65 @@
+// Canonical JSON + blake3 content hashing — RFC-0001 §4.2/§4.3, byte-identical
+// with the Python reference in rfc-0001-implementation-guide §3. Conformance is
+// pinned by the shared vectors in test/fixtures/vectors/canonical.json.
+import { blake3 } from '@noble/hashes/blake3';
+import { bytesToHex } from '@noble/hashes/utils';
+export const HASH_PREFIX = 'b3:';
+export const PREFIX_HEX = 20; // 80 bits on the wire
+/**
+ * Compare two strings by their UTF-8 encoded bytes. UTF-8 byte order equals
+ * Unicode code-point order, so we compare code points — NOT UTF-16 code units
+ * (naive `sort()`), which diverge above the BMP (e.g. U+FF61 vs U+1F341).
+ */
+export function compareUtf8(a, b) {
+    let i = 0;
+    let j = 0;
+    while (i < a.length && j < b.length) {
+        const ca = a.codePointAt(i); // reason: i < a.length guarantees a value
+        const cb = b.codePointAt(j); // reason: j < b.length guarantees a value
+        if (ca !== cb)
+            return ca < cb ? -1 : 1;
+        i += ca > 0xffff ? 2 : 1;
+        j += cb > 0xffff ? 2 : 1;
+    }
+    return a.length - i === 0 && b.length - j === 0 ? 0 : a.length - i === 0 ? -1 : 1;
+}
+function emit(v) {
+    if (v === null)
+        return 'null';
+    const t = typeof v;
+    if (t === 'boolean')
+        return v ? 'true' : 'false';
+    if (t === 'number') {
+        const n = v;
+        if (!Number.isFinite(n))
+            throw new Error('NaN/Inf not JSON');
+        // JS numbers are doubles; JSON.stringify already emits shortest round-trip
+        // form and collapses integral floats (1.0 -> "1").
+        return JSON.stringify(n);
+    }
+    if (t === 'string') {
+        // JSON.stringify escapes `"`, `\` and control chars, and emits non-ASCII
+        // raw — matching Python json.dumps(ensure_ascii=False).
+        return JSON.stringify(v);
+    }
+    if (Array.isArray(v))
+        return '[' + v.map(emit).join(',') + ']';
+    if (t === 'object') {
+        const entries = Object.entries(v).filter(([, x]) => x !== undefined);
+        entries.sort(([a], [b]) => compareUtf8(a, b));
+        return '{' + entries.map(([k, x]) => JSON.stringify(k) + ':' + emit(x)).join(',') + '}';
+    }
+    throw new Error(`non-JSON type: ${t}`);
+}
+export function canonicalJson(obj) {
+    return emit(obj);
+}
+export function canonicalBytes(obj) {
+    return new TextEncoder().encode(emit(obj));
+}
+/** `"b3:" + hex(blake3(canonical_bytes(obj)))[:20]` — the 80-bit wire prefix. */
+export function contentHash(obj) {
+    const digest = blake3(canonicalBytes(obj));
+    return HASH_PREFIX + bytesToHex(digest).slice(0, PREFIX_HEX);
+}
+//# sourceMappingURL=canonical.js.map

package/dist/api/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../../src/api/canonical.ts"],"names":[],"mappings":"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"}

package/dist/api/client.d.ts

@@ -0,0 +1,37 @@
+import { type AxiosInstance } from 'axios';
+import type { Bootstrap, CommitOk, Delta, Envelope } from '../types.js';
+export interface JpatchClientOptions {
+    baseUrl: string;
+    projectId: string;
+    token?: string;
+    actor?: string;
+    origin?: string;
+}
+/**
+ * Thin, faithful JPATCH/1 transport (RFC-0001 §5–§8). No retry logic here —
+ * commit.ts owns the retry-same-txId contract, poll.ts owns delta paging.
+ */
+export declare class JpatchClient {
+    readonly http: AxiosInstance;
+    readonly projectId: string;
+    readonly actor: string | undefined;
+    readonly origin: string | undefined;
+    constructor(opts: JpatchClientOptions);
+    private path;
+    commitRaw(envelope: Envelope): Promise<CommitOk>;
+    pullOnce(since: string): Promise<Delta>;
+    bootstrap(): Promise<Bootstrap>;
+    getObject(hash: string): Promise<unknown>;
+    /** Binary blob fetch (asset bodies, addressed as `sha256:<hex>`). */
+    getObjectBytes(hash: string): Promise<Uint8Array>;
+    /** Which of these content hashes is the store missing? Returns hash -> signed PUT URL. */
+    have(hashes: string[]): Promise<Record<string, string>>;
+    history(limit?: number): Promise<{
+        seq: number;
+        head: string;
+        actor: string;
+        ts: string;
+        summary: string;
+    }[]>;
+}
+export declare function isNetworkError(err: unknown): boolean;

package/dist/api/client.js

@@ -0,0 +1,79 @@
+import axios, { AxiosError } from 'axios';
+import { errorFromBody } from './errors.js';
+/**
+ * Thin, faithful JPATCH/1 transport (RFC-0001 §5–§8). No retry logic here —
+ * commit.ts owns the retry-same-txId contract, poll.ts owns delta paging.
+ */
+export class JpatchClient {
+    http;
+    projectId;
+    actor;
+    origin;
+    constructor(opts) {
+        this.projectId = opts.projectId;
+        this.actor = opts.actor;
+        this.origin = opts.origin;
+        this.http = axios.create({
+            baseURL: opts.baseUrl.replace(/\/+$/, ''),
+            headers: opts.token ? { Authorization: `Bearer ${opts.token}` } : {},
+            // We map error bodies ourselves; axios must hand them to us.
+            validateStatus: () => true,
+            timeout: 30_000,
+        });
+    }
+    path(suffix = '') {
+        return `/${this.projectId}/canvas${suffix}`;
+    }
+    async commitRaw(envelope) {
+        const res = await this.http.post(this.path(), envelope);
+        if (res.status === 200 || res.status === 201)
+            return res.data;
+        throw errorFromBody(res.status, res.data);
+    }
+    async pullOnce(since) {
+        const res = await this.http.get(this.path(), { params: { since } });
+        if (res.status === 200)
+            return res.data;
+        throw errorFromBody(res.status, res.data);
+    }
+    async bootstrap() {
+        const res = await this.http.get(this.path());
+        if (res.status === 200)
+            return res.data;
+        throw errorFromBody(res.status, res.data);
+    }
+    async getObject(hash) {
+        const res = await this.http.get(this.path(`/objects/${encodeURIComponent(hash)}`));
+        if (res.status === 200)
+            return res.data;
+        throw errorFromBody(res.status, res.data);
+    }
+    /** Binary blob fetch (asset bodies, addressed as `sha256:<hex>`). */
+    async getObjectBytes(hash) {
+        const res = await this.http.get(this.path(`/objects/${encodeURIComponent(hash)}`), {
+            responseType: 'arraybuffer',
+        });
+        if (res.status === 200)
+            return new Uint8Array(res.data);
+        throw errorFromBody(res.status, JSON.parse(Buffer.from(res.data).toString('utf8')));
+    }
+    /** Which of these content hashes is the store missing? Returns hash -> signed PUT URL. */
+    async have(hashes) {
+        if (hashes.length > 500)
+            throw new Error('objects/have accepts at most 500 hashes per call');
+        const res = await this.http.post(this.path('/objects/have'), hashes);
+        if (res.status === 200)
+            return res.data;
+        throw errorFromBody(res.status, res.data);
+    }
+    async history(limit = 50) {
+        const res = await this.http.get(this.path('/history'), { params: { limit } });
+        if (res.status === 200)
+            return res.data;
+        throw errorFromBody(res.status, res.data);
+    }
+}
+export function isNetworkError(err) {
+    return err instanceof AxiosError && !err.response;
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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"}

package/dist/api/commit.d.ts

@@ -0,0 +1,18 @@
+import type { CommitOk, Envelope, JpatchOp } from '../types.js';
+import type { JpatchClient } from './client.js';
+export declare function mintTxId(): string;
+export declare function mintCid(): string;
+export interface CommitParams {
+    base: string;
+    ops: JpatchOp[];
+    txId?: string;
+    revertTo?: string;
+}
+export declare function buildEnvelope(client: JpatchClient, params: CommitParams): Envelope;
+/**
+ * POST the transaction, retrying the SAME txId on transport failures (the
+ * server's txId tombstone makes this safe — a replay returns the original
+ * result). RFC-0001 §7.3. 409 HEAD_MISMATCH is NOT retried here: the caller
+ * must rebase and call again with the same txId (merge/rebase.ts owns that loop).
+ */
+export declare function commitWithTransportRetry(client: JpatchClient, envelope: Envelope, maxAttempts?: number): Promise<CommitOk>;

package/dist/api/commit.js

@@ -0,0 +1,47 @@
+import { ulid } from 'ulid';
+import { isNetworkError } from './client.js';
+export function mintTxId() {
+    return `tx_${ulid()}`;
+}
+export function mintCid() {
+    return `c_${ulid()}`;
+}
+export function buildEnvelope(client, params) {
+    const envelope = {
+        protocol: 'jpatch/1',
+        schema: 1,
+        txId: params.txId ?? mintTxId(),
+        base: params.base,
+        ops: params.ops,
+        meta: {
+            ...(client.actor ? { actor: client.actor } : {}),
+            ...(client.origin ? { origin: client.origin } : {}),
+            ts: new Date().toISOString(),
+        },
+    };
+    if (params.revertTo !== undefined)
+        envelope.revertTo = params.revertTo;
+    return envelope;
+}
+/**
+ * POST the transaction, retrying the SAME txId on transport failures (the
+ * server's txId tombstone makes this safe — a replay returns the original
+ * result). RFC-0001 §7.3. 409 HEAD_MISMATCH is NOT retried here: the caller
+ * must rebase and call again with the same txId (merge/rebase.ts owns that loop).
+ */
+export async function commitWithTransportRetry(client, envelope, maxAttempts = 5) {
+    let lastErr;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        try {
+            return await client.commitRaw(envelope);
+        }
+        catch (err) {
+            if (!isNetworkError(err))
+                throw err;
+            lastErr = err;
+            await new Promise((r) => setTimeout(r, Math.min(2 ** attempt * 250, 4_000)));
+        }
+    }
+    throw lastErr;
+}
+//# sourceMappingURL=commit.js.map

package/dist/api/commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.js","sourceRoot":"","sources":["../../src/api/commit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,UAAU,QAAQ;IACtB,OAAO,MAAM,IAAI,EAAE,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,OAAO,KAAK,IAAI,EAAE,EAAE,CAAC;AACvB,CAAC;AASD,MAAM,UAAU,aAAa,CAAC,MAAoB,EAAE,MAAoB;IACtE,MAAM,QAAQ,GAAa;QACzB,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,CAAC;QACT,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,QAAQ,EAAE;QAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,IAAI,EAAE;YACJ,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SAC7B;KACF,CAAC;IACF,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;QAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACvE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAoB,EACpB,QAAkB,EAClB,WAAW,GAAG,CAAC;IAEf,IAAI,OAAgB,CAAC;IACrB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,OAAO,MAAM,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;gBAAE,MAAM,GAAG,CAAC;YACpC,OAAO,GAAG,GAAG,CAAC;YACd,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,MAAM,OAAO,CAAC;AAChB,CAAC"}

package/dist/api/errors.d.ts

@@ -0,0 +1,30 @@
+import type { Delta, JpatchOp } from '../types.js';
+export type JpatchErrorCode = 'HEAD_MISMATCH' | 'HASH_MISMATCH' | 'CID_UNRESOLVED' | 'UNKNOWN_ENTITY' | 'PATCH_INVALID' | 'CHILDREN_PRESENT' | 'OBJECT_MISSING' | 'TX_TOO_LARGE' | 'PROJECT_LOCKED' | 'FORBIDDEN' | 'SNAPSHOT_REQUIRED';
+export declare class JpatchError extends Error {
+    readonly code: JpatchErrorCode;
+    readonly http: number;
+    readonly body: Record<string, unknown>;
+    constructor(code: JpatchErrorCode, message: string, body?: Record<string, unknown>);
+}
+/** 409 HEAD_MISMATCH carries the current head and the delta from the stale base. */
+export declare class HeadMismatchError extends JpatchError {
+    readonly head: string;
+    readonly delta: Delta;
+    constructor(head: string, delta: Delta);
+}
+/** A rebase dropped ops whose target was deleted/re-typed under us — the only user-visible conflict (RFC §7.1). */
+export declare class OpsDroppedNotice {
+    readonly dropped: JpatchOp[];
+    constructor(dropped: JpatchOp[]);
+}
+export declare function isJpatchErrorBody(body: unknown): body is {
+    code: JpatchErrorCode;
+    message?: string;
+} & Record<string, unknown>;
+/** A response that is neither a success nor a recognized RFC-0001 error body. Never mapped, never retried. */
+export declare class UnexpectedResponseError extends Error {
+    readonly status: number;
+    readonly responseBody: unknown;
+    constructor(status: number, responseBody: unknown);
+}
+export declare function errorFromBody(status: number, body: unknown): Error;

package/dist/api/errors.js

@@ -0,0 +1,74 @@
+// Typed errors — the full RFC-0001 §8 table plus SNAPSHOT_REQUIRED (§6 delta
+// paging: a client too far behind, or a pruned base, must cold-bootstrap).
+const HTTP_BY_CODE = {
+    HEAD_MISMATCH: 409,
+    HASH_MISMATCH: 409,
+    CID_UNRESOLVED: 422,
+    UNKNOWN_ENTITY: 422,
+    PATCH_INVALID: 422,
+    CHILDREN_PRESENT: 409,
+    OBJECT_MISSING: 424,
+    TX_TOO_LARGE: 413,
+    PROJECT_LOCKED: 423,
+    FORBIDDEN: 403,
+    SNAPSHOT_REQUIRED: 409,
+};
+export class JpatchError extends Error {
+    code;
+    http;
+    body;
+    constructor(code, message, body = {}) {
+        super(`${code}: ${message}`);
+        this.name = 'JpatchError';
+        this.code = code;
+        this.http = HTTP_BY_CODE[code];
+        this.body = body;
+    }
+}
+/** 409 HEAD_MISMATCH carries the current head and the delta from the stale base. */
+export class HeadMismatchError extends JpatchError {
+    head;
+    delta;
+    constructor(head, delta) {
+        super('HEAD_MISMATCH', `base is not current HEAD (now ${head})`, { head, delta });
+        this.head = head;
+        this.delta = delta;
+    }
+}
+/** A rebase dropped ops whose target was deleted/re-typed under us — the only user-visible conflict (RFC §7.1). */
+export class OpsDroppedNotice {
+    dropped;
+    constructor(dropped) {
+        this.dropped = dropped;
+    }
+}
+export function isJpatchErrorBody(body) {
+    if (typeof body !== 'object' || body === null)
+        return false;
+    const code = body.code;
+    return typeof code === 'string' && Object.prototype.hasOwnProperty.call(HTTP_BY_CODE, code);
+}
+/** A response that is neither a success nor a recognized RFC-0001 error body. Never mapped, never retried. */
+export class UnexpectedResponseError extends Error {
+    status;
+    responseBody;
+    constructor(status, responseBody) {
+        super(`unexpected response (HTTP ${status}): ${JSON.stringify(responseBody)}`);
+        this.status = status;
+        this.responseBody = responseBody;
+        this.name = 'UnexpectedResponseError';
+    }
+}
+export function errorFromBody(status, body) {
+    if (isJpatchErrorBody(body)) {
+        const { code, message, ...rest } = body;
+        if (code === 'HEAD_MISMATCH') {
+            const head = rest.head;
+            const delta = rest.delta;
+            return new HeadMismatchError(head, delta);
+        }
+        return new JpatchError(code, typeof message === 'string' ? message : '', rest);
+    }
+    return new UnexpectedResponseError(status, body);
+}
+//# sourceMappingURL=errors.js.map

package/dist/api/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/api/errors.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,2EAA2E;AAiB3E,MAAM,YAAY,GAAoC;IACpD,aAAa,EAAE,GAAG;IAClB,aAAa,EAAE,GAAG;IAClB,cAAc,EAAE,GAAG;IACnB,cAAc,EAAE,GAAG;IACnB,aAAa,EAAE,GAAG;IAClB,gBAAgB,EAAE,GAAG;IACrB,cAAc,EAAE,GAAG;IACnB,YAAY,EAAE,GAAG;IACjB,cAAc,EAAE,GAAG;IACnB,SAAS,EAAE,GAAG;IACd,iBAAiB,EAAE,GAAG;CACvB,CAAC;AAEF,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAkB;IACtB,IAAI,CAAS;IACb,IAAI,CAA0B;IAEvC,YAAY,IAAqB,EAAE,OAAe,EAAE,OAAgC,EAAE;QACpF,KAAK,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,oFAAoF;AACpF,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IACvC,IAAI,CAAS;IACb,KAAK,CAAQ;IAEtB,YAAY,IAAY,EAAE,KAAY;QACpC,KAAK,CAAC,eAAe,EAAE,iCAAiC,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAClF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,mHAAmH;AACnH,MAAM,OAAO,gBAAgB;IACN;IAArB,YAAqB,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;CAC7C;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAa;IAEb,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,IAAI,GAAI,IAAgC,CAAC,IAAI,CAAC;IACpD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;AAC9F,CAAC;AAED,8GAA8G;AAC9G,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAErC;IACA;IAFX,YACW,MAAc,EACd,YAAqB;QAE9B,KAAK,CAAC,6BAA6B,MAAM,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAHtE,WAAM,GAAN,MAAM,CAAQ;QACd,iBAAY,GAAZ,YAAY,CAAS;QAG9B,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,IAAa;IACzD,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACxC,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;YACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAc,CAAC;YAClC,OAAO,IAAI,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,WAAW,CAAC,IAAI,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,IAAI,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACnD,CAAC"}

package/dist/api/objects.d.ts

@@ -0,0 +1,55 @@
+import type { Bootstrap, RenderDomNode } from '../types.js';
+import type { JpatchClient } from './client.js';
+export interface PageEntity {
+    id: string;
+    name: string;
+    route: string;
+    root: RenderDomNode;
+}
+export interface ComponentEntity {
+    id: string;
+    name: string;
+    root: RenderDomNode;
+}
+export interface NavigationDocument {
+    routes: NavigationRoute[];
+    layouts: Record<string, unknown>;
+}
+export interface NavigationRoute {
+    id: string;
+    name: string;
+    path: string;
+    pageId?: string;
+    [k: string]: unknown;
+}
+export interface StyleConfig {
+    theme: Record<string, unknown>;
+    typography: Record<string, unknown>;
+    sizing: Record<string, unknown>;
+}
+export type AssetIndex = Record<string, {
+    sha256: string;
+    mime: string;
+    w?: number;
+    h?: number;
+    name?: string;
+}>;
+export interface ProjectState {
+    head: string;
+    seq: number;
+    pages: Map<string, PageEntity>;
+    components: Map<string, ComponentEntity>;
+    navigation: NavigationDocument;
+    style: StyleConfig;
+    assets: AssetIndex;
+}
+/** Cold bootstrap: walk the manifest and fetch every blob (RFC-0001 §6). */
+export declare function fetchProjectState(client: JpatchClient, boot: Bootstrap): Promise<ProjectState>;
+/**
+ * Upload binary asset bodies: `objects/have` filters to genuinely missing
+ * hashes, then PUT bytes to each signed URL (RFC-0001 §6, binary assets).
+ */
+export declare function uploadMissingAssets(client: JpatchClient, bodies: Map<string, {
+    bytes: Uint8Array;
+    mime: string;
+}>): Promise<string[]>;

package/dist/api/objects.js

@@ -0,0 +1,48 @@
+import axios from 'axios';
+/** Cold bootstrap: walk the manifest and fetch every blob (RFC-0001 §6). */
+export async function fetchProjectState(client, boot) {
+    const [pagesIndex, componentsIndex, navigation, style, assets] = await Promise.all([
+        client.getObject(boot.manifest.pages),
+        client.getObject(boot.manifest.components),
+        client.getObject(boot.manifest.navigation),
+        client.getObject(boot.manifest.style),
+        client.getObject(boot.manifest.assets),
+    ]);
+    const pages = new Map();
+    await Promise.all(Object.entries(pagesIndex).map(async ([id, hash]) => {
+        const blob = (await client.getObject(hash));
+        pages.set(id, { id, ...blob });
+    }));
+    const components = new Map();
+    await Promise.all(Object.entries(componentsIndex).map(async ([id, hash]) => {
+        const blob = (await client.getObject(hash));
+        components.set(id, { id, ...blob });
+    }));
+    return { head: boot.head, seq: boot.seq, pages, components, navigation, style, assets };
+}
+/**
+ * Upload binary asset bodies: `objects/have` filters to genuinely missing
+ * hashes, then PUT bytes to each signed URL (RFC-0001 §6, binary assets).
+ */
+export async function uploadMissingAssets(client, bodies) {
+    const hashes = [...bodies.keys()];
+    const uploaded = [];
+    for (let i = 0; i < hashes.length; i += 500) {
+        const missing = await client.have(hashes.slice(i, i + 500));
+        for (const [hash, putUrl] of Object.entries(missing)) {
+            const body = bodies.get(hash);
+            if (!body)
+                throw new Error(`objects/have returned a hash we never asked about: ${hash}`);
+            const res = await axios.put(putUrl, body.bytes, {
+                headers: { 'Content-Type': body.mime },
+                validateStatus: () => true,
+            });
+            if (res.status < 200 || res.status >= 300) {
+                throw new Error(`asset upload failed (HTTP ${res.status}) for ${hash}`);
+            }
+            uploaded.push(hash);
+        }
+    }
+    return uploaded;
+}
+//# sourceMappingURL=objects.js.map

package/dist/api/objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.js","sourceRoot":"","sources":["../../src/api/objects.ts"],"names":[],"mappings":"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"}