@opendatalabs/personal-server-ts-core 0.2.0 → 1.0.1

package/dist/contracts/binary.d.ts

@@ -0,0 +1,54 @@
+import { type DataFileEnvelope } from "@opendatalabs/vana-sdk/browser";
+/**
+ * Binary / unstructured data is carried inside the standard DataFileEnvelope's
+ * `data` record (the envelope schema is owned by the SDK and only permits a
+ * JSON object there, so the bytes are base64-encoded into a marked record).
+ * This keeps the entire encrypt → upload → register → download path unchanged;
+ * only ingest and read need to understand the binary shape.
+ */
+export declare const BINARY_MARKER: "$binary";
+export declare const BINARY_ENCODING: "base64";
+export interface BinaryEnvelopeData extends Record<string, unknown> {
+    $binary: true;
+    mimeType: string;
+    filename?: string;
+    /** Plaintext byte length (before base64). */
+    sizeBytes: number;
+    /** 0x-prefixed SHA-256 of the plaintext bytes. */
+    contentHash: `0x${string}`;
+    encoding: typeof BINARY_ENCODING;
+    content: string;
+    /** Free-form caller metadata (e.g. a description). Omitted when absent. */
+    metadata?: unknown;
+}
+/** Build the `data` record for a binary envelope (does not hash — see ingest). */
+export declare function buildBinaryEnvelopeData(params: {
+    bytes: Uint8Array;
+    mimeType: string;
+    filename?: string;
+    contentHash: `0x${string}`;
+    metadata?: unknown;
+}): BinaryEnvelopeData;
+export declare function isBinaryEnvelope(envelope: Pick<DataFileEnvelope, "data">): boolean;
+export interface DecodedBinary {
+    bytes: Uint8Array;
+    mimeType: string;
+    filename?: string;
+    metadata?: unknown;
+}
+/** Decode a binary envelope back to raw bytes for serving over HTTP. */
+export declare function decodeBinaryEnvelope(envelope: Pick<DataFileEnvelope, "data">): DecodedBinary;
+/**
+ * Parse a free-form metadata header value. Best-effort: a value that parses as
+ * JSON is stored as the parsed value (object/array/etc); anything else is kept
+ * as a plain string (so a bare description "just works"). Returns undefined for
+ * absent/blank input.
+ */
+export declare function parseMetadataHeader(value: string | null): unknown;
+/** Serialize metadata for an HTTP response header (string as-is, else JSON). */
+export declare function stringifyMetadataHeader(metadata: unknown): string;
+/** 0x-prefixed SHA-256 hex of the given bytes (Web Crypto, browser + node). */
+export declare function sha256Hex(bytes: Uint8Array): Promise<`0x${string}`>;
+export declare function bytesToBase64(bytes: Uint8Array): string;
+export declare function base64ToBytes(base64: string): Uint8Array;
+//# sourceMappingURL=binary.d.ts.map

package/dist/contracts/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../src/contracts/binary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAG,SAAkB,CAAC;AAChD,eAAO,MAAM,eAAe,EAAG,QAAiB,CAAC;AAEjD,MAAM,WAAW,kBAAmB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE,OAAO,eAAe,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,kFAAkF;AAClF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,kBAAkB,CAWrB;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,GACvC,OAAO,CAGT;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wEAAwE;AACxE,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,GACvC,aAAa,CAcf;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CASjE;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAEjE;AAED,+EAA+E;AAC/E,wBAAsB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,CAMzE;AAUD,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAOvD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAKxD"}

package/dist/contracts/binary.js

@@ -0,0 +1,92 @@
+/**
+ * Binary / unstructured data is carried inside the standard DataFileEnvelope's
+ * `data` record (the envelope schema is owned by the SDK and only permits a
+ * JSON object there, so the bytes are base64-encoded into a marked record).
+ * This keeps the entire encrypt → upload → register → download path unchanged;
+ * only ingest and read need to understand the binary shape.
+ */
+export const BINARY_MARKER = "$binary";
+export const BINARY_ENCODING = "base64";
+/** Build the `data` record for a binary envelope (does not hash — see ingest). */
+export function buildBinaryEnvelopeData(params) {
+    return {
+        $binary: true,
+        mimeType: params.mimeType,
+        ...(params.filename ? { filename: params.filename } : {}),
+        sizeBytes: params.bytes.length,
+        contentHash: params.contentHash,
+        encoding: BINARY_ENCODING,
+        content: bytesToBase64(params.bytes),
+        ...(params.metadata !== undefined ? { metadata: params.metadata } : {}),
+    };
+}
+export function isBinaryEnvelope(envelope) {
+    const data = envelope.data;
+    return data?.[BINARY_MARKER] === true;
+}
+/** Decode a binary envelope back to raw bytes for serving over HTTP. */
+export function decodeBinaryEnvelope(envelope) {
+    const data = envelope.data;
+    if (data?.[BINARY_MARKER] !== true || typeof data.content !== "string") {
+        throw new Error("Envelope does not contain binary data");
+    }
+    return {
+        bytes: base64ToBytes(data.content),
+        mimeType: typeof data.mimeType === "string"
+            ? data.mimeType
+            : "application/octet-stream",
+        filename: typeof data.filename === "string" ? data.filename : undefined,
+        metadata: data.metadata,
+    };
+}
+/**
+ * Parse a free-form metadata header value. Best-effort: a value that parses as
+ * JSON is stored as the parsed value (object/array/etc); anything else is kept
+ * as a plain string (so a bare description "just works"). Returns undefined for
+ * absent/blank input.
+ */
+export function parseMetadataHeader(value) {
+    if (value === null)
+        return undefined;
+    const trimmed = value.trim();
+    if (trimmed === "")
+        return undefined;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return value;
+    }
+}
+/** Serialize metadata for an HTTP response header (string as-is, else JSON). */
+export function stringifyMetadataHeader(metadata) {
+    return typeof metadata === "string" ? metadata : JSON.stringify(metadata);
+}
+/** 0x-prefixed SHA-256 hex of the given bytes (Web Crypto, browser + node). */
+export async function sha256Hex(bytes) {
+    const digest = await crypto.subtle.digest("SHA-256", bytes);
+    return ("0x" + bytesToHex(new Uint8Array(digest)));
+}
+function bytesToHex(bytes) {
+    let out = "";
+    for (const b of bytes)
+        out += b.toString(16).padStart(2, "0");
+    return out;
+}
+const BASE64_CHUNK = 0x8000;
+export function bytesToBase64(bytes) {
+    let binary = "";
+    for (let i = 0; i < bytes.length; i += BASE64_CHUNK) {
+        const chunk = bytes.subarray(i, i + BASE64_CHUNK);
+        binary += String.fromCharCode(...chunk);
+    }
+    return btoa(binary);
+}
+export function base64ToBytes(base64) {
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++)
+        bytes[i] = binary.charCodeAt(i);
+    return bytes;
+}
+//# sourceMappingURL=binary.js.map

package/dist/contracts/binary.js.map

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

package/dist/contracts/config.d.ts

@@ -0,0 +1,5 @@
+import { type ContractResult } from "./http.js";
+export declare function validateServerConfigContract(body: unknown): ContractResult;
+export declare function configReadErrorContract(kind: "not-found" | "read"): ContractResult;
+export declare function configWriteErrorContract(): ContractResult;
+//# sourceMappingURL=config.d.ts.map

package/dist/contracts/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/contracts/config.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAEnB,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAiB1E;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,WAAW,GAAG,MAAM,GACzB,cAAc,CAKhB;AAED,wBAAgB,wBAAwB,IAAI,cAAc,CAEzD"}

package/dist/contracts/config.js

@@ -0,0 +1,30 @@
+import { ServerConfigSchema } from "../schemas/server-config.js";
+import { contractOk, contractProtocolError, } from "./http.js";
+export function validateServerConfigContract(body) {
+    const result = ServerConfigSchema.safeParse(body);
+    if (!result.success) {
+        return {
+            ok: false,
+            status: 400,
+            body: {
+                error: {
+                    code: 400,
+                    errorCode: "VALIDATION_ERROR",
+                    message: "Invalid config",
+                    issues: result.error.issues,
+                },
+            },
+        };
+    }
+    return contractOk({ status: "saved", config: result.data });
+}
+export function configReadErrorContract(kind) {
+    if (kind === "not-found") {
+        return contractProtocolError(404, "NOT_FOUND", "Config file not found");
+    }
+    return contractProtocolError(500, "READ_ERROR", "Failed to read config");
+}
+export function configWriteErrorContract() {
+    return contractProtocolError(500, "WRITE_ERROR", "Failed to write config");
+}
+//# sourceMappingURL=config.js.map

package/dist/contracts/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/contracts/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EACL,UAAU,EACV,qBAAqB,GAEtB,MAAM,WAAW,CAAC;AAEnB,MAAM,UAAU,4BAA4B,CAAC,IAAa;IACxD,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,GAAG;YACX,IAAI,EAAE;gBACJ,KAAK,EAAE;oBACL,IAAI,EAAE,GAAG;oBACT,SAAS,EAAE,kBAAkB;oBAC7B,OAAO,EAAE,gBAAgB;oBACzB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;iBAC5B;aACF;SACF,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,IAA0B;IAE1B,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,OAAO,qBAAqB,CAAC,GAAG,EAAE,WAAW,EAAE,uBAAuB,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,qBAAqB,CAAC,GAAG,EAAE,YAAY,EAAE,uBAAuB,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,qBAAqB,CAAC,GAAG,EAAE,aAAa,EAAE,wBAAwB,CAAC,CAAC;AAC7E,CAAC"}

package/dist/contracts/data.d.ts

@@ -0,0 +1,115 @@
+import { type DataStoragePort } from "../ports/index.js";
+import { type DataFileEnvelope } from "@opendatalabs/vana-sdk/browser";
+import { type WriteResult } from "../storage/hierarchy/index.js";
+export type DataContractErrorCode = "INVALID_SCOPE" | "INVALID_BODY" | "NOT_FOUND";
+export interface DataContractErrorBody {
+    error: DataContractErrorCode;
+    message: string;
+}
+export interface DataContractError {
+    ok: false;
+    status: 400 | 404;
+    body: DataContractErrorBody;
+}
+export interface ListDataScopesContractInput {
+    storage: DataStoragePort;
+    scopePrefix?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface ListDataScopesContractResult {
+    ok: true;
+    response: {
+        scopes: ReturnType<DataStoragePort["listScopes"]>["scopes"];
+        total: number;
+        limit: number;
+        offset: number;
+    };
+}
+export interface ListDataVersionsContractInput {
+    storage: DataStoragePort;
+    scopeParam: string;
+    limit?: number;
+    offset?: number;
+}
+export interface ListDataVersionsContractResult {
+    ok: true;
+    scope: string;
+    response: {
+        scope: string;
+        versions: Array<{
+            fileId: string | null;
+            schemaId: string | null;
+            collectedAt: string;
+        }>;
+        total: number;
+        limit: number;
+        offset: number;
+    };
+}
+export interface ReadDataContractInput {
+    storage: DataStoragePort;
+    scopeParam: string;
+    fileId?: string;
+    at?: string;
+}
+export interface ReadDataContractResult {
+    ok: true;
+    scope: string;
+    envelope: DataFileEnvelope;
+}
+export interface IngestDataContractInput {
+    storage: DataStoragePort;
+    scopeParam: string;
+    body: unknown;
+    collectedAt: string;
+    status: "stored" | "syncing";
+}
+export interface IngestDataContractResult {
+    ok: true;
+    scope: string;
+    collectedAt: string;
+    response: {
+        scope: string;
+        collectedAt: string;
+        status: "stored" | "syncing";
+    };
+    writeResult: WriteResult;
+}
+export interface IngestBinaryDataContractInput {
+    storage: DataStoragePort;
+    scopeParam: string;
+    bytes: Uint8Array;
+    mimeType: string;
+    filename?: string;
+    /** Free-form caller metadata (e.g. a description) stored alongside the file. */
+    metadata?: unknown;
+    collectedAt: string;
+    status: "stored" | "syncing";
+}
+export interface DeleteDataScopeContractInput {
+    storage: DataStoragePort;
+    scopeParam: string;
+}
+export interface DeleteDataScopeContractResult {
+    ok: true;
+    deletedCount: number;
+}
+export declare function parseDataScopeContract(scopeParam: string): {
+    ok: true;
+    scope: string;
+} | DataContractError;
+export declare function listDataScopesContract(input: ListDataScopesContractInput): Promise<ListDataScopesContractResult>;
+export declare function listDataVersionsContract(input: ListDataVersionsContractInput): ListDataVersionsContractResult | DataContractError;
+export declare function readDataContract(input: ReadDataContractInput): Promise<ReadDataContractResult | DataContractError>;
+export declare function ingestDataContract(input: IngestDataContractInput): Promise<IngestDataContractResult | DataContractError>;
+/**
+ * Ingest unstructured/binary data (e.g. a PDF). The bytes are hashed and
+ * base64-encoded into a binary DataFileEnvelope, then written and indexed
+ * exactly like JSON ingest — so the downstream encrypt/upload/register path is
+ * unchanged. Unlike JSON ingest, the body is raw bytes (not a JSON object) and
+ * `schemaId` may be absent (the caller decides whether to auto-register one).
+ */
+export declare function ingestBinaryDataContract(input: IngestBinaryDataContractInput): Promise<IngestDataContractResult | DataContractError>;
+export declare function deleteDataScopeContract(input: DeleteDataScopeContractInput): Promise<DeleteDataScopeContractResult | DataContractError>;
+//# sourceMappingURL=data.d.ts.map

package/dist/contracts/data.d.ts.map

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

package/dist/contracts/data.js

@@ -0,0 +1,237 @@
+import { createDataFileEnvelope, ScopeSchema, } from "@opendatalabs/vana-sdk/browser";
+import { buildBinaryEnvelopeData, sha256Hex } from "./binary.js";
+import { buildDataBlocksAsync } from "../storage/blocks/build.js";
+function invalidScope(message) {
+    return {
+        ok: false,
+        status: 400,
+        body: {
+            error: "INVALID_SCOPE",
+            message,
+        },
+    };
+}
+export function parseDataScopeContract(scopeParam) {
+    const scopeResult = ScopeSchema.safeParse(scopeParam);
+    if (!scopeResult.success) {
+        return invalidScope(scopeResult.error.issues[0]?.message ?? "Invalid scope");
+    }
+    return { ok: true, scope: scopeResult.data };
+}
+function normalizeLimit(value) {
+    return value ?? 20;
+}
+function normalizeOffset(value) {
+    return value ?? 0;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+export async function listDataScopesContract(input) {
+    const limit = normalizeLimit(input.limit);
+    const offset = normalizeOffset(input.offset);
+    const result = input.storage.listScopes({
+        scopePrefix: input.scopePrefix,
+        limit,
+        offset,
+    });
+    const scopes = await Promise.all(result.scopes.map(async (summary) => {
+        const entry = input.storage.findEntry({
+            scope: summary.scope,
+            at: summary.latestCollectedAt,
+        });
+        if (!entry) {
+            return summary;
+        }
+        const hasBlocks = typeof input.storage.canReadScopeBlocks === "function"
+            ? await input.storage.canReadScopeBlocks(summary.scope, summary.latestCollectedAt)
+            : typeof input.storage.hasScopeBlocks === "function"
+                ? await input.storage.hasScopeBlocks(summary.scope, summary.latestCollectedAt)
+                : false;
+        return {
+            ...summary,
+            dataStatus: hasBlocks ? "ready" : "indexing",
+            sizeBytes: entry.sizeBytes,
+        };
+    }));
+    return {
+        ok: true,
+        response: {
+            scopes,
+            total: result.total,
+            limit,
+            offset,
+        },
+    };
+}
+export function listDataVersionsContract(input) {
+    const scopeResult = parseDataScopeContract(input.scopeParam);
+    if (!scopeResult.ok)
+        return scopeResult;
+    const limit = normalizeLimit(input.limit);
+    const offset = normalizeOffset(input.offset);
+    const entries = input.storage.listVersions(scopeResult.scope, {
+        limit,
+        offset,
+    });
+    return {
+        ok: true,
+        scope: scopeResult.scope,
+        response: {
+            scope: scopeResult.scope,
+            versions: entries.map((entry) => ({
+                fileId: entry.fileId,
+                schemaId: entry.schemaId,
+                collectedAt: entry.collectedAt,
+            })),
+            total: input.storage.countVersions(scopeResult.scope),
+            limit,
+            offset,
+        },
+    };
+}
+export async function readDataContract(input) {
+    const scopeResult = parseDataScopeContract(input.scopeParam);
+    if (!scopeResult.ok)
+        return scopeResult;
+    const entry = input.storage.findEntry({
+        scope: scopeResult.scope,
+        fileId: input.fileId,
+        at: input.at,
+    });
+    if (!entry) {
+        return {
+            ok: false,
+            status: 404,
+            body: {
+                error: "NOT_FOUND",
+                message: `No data found for scope "${scopeResult.scope}"`,
+            },
+        };
+    }
+    return {
+        ok: true,
+        scope: scopeResult.scope,
+        envelope: await input.storage.readEnvelope(scopeResult.scope, entry.collectedAt),
+    };
+}
+export async function ingestDataContract(input) {
+    const scopeResult = parseDataScopeContract(input.scopeParam);
+    if (!scopeResult.ok)
+        return scopeResult;
+    if (!isRecord(input.body)) {
+        return {
+            ok: false,
+            status: 400,
+            body: {
+                error: "INVALID_BODY",
+                message: "Request body must be a JSON object",
+            },
+        };
+    }
+    const envelope = createDataFileEnvelope(scopeResult.scope, input.collectedAt, input.body);
+    const writeResult = await input.storage.writeEnvelope(envelope);
+    try {
+        await writeBlockSidecars(input.storage, envelope);
+    }
+    catch {
+        // Best-effort bounded sidecars: raw envelope storage remains the source of truth.
+    }
+    await input.storage.insertEntry({
+        fileId: null,
+        schemaId: null,
+        path: writeResult.relativePath,
+        scope: scopeResult.scope,
+        collectedAt: input.collectedAt,
+        sizeBytes: writeResult.sizeBytes,
+    });
+    return {
+        ok: true,
+        scope: scopeResult.scope,
+        collectedAt: input.collectedAt,
+        response: {
+            scope: scopeResult.scope,
+            collectedAt: input.collectedAt,
+            status: input.status,
+        },
+        writeResult,
+    };
+}
+/**
+ * Ingest unstructured/binary data (e.g. a PDF). The bytes are hashed and
+ * base64-encoded into a binary DataFileEnvelope, then written and indexed
+ * exactly like JSON ingest — so the downstream encrypt/upload/register path is
+ * unchanged. Unlike JSON ingest, the body is raw bytes (not a JSON object) and
+ * `schemaId` may be absent (the caller decides whether to auto-register one).
+ */
+export async function ingestBinaryDataContract(input) {
+    const scopeResult = parseDataScopeContract(input.scopeParam);
+    if (!scopeResult.ok)
+        return scopeResult;
+    if (input.bytes.length === 0) {
+        return {
+            ok: false,
+            status: 400,
+            body: {
+                error: "INVALID_BODY",
+                message: "Request body must not be empty",
+            },
+        };
+    }
+    const contentHash = await sha256Hex(input.bytes);
+    const data = buildBinaryEnvelopeData({
+        bytes: input.bytes,
+        mimeType: input.mimeType,
+        filename: input.filename,
+        contentHash,
+        metadata: input.metadata,
+    });
+    const envelope = createDataFileEnvelope(scopeResult.scope, input.collectedAt, data);
+    const writeResult = await input.storage.writeEnvelope(envelope);
+    try {
+        await writeBlockSidecars(input.storage, envelope);
+    }
+    catch {
+        // Best-effort bounded sidecars: raw envelope storage remains the source of truth.
+    }
+    await input.storage.insertEntry({
+        fileId: null,
+        schemaId: null,
+        path: writeResult.relativePath,
+        scope: scopeResult.scope,
+        collectedAt: input.collectedAt,
+        sizeBytes: input.bytes.length,
+    });
+    return {
+        ok: true,
+        scope: scopeResult.scope,
+        collectedAt: input.collectedAt,
+        response: {
+            scope: scopeResult.scope,
+            collectedAt: input.collectedAt,
+            status: input.status,
+        },
+        writeResult,
+    };
+}
+export async function deleteDataScopeContract(input) {
+    const scopeResult = parseDataScopeContract(input.scopeParam);
+    if (!scopeResult.ok)
+        return scopeResult;
+    return {
+        ok: true,
+        deletedCount: await input.storage.deleteScope(scopeResult.scope),
+    };
+}
+async function writeBlockSidecars(storage, envelope) {
+    if (!storage.writeBlockManifest)
+        return;
+    const built = await buildDataBlocksAsync({
+        scope: envelope.scope,
+        collectedAt: envelope.collectedAt,
+        schemaId: envelope.schemaId,
+        content: envelope,
+    });
+    await storage.writeBlockManifest(envelope.scope, envelope.collectedAt, built.manifest, built.blocks);
+}
+//# sourceMappingURL=data.js.map

package/dist/contracts/data.js.map

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

package/dist/contracts/grants.d.ts

@@ -0,0 +1,45 @@
+import type { DataPortabilityGatewayConfig, GatewayClient } from "@opendatalabs/vana-sdk/browser";
+import type { ServerSigner } from "../signing/index.js";
+import { type ContractResult } from "./http.js";
+export interface VerifyGrantRequestBody {
+    grantorAddress: `0x${string}`;
+    granteeId: `0x${string}`;
+    scopes: string[];
+    grantVersion: string;
+    expiresAt: string;
+    signature: `0x${string}`;
+}
+export interface CreateGrantRequestBody {
+    granteeAddress: `0x${string}`;
+    scopes: string[];
+    /** Unix seconds; 0 = no expiry. Default 0 when omitted. */
+    expiresAt?: number;
+    /** Decimal uint256 string; default "1". */
+    grantVersion?: string;
+}
+export interface CreateGrantContractInput {
+    gateway: Pick<GatewayClient, "getBuilder" | "createGrant">;
+    serverOwner?: `0x${string}`;
+    serverSigner?: Pick<ServerSigner, "signGrantRegistration">;
+    body: unknown;
+}
+export interface RevokeGrantContractInput {
+    gateway: Pick<GatewayClient, "getGrant" | "revokeGrant">;
+    serverOwner?: `0x${string}`;
+    serverSigner?: Partial<Pick<ServerSigner, "signGrantRevocation">>;
+    grantId: string;
+}
+export interface ListGrantsContractInput {
+    gateway: Pick<GatewayClient, "listGrantsByUser">;
+    serverOwner?: `0x${string}`;
+}
+export interface VerifyGrantContractInput {
+    body: unknown;
+    gatewayConfig?: DataPortabilityGatewayConfig;
+    nowSeconds?: number;
+}
+export declare function listGrantsContract(input: ListGrantsContractInput): Promise<ContractResult>;
+export declare function createGrantContract(input: CreateGrantContractInput): Promise<ContractResult>;
+export declare function revokeGrantContract(input: RevokeGrantContractInput): Promise<ContractResult>;
+export declare function verifyGrantContract({ body, gatewayConfig, nowSeconds, }: VerifyGrantContractInput): Promise<ContractResult>;
+//# sourceMappingURL=grants.d.ts.map

package/dist/contracts/grants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grants.d.ts","sourceRoot":"","sources":["../../src/contracts/grants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,4BAA4B,EAC5B,aAAa,EAEd,MAAM,gCAAgC,CAAC;AAKxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAMnB,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,KAAK,MAAM,EAAE,CAAC;IAC9B,SAAS,EAAE,KAAK,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,KAAK,MAAM,EAAE,CAAC;CAC1B;AAMD,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,KAAK,MAAM,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,GAAG,aAAa,CAAC,CAAC;IAC3D,WAAW,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAC;IAC3D,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,aAAa,CAAC,CAAC;IACzD,WAAW,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;IACjD,WAAW,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,4BAA4B,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA2ED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,cAAc,CAAC,CAIzB;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,cAAc,CAAC,CA0DzB;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,cAAc,CAAC,CAoDzB;AAED,wBAAsB,mBAAmB,CAAC,EACxC,IAAI,EACJ,aAAa,EACb,UAA0C,GAC3C,EAAE,wBAAwB,GAAG,OAAO,CAAC,cAAc,CAAC,CAsCpD"}