@opendatalabs/personal-server-ts-core 0.0.1-canary.00328bf

package/dist/client.d.ts

@@ -0,0 +1,233 @@
+import { type DataFileEnvelope, type DataPortabilityGatewayConfig, type GatewayClient, type GrantListItem, type RegisterServerParams, type RegisterServerResult, type Web3SignedSignFn } from "@opendatalabs/vana-sdk/browser";
+import { type PersonalServerRegistrationTypedData } from "@opendatalabs/vana-sdk/protocol/personal-server-registration";
+import type { AccessLogEntry } from "./logging/access-log.js";
+import type { ScopeSummary } from "./storage/index/types.js";
+import type { SyncStatus } from "./sync/types.js";
+export type PersonalServerKind = "node" | "lite";
+export type PersonalServerStatus = "starting" | "ready" | "unavailable" | "stopped" | "error";
+export interface PersonalServerIdentity {
+    address: `0x${string}`;
+    publicKey: `0x${string}`;
+    serverId: string | null;
+}
+export interface PersonalServerUrls {
+    local: string | null;
+    public: string | null;
+    apiOrigin: string | null;
+    registration: string | null;
+}
+export type PersonalServerRegistrationCandidate = Omit<RegisterServerParams, "signature">;
+export interface PersonalServerRegistrationRequest {
+    gatewayConfig: DataPortabilityGatewayConfig;
+    candidate: PersonalServerRegistrationCandidate;
+    typedData: PersonalServerRegistrationTypedData;
+}
+export interface PersonalServerInfo {
+    kind: PersonalServerKind;
+    status: PersonalServerStatus;
+    ownerAddress: `0x${string}` | null;
+    server: PersonalServerIdentity | null;
+    urls: PersonalServerUrls;
+    registration: {
+        registered: boolean;
+        candidate: PersonalServerRegistrationCandidate | null;
+    };
+    gatewayUrl: string | null;
+    gatewayConfig: DataPortabilityGatewayConfig | null;
+    checkedAt?: string;
+    details?: unknown;
+}
+export interface PersonalServerReadyOptions {
+    publicUrl?: boolean;
+}
+export interface PersonalServerPrepareRegistrationOptions {
+    serverUrl?: string;
+}
+export interface PersonalServerSubmitRegistrationOptions {
+    request?: PersonalServerRegistrationRequest;
+    serverUrl?: string;
+    signature: `0x${string}`;
+}
+export type PersonalServerOwnerAuth = {
+    signMessage: Web3SignedSignFn;
+} | {
+    bearerToken: string;
+};
+export type PersonalServerPostDataOptions = PersonalServerOwnerAuth & {
+    headers?: Record<string, string>;
+};
+export interface PersonalServerListDataOptions {
+    scopePrefix?: string;
+    limit?: number;
+    offset?: number;
+    auth?: PersonalServerOwnerAuth;
+    headers?: Record<string, string>;
+}
+export interface PersonalServerListDataResult {
+    scopes: ScopeSummary[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface PersonalServerListAccessLogsOptions {
+    limit?: number;
+    offset?: number;
+    auth?: PersonalServerOwnerAuth;
+    headers?: Record<string, string>;
+}
+export interface PersonalServerListAccessLogsResult {
+    logs: AccessLogEntry[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface PersonalServerListVersionsOptions {
+    limit?: number;
+    offset?: number;
+    auth?: PersonalServerOwnerAuth;
+    headers?: Record<string, string>;
+}
+export interface PersonalServerDataVersion {
+    fileId: string | null;
+    schemaId: string | null;
+    collectedAt: string;
+}
+export interface PersonalServerListVersionsResult {
+    scope: string;
+    versions: PersonalServerDataVersion[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface PersonalServerReadDataOptions {
+    grantId?: string;
+    fileId?: string;
+    at?: string;
+    auth?: PersonalServerOwnerAuth;
+    headers?: Record<string, string>;
+}
+export interface PersonalServerSyncTriggerResult {
+    status: "started" | "disabled";
+    message?: string;
+    fileId?: string;
+}
+export interface PersonalServerAuthRequestOptions {
+    auth?: PersonalServerOwnerAuth;
+    headers?: Record<string, string>;
+}
+export interface PersonalServerCreateGrantOptions extends PersonalServerAuthRequestOptions {
+    granteeAddress: `0x${string}`;
+    scopes: string[];
+    /** Unix seconds. 0 or omitted = perpetual. */
+    expiresAt?: number;
+    /**
+     * Decimal uint256 string. Defaults to "1" for first registration.
+     * Re-registration must pass a strictly higher value than the live grant's
+     * grantVersion; otherwise the gateway returns 409. Shares the monotonic
+     * (grantor, grantee) nonce with revocation (canary 87b4310).
+     */
+    grantVersion?: string;
+}
+export interface PersonalServerCreateGrantResult {
+    grantId?: string;
+}
+export interface PersonalServerListGrantsResult {
+    grants: GrantListItem[];
+}
+export interface PersonalServerRevokeGrantResult {
+    status: "revoked";
+    grantId: string;
+}
+export interface PersonalServerHandle {
+    readonly kind: PersonalServerKind;
+    ready(options?: PersonalServerReadyOptions): Promise<PersonalServerInfo>;
+    info(): Promise<PersonalServerInfo>;
+    prepareRegistration(options?: PersonalServerPrepareRegistrationOptions): Promise<PersonalServerRegistrationRequest>;
+    submitRegistration(options: PersonalServerSubmitRegistrationOptions): Promise<RegisterServerResult>;
+    fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
+    postData(scope: string, body: unknown, options: PersonalServerPostDataOptions): Promise<{
+        scope: string;
+        collectedAt: string;
+        status: string;
+    }>;
+    listData(options?: PersonalServerListDataOptions): Promise<PersonalServerListDataResult>;
+    /**
+     * Read the owner's access-log entries, newest first. Owner-only — the
+     * request goes through the same Web3Signed owner auth as {@link listData}.
+     * Returns paginated entries describing which builders read which scopes.
+     */
+    listAccessLogs(options?: PersonalServerListAccessLogsOptions): Promise<PersonalServerListAccessLogsResult>;
+    listVersions(scope: string, options?: PersonalServerListVersionsOptions): Promise<PersonalServerListVersionsResult>;
+    readData(scope: string, options?: PersonalServerReadDataOptions): Promise<DataFileEnvelope>;
+    createGrant(options: PersonalServerCreateGrantOptions): Promise<PersonalServerCreateGrantResult>;
+    listGrants(options?: PersonalServerAuthRequestOptions): Promise<PersonalServerListGrantsResult>;
+    revokeGrant(grantId: string, options?: PersonalServerAuthRequestOptions): Promise<PersonalServerRevokeGrantResult>;
+    syncStatus(options?: PersonalServerAuthRequestOptions): Promise<SyncStatus>;
+    syncNow(options?: PersonalServerAuthRequestOptions): Promise<PersonalServerSyncTriggerResult>;
+    stop(): Promise<void>;
+}
+export interface PersonalServerClientErrorBody {
+    error?: {
+        code?: number;
+        errorCode?: string;
+        message?: string;
+        details?: unknown;
+    };
+    [key: string]: unknown;
+}
+export declare class PersonalServerClientError extends Error {
+    readonly status: number;
+    readonly errorCode?: string;
+    readonly details?: unknown;
+    readonly body?: unknown;
+    constructor(params: {
+        message: string;
+        status: number;
+        errorCode?: string;
+        details?: unknown;
+        body?: unknown;
+    });
+}
+export interface PersonalServerHealthRegistration {
+    ownerAddress: `0x${string}`;
+    serverAddress: `0x${string}`;
+    publicKey: `0x${string}`;
+    serverUrl: string;
+    serverId: string | null;
+    registered: boolean;
+}
+export declare function createPersonalServerRegistrationRequest(params: {
+    gatewayConfig: DataPortabilityGatewayConfig;
+    ownerAddress: `0x${string}`;
+    serverAddress: `0x${string}`;
+    publicKey: `0x${string}`;
+    serverUrl: string;
+}): PersonalServerRegistrationRequest;
+export declare function createPersonalServerInfoFromHealth(params: {
+    kind: PersonalServerKind;
+    status: PersonalServerStatus;
+    health: unknown;
+    localUrl?: string | null;
+    publicUrl?: string | null;
+}): PersonalServerInfo;
+export declare function createOwnerSignedPersonalServerRequest(params: {
+    origin: string;
+    path: string;
+    method: string;
+    body?: Uint8Array;
+    auth: PersonalServerOwnerAuth;
+    headers?: Record<string, string>;
+}): Promise<Request>;
+export declare function submitPersonalServerRegistration(params: {
+    gateway: Pick<GatewayClient, "getServer" | "registerServer">;
+    request: PersonalServerRegistrationRequest;
+    signature: `0x${string}`;
+}): Promise<RegisterServerResult>;
+export declare function requestPath(input: string | URL | Request): string;
+export declare function dataListPath(options?: PersonalServerListDataOptions): string;
+export declare function accessLogsListPath(options?: PersonalServerListAccessLogsOptions): string;
+export declare function dataVersionsPath(scope: string, options?: PersonalServerListVersionsOptions): string;
+export declare function dataReadPath(scope: string, options?: PersonalServerReadDataOptions): string;
+export declare function grantRevokePath(grantId: string): string;
+export declare function parsePersonalServerJsonResponse<T>(response: Response, action: string): Promise<T>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,243 @@
+import { buildWeb3SignedHeader, } from "@opendatalabs/vana-sdk/browser";
+import { buildPersonalServerRegistrationTypedData, } from "@opendatalabs/vana-sdk/protocol/personal-server-registration";
+export class PersonalServerClientError extends Error {
+    status;
+    errorCode;
+    details;
+    body;
+    constructor(params) {
+        super(params.message);
+        this.name = "PersonalServerClientError";
+        this.status = params.status;
+        this.errorCode = params.errorCode;
+        this.details = params.details;
+        this.body = params.body;
+    }
+}
+export function createPersonalServerRegistrationRequest(params) {
+    const candidate = {
+        ownerAddress: params.ownerAddress,
+        serverAddress: params.serverAddress,
+        publicKey: params.publicKey,
+        serverUrl: params.serverUrl,
+    };
+    return {
+        gatewayConfig: params.gatewayConfig,
+        candidate,
+        typedData: buildPersonalServerRegistrationTypedData({
+            ownerAddress: params.ownerAddress,
+            serverAddress: params.serverAddress,
+            serverPublicKey: params.publicKey,
+            serverUrl: params.serverUrl,
+            config: params.gatewayConfig,
+        }),
+    };
+}
+export function createPersonalServerInfoFromHealth(params) {
+    const health = toHealthBody(params.health);
+    const publicUrl = params.publicUrl === undefined
+        ? (health.apiOrigin ?? null)
+        : params.publicUrl;
+    const apiOrigin = publicUrl ?? health.apiOrigin ?? params.localUrl ?? null;
+    const gatewayConfig = stripGatewayUrl(health.gatewayConfig);
+    const candidate = health.registration
+        ? {
+            ownerAddress: health.registration.ownerAddress,
+            serverAddress: health.registration.serverAddress,
+            publicKey: health.registration.publicKey,
+            serverUrl: publicUrl ?? health.registration.serverUrl,
+        }
+        : null;
+    return {
+        kind: params.kind,
+        status: health.status === "unavailable" && params.status === "ready"
+            ? "unavailable"
+            : params.status,
+        ownerAddress: health.owner ?? health.registration?.ownerAddress ?? null,
+        server: health.identity
+            ? {
+                address: health.identity.address,
+                publicKey: health.identity.publicKey,
+                serverId: health.identity.serverId,
+            }
+            : null,
+        urls: {
+            local: params.localUrl ?? null,
+            public: publicUrl,
+            apiOrigin,
+            registration: publicUrl ?? health.registration?.serverUrl ?? null,
+        },
+        registration: {
+            registered: Boolean(health.registration?.registered),
+            candidate,
+        },
+        gatewayUrl: health.gatewayUrl ?? health.gatewayConfig?.url ?? null,
+        gatewayConfig,
+        checkedAt: health.checkedAt,
+        details: health,
+    };
+}
+export async function createOwnerSignedPersonalServerRequest(params) {
+    const headers = new Headers(params.headers);
+    if ("bearerToken" in params.auth) {
+        headers.set("Authorization", `Bearer ${params.auth.bearerToken}`);
+    }
+    else {
+        headers.set("Authorization", await buildWeb3SignedHeader({
+            signMessage: params.auth.signMessage,
+            aud: params.origin,
+            method: params.method,
+            uri: new URL(params.path, params.origin).pathname,
+            body: params.body,
+        }));
+    }
+    return new Request(`${params.origin}${params.path}`, {
+        method: params.method,
+        headers,
+        body: params.body,
+    });
+}
+export async function submitPersonalServerRegistration(params) {
+    const existing = await params.gateway.getServer(params.request.candidate.serverAddress);
+    if (existing?.id && !serverInfoRevoked(existing)) {
+        assertRegistrationMatches(existing, params.request.candidate);
+        return { alreadyRegistered: true, serverId: existing.id };
+    }
+    return params.gateway.registerServer({
+        ...params.request.candidate,
+        signature: params.signature,
+    });
+}
+export function requestPath(input) {
+    const url = input instanceof Request
+        ? new URL(input.url)
+        : input instanceof URL
+            ? input
+            : new URL(input, "https://personal-server.local");
+    return `${url.pathname}${url.search}`;
+}
+export function dataListPath(options = {}) {
+    const params = new URLSearchParams();
+    if (options.scopePrefix)
+        params.set("scopePrefix", options.scopePrefix);
+    if (options.limit !== undefined)
+        params.set("limit", String(options.limit));
+    if (options.offset !== undefined)
+        params.set("offset", String(options.offset));
+    const query = params.toString();
+    return query ? `/v1/data?${query}` : "/v1/data";
+}
+export function accessLogsListPath(options = {}) {
+    const params = new URLSearchParams();
+    if (options.limit !== undefined)
+        params.set("limit", String(options.limit));
+    if (options.offset !== undefined)
+        params.set("offset", String(options.offset));
+    const query = params.toString();
+    return query ? `/v1/access-logs?${query}` : "/v1/access-logs";
+}
+export function dataVersionsPath(scope, options = {}) {
+    const params = new URLSearchParams();
+    if (options.limit !== undefined)
+        params.set("limit", String(options.limit));
+    if (options.offset !== undefined)
+        params.set("offset", String(options.offset));
+    const query = params.toString();
+    return `/v1/data/${encodeURIComponent(scope)}/versions${query ? `?${query}` : ""}`;
+}
+export function dataReadPath(scope, options = {}) {
+    const params = new URLSearchParams();
+    if (options.grantId)
+        params.set("grantId", options.grantId);
+    if (options.fileId)
+        params.set("fileId", options.fileId);
+    if (options.at)
+        params.set("at", options.at);
+    const query = params.toString();
+    return `/v1/data/${encodeURIComponent(scope)}${query ? `?${query}` : ""}`;
+}
+export function grantRevokePath(grantId) {
+    return `/v1/grants/${encodeURIComponent(grantId)}`;
+}
+export async function parsePersonalServerJsonResponse(response, action) {
+    const body = await readJsonBody(response);
+    if (!response.ok) {
+        const structured = toClientErrorBody(body);
+        throw new PersonalServerClientError({
+            status: response.status,
+            errorCode: structured?.error?.errorCode,
+            details: structured?.error?.details,
+            body,
+            message: structured?.error?.message ??
+                `Personal Server ${action} failed: ${response.status}`,
+        });
+    }
+    return body;
+}
+async function readJsonBody(response) {
+    const text = await response.text();
+    if (!text)
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function toClientErrorBody(value) {
+    if (!value || typeof value !== "object")
+        return null;
+    const record = value;
+    // Nested protocol shape: `{ error: { errorCode, message, details, code } }`.
+    if (record.error && typeof record.error === "object") {
+        return record;
+    }
+    // Flat contract shape: `{ error: "INVALID_BODY", message }`. The data/scope
+    // contract layer (contractError) emits `error` as a bare code string with a
+    // top-level `message` — normalize it into the nested shape so the real
+    // errorCode + message reach the consumer instead of collapsing into the
+    // opaque "Personal Server <action> failed: <status>" (see BUI-683).
+    const message = typeof record.message === "string" ? record.message : undefined;
+    if (typeof record.error === "string") {
+        return { ...record, error: { errorCode: record.error, message } };
+    }
+    // No structured `error`, but a top-level `message` is still worth surfacing.
+    if (message !== undefined) {
+        return { ...record, error: { message } };
+    }
+    return record;
+}
+function assertRegistrationMatches(existing, candidate) {
+    if (existing.serverUrl === candidate.serverUrl)
+        return;
+    throw new PersonalServerClientError({
+        status: 409,
+        errorCode: "SERVER_URL_MISMATCH",
+        message: `Server ${existing.id} is already registered with URL "${existing.serverUrl}". Cannot change to "${candidate.serverUrl}".`,
+        details: {
+            serverId: existing.id,
+            existingUrl: existing.serverUrl,
+            candidateUrl: candidate.serverUrl,
+        },
+    });
+}
+function serverInfoRevoked(existing) {
+    const revokedAt = existing
+        .revokedAt;
+    return revokedAt !== undefined && revokedAt !== null;
+}
+function toHealthBody(value) {
+    return value && typeof value === "object"
+        ? value
+        : {};
+}
+function stripGatewayUrl(config) {
+    if (!config)
+        return null;
+    return {
+        chainId: config.chainId,
+        contracts: config.contracts,
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config/defaults.d.ts

@@ -0,0 +1,12 @@
+export declare const DEFAULT_ROOT_PATH = "~/personal-server";
+export declare const DEFAULT_DATA_DIR = "~/personal-server/data";
+export declare const DEFAULT_CONFIG_PATH = "~/personal-server/config.json";
+/**
+ * @deprecated Use DEFAULT_ROOT_PATH instead.
+ */
+export declare const DEFAULT_VANA_DIR = "~/personal-server";
+/**
+ * @deprecated Use DEFAULT_ROOT_PATH instead.
+ */
+export declare const DEFAULT_SERVER_DIR = "~/personal-server";
+//# sourceMappingURL=defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AACrD,eAAO,MAAM,gBAAgB,2BAA8B,CAAC;AAC5D,eAAO,MAAM,mBAAmB,kCAAqC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,gBAAgB,sBAAoB,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,kBAAkB,sBAAoB,CAAC"}

package/dist/config/defaults.js

@@ -0,0 +1,12 @@
+export const DEFAULT_ROOT_PATH = "~/personal-server";
+export const DEFAULT_DATA_DIR = `${DEFAULT_ROOT_PATH}/data`;
+export const DEFAULT_CONFIG_PATH = `${DEFAULT_ROOT_PATH}/config.json`;
+/**
+ * @deprecated Use DEFAULT_ROOT_PATH instead.
+ */
+export const DEFAULT_VANA_DIR = DEFAULT_ROOT_PATH;
+/**
+ * @deprecated Use DEFAULT_ROOT_PATH instead.
+ */
+export const DEFAULT_SERVER_DIR = DEFAULT_ROOT_PATH;
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AACrD,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,iBAAiB,OAAO,CAAC;AAC5D,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,iBAAiB,cAAc,CAAC;AAEtE;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,3 @@
+export { DEFAULT_ROOT_PATH, DEFAULT_VANA_DIR, DEFAULT_SERVER_DIR, DEFAULT_DATA_DIR, DEFAULT_CONFIG_PATH, } from "./defaults.js";
+export { expandHomePath, resolveRootPath } from "./paths.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,3 @@
+export { DEFAULT_ROOT_PATH, DEFAULT_VANA_DIR, DEFAULT_SERVER_DIR, DEFAULT_DATA_DIR, DEFAULT_CONFIG_PATH, } from "./defaults.js";
+export { expandHomePath, resolveRootPath } from "./paths.js";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/config/paths.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Expands a leading "~" to the current user's home directory.
+ */
+export declare function expandHomePath(input: string): string;
+/**
+ * Resolves the configured root path (or default) to an absolute path.
+ */
+export declare function resolveRootPath(input?: string): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/config/paths.js

@@ -0,0 +1,14 @@
+import { DEFAULT_ROOT_PATH } from "./defaults.js";
+/**
+ * Expands a leading "~" to the current user's home directory.
+ */
+export function expandHomePath(input) {
+    return input;
+}
+/**
+ * Resolves the configured root path (or default) to an absolute path.
+ */
+export function resolveRootPath(input) {
+    return expandHomePath(input ?? DEFAULT_ROOT_PATH);
+}
+//# sourceMappingURL=paths.js.map

package/dist/config/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,cAAc,CAAC,KAAK,IAAI,iBAAiB,CAAC,CAAC;AACpD,CAAC"}

package/dist/contracts/access-logs.d.ts

@@ -0,0 +1,8 @@
+import type { AccessLogReader } from "../logging/access-reader.js";
+import { type ContractResult } from "./http.js";
+export declare function listAccessLogsContract(input: {
+    accessLogReader: AccessLogReader;
+    limit?: string | null;
+    offset?: string | null;
+}): Promise<ContractResult>;
+//# sourceMappingURL=access-logs.d.ts.map

package/dist/contracts/access-logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-logs.d.ts","sourceRoot":"","sources":["../../src/contracts/access-logs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAEnB,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAClD,eAAe,EAAE,eAAe,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,GAAG,OAAO,CAAC,cAAc,CAAC,CAI1B"}

package/dist/contracts/access-logs.js

@@ -0,0 +1,7 @@
+import { contractOk, normalizeIntegerParam, } from "./http.js";
+export async function listAccessLogsContract(input) {
+    const limit = normalizeIntegerParam(input.limit, 50);
+    const offset = normalizeIntegerParam(input.offset, 0);
+    return contractOk(await input.accessLogReader.read({ limit, offset }));
+}
+//# sourceMappingURL=access-logs.js.map

package/dist/contracts/access-logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-logs.js","sourceRoot":"","sources":["../../src/contracts/access-logs.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EACV,qBAAqB,GAEtB,MAAM,WAAW,CAAC;AAEnB,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,KAI5C;IACC,MAAM,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACtD,OAAO,UAAU,CAAC,MAAM,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;AACzE,CAAC"}