@valentinkolb/filegate 2.4.0 → 2.5.3

package/dist/paths.d.ts

@@ -0,0 +1,45 @@
+import { ClientCore } from "./core.js";
+import type { FingerprintMode, Node, NodeListResponse } from "./types.js";
+export interface GetPathOptions {
+    pageSize?: number;
+    cursor?: string;
+    computeRecursiveSizes?: boolean;
+    fingerprint?: FingerprintMode;
+}
+/**
+ * Conflict-handling strategy for file writes. The default is `"error"`:
+ * a 409 is returned when a file at the target path already exists.
+ *
+ * - `"error"` (default) — fail with 409 if the target exists.
+ * - `"overwrite"` — replace the existing file in place; node id preserved.
+ * - `"rename"` — pick a unique sibling name (foo.jpg → foo-01.jpg) and
+ *   create a new file. The returned `node.name`/`node.path` reflect the
+ *   actually-used name.
+ */
+export type FileConflictMode = "error" | "overwrite" | "rename";
+export interface PutPathOptions {
+    contentType?: string;
+    onConflict?: FileConflictMode;
+}
+export interface PathPutResponse {
+    node: Node;
+    nodeId: string;
+    createdId: string;
+    statusCode: number;
+}
+export declare class PathsClient {
+    private readonly core;
+    constructor(core: ClientCore);
+    /**
+     * Get a node by virtual path, or list roots when called without a path.
+     *
+     * - `get()` or `get("")` → lists root mounts (GET /v1/paths/)
+     * - `get("data/files")` → metadata for that path (GET /v1/paths/data/files)
+     */
+    get(virtualPath?: string, opts?: GetPathOptions): Promise<Node | NodeListResponse>;
+    /** One-shot upload to a virtual path. */
+    put(virtualPath: string, data: BodyInit, opts?: PutPathOptions): Promise<PathPutResponse>;
+    /** One-shot upload returning the raw Response (for relay/proxy). */
+    putRaw(virtualPath: string, data: BodyInit, opts?: PutPathOptions): Promise<Response>;
+}
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAmBD,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;OAKG;IACG,GAAG,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,GAAG,gBAAgB,CAAC;IASxF,yCAAyC;IACnC,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAgB/F,oEAAoE;IAC9D,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;CAM5F"}

package/dist/paths.js

@@ -0,0 +1,71 @@
+import { ensureSuccess } from "./errors.js";
+function getQuery(opts) {
+    const q = {};
+    if (opts?.pageSize)
+        q["pageSize"] = String(opts.pageSize);
+    if (opts?.cursor)
+        q["cursor"] = opts.cursor;
+    if (opts?.computeRecursiveSizes)
+        q["computeRecursiveSizes"] = "true";
+    if (opts?.fingerprint)
+        q["fingerprint"] = opts.fingerprint;
+    return q;
+}
+function encodeVirtualPath(path) {
+    return path
+        .split("/")
+        .filter((s) => s.length > 0)
+        .map(encodeURIComponent)
+        .join("/");
+}
+export class PathsClient {
+    core;
+    constructor(core) {
+        this.core = core;
+    }
+    /**
+     * Get a node by virtual path, or list roots when called without a path.
+     *
+     * - `get()` or `get("")` → lists root mounts (GET /v1/paths/)
+     * - `get("data/files")` → metadata for that path (GET /v1/paths/data/files)
+     */
+    async get(virtualPath, opts) {
+        const trimmed = virtualPath?.trim().replace(/^\/+|\/+$/g, "") ?? "";
+        if (trimmed === "") {
+            return this.core.doJSON("GET", "/v1/paths/", getQuery(opts));
+        }
+        const encoded = encodeVirtualPath(trimmed);
+        return this.core.doJSON("GET", `/v1/paths/${encoded}`, getQuery(opts));
+    }
+    /** One-shot upload to a virtual path. */
+    async put(virtualPath, data, opts) {
+        const encoded = encodeVirtualPath(virtualPath.trim());
+        if (!encoded)
+            throw new Error("path is required");
+        const contentType = opts?.contentType ?? "application/octet-stream";
+        const endpoint = `/v1/paths/${encoded}`;
+        const resp = await this.core.doRaw("PUT", endpoint, putQuery(opts), data, contentType);
+        await ensureSuccess(resp, "PUT", endpoint);
+        const node = (await resp.json());
+        return {
+            node,
+            nodeId: resp.headers.get("X-Node-Id") ?? "",
+            createdId: resp.headers.get("X-Created-Id") ?? "",
+            statusCode: resp.status,
+        };
+    }
+    /** One-shot upload returning the raw Response (for relay/proxy). */
+    async putRaw(virtualPath, data, opts) {
+        const encoded = encodeVirtualPath(virtualPath.trim());
+        if (!encoded)
+            throw new Error("path is required");
+        const contentType = opts?.contentType ?? "application/octet-stream";
+        return this.core.doRaw("PUT", `/v1/paths/${encoded}`, putQuery(opts), data, contentType);
+    }
+}
+function putQuery(opts) {
+    if (!opts?.onConflict)
+        return undefined;
+    return { onConflict: opts.onConflict };
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

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

package/dist/search.d.ts

@@ -0,0 +1,17 @@
+import { ClientCore } from "./core.js";
+import type { GlobSearchResponse } from "./types.js";
+export interface GlobOptions {
+    pattern: string;
+    paths?: string[];
+    limit?: number;
+    showHidden?: boolean;
+    files?: boolean;
+    directories?: boolean;
+}
+export declare class SearchClient {
+    private readonly core;
+    constructor(core: ClientCore);
+    /** Search for nodes matching a glob pattern. */
+    glob(opts: GlobOptions): Promise<GlobSearchResponse>;
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,gDAAgD;IAC1C,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAW3D"}

package/dist/search.js

@@ -0,0 +1,25 @@
+export class SearchClient {
+    core;
+    constructor(core) {
+        this.core = core;
+    }
+    /** Search for nodes matching a glob pattern. */
+    async glob(opts) {
+        const pattern = opts.pattern.trim();
+        if (!pattern)
+            throw new Error("pattern is required");
+        const q = { pattern };
+        if (opts.limit)
+            q["limit"] = String(opts.limit);
+        if (opts.paths?.length)
+            q["paths"] = opts.paths.join(",");
+        if (opts.showHidden)
+            q["showHidden"] = "true";
+        if (opts.files !== undefined)
+            q["files"] = String(opts.files);
+        if (opts.directories !== undefined)
+            q["directories"] = String(opts.directories);
+        return this.core.doJSON("GET", "/v1/search/glob", q);
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,gDAAgD;IAChD,KAAK,CAAC,IAAI,CAAC,IAAiB;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACrD,MAAM,CAAC,GAA2B,EAAE,OAAO,EAAE,CAAC;QAC9C,IAAI,IAAI,CAAC,KAAK;YAAE,CAAC,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM;YAAE,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1D,IAAI,IAAI,CAAC,UAAU;YAAE,CAAC,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;QAC9C,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,CAAC,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9D,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAAE,CAAC,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAqB,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC;IAC3E,CAAC;CACF"}

package/dist/stats.d.ts

@@ -0,0 +1,9 @@
+import { ClientCore } from "./core.js";
+import type { StatsResponse } from "./types.js";
+export declare class StatsClient {
+    private readonly core;
+    constructor(core: ClientCore);
+    /** Get runtime statistics. */
+    get(): Promise<StatsResponse>;
+}
+//# sourceMappingURL=stats.d.ts.map

package/dist/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,8BAA8B;IACxB,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC;CAGpC"}

package/dist/stats.js

@@ -0,0 +1,11 @@
+export class StatsClient {
+    core;
+    constructor(core) {
+        this.core = core;
+    }
+    /** Get runtime statistics. */
+    async get() {
+        return this.core.doJSON("GET", "/v1/stats");
+    }
+}
+//# sourceMappingURL=stats.js.map

package/dist/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,8BAA8B;IAC9B,KAAK,CAAC,GAAG;QACP,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAgB,KAAK,EAAE,WAAW,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/transfers.d.ts

@@ -0,0 +1,9 @@
+import { ClientCore } from "./core.js";
+import type { TransferRequest, TransferResponse } from "./types.js";
+export declare class TransfersClient {
+    private readonly core;
+    constructor(core: ClientCore);
+    /** Execute a move or copy operation. */
+    create(req: TransferRequest, recursiveOwnership?: boolean): Promise<TransferResponse>;
+}
+//# sourceMappingURL=transfers.d.ts.map

package/dist/transfers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfers.d.ts","sourceRoot":"","sources":["../src/transfers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEpE,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,wCAAwC;IAClC,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,kBAAkB,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAW5F"}

package/dist/transfers.js

@@ -0,0 +1,14 @@
+export class TransfersClient {
+    core;
+    constructor(core) {
+        this.core = core;
+    }
+    /** Execute a move or copy operation. */
+    async create(req, recursiveOwnership) {
+        const q = {};
+        if (recursiveOwnership !== undefined)
+            q["recursiveOwnership"] = String(recursiveOwnership);
+        return this.core.doJSON("POST", "/v1/transfers", q, JSON.stringify(req), "application/json");
+    }
+}
+//# sourceMappingURL=transfers.js.map

package/dist/transfers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfers.js","sourceRoot":"","sources":["../src/transfers.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,wCAAwC;IACxC,KAAK,CAAC,MAAM,CAAC,GAAoB,EAAE,kBAA4B;QAC7D,MAAM,CAAC,GAA2B,EAAE,CAAC;QACrC,IAAI,kBAAkB,KAAK,SAAS;YAAE,CAAC,CAAC,oBAAoB,CAAC,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAC3F,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CACrB,MAAM,EACN,eAAe,EACf,CAAC,EACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EACnB,kBAAkB,CACnB,CAAC;IACJ,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,285 @@
+/** Ownership input for create/update operations. */
+export interface Ownership {
+    uid?: number;
+    gid?: number;
+    mode?: string;
+    dirMode?: string;
+}
+/** Ownership as returned by the server. */
+export interface OwnershipView {
+    uid: number;
+    gid: number;
+    mode: string;
+}
+/** A file or directory node.
+ *
+ * `nextCursor` is an opaque pagination token: pass it back verbatim as
+ * the `cursor` option to fetch the next page of children. Do not
+ * construct or interpret it. */
+export interface Node {
+    id: string;
+    type: "file" | "directory";
+    name: string;
+    path: string;
+    size: number;
+    mtime: number;
+    ownership: OwnershipView;
+    mimeType?: string;
+    etag?: string;
+    sha256?: string;
+    exif: Record<string, string>;
+    children?: Node[];
+    pageSize?: number;
+    nextCursor?: string;
+}
+/** Response for root listing (GET /v1/paths/). */
+export interface NodeListResponse {
+    items: Node[];
+    total: number;
+}
+/** OK acknowledgement. */
+export interface OKResponse {
+    ok: boolean;
+}
+/** Error response body. On a 409 Conflict, `existingId` and `existingPath`
+ * are populated so the client can render a "what should we do?" prompt
+ * without an extra resolve call. Both undefined otherwise. */
+export interface ErrorResponse {
+    error: string;
+    existingId?: string;
+    existingPath?: string;
+}
+/** Conflict mode accepted by file-write endpoints. `"skip"` is mkdir-only and
+ * not allowed here. Upload sessions narrow this to `"error" | "overwrite"`. */
+export type FileConflictMode = "error" | "overwrite" | "rename";
+export type UploadSessionConflictMode = Exclude<FileConflictMode, "rename">;
+export type FingerprintMode = "none" | "cached" | "ensure";
+/** Conflict mode accepted by mkdir. `"overwrite"` is forbidden — replacing
+ * a directory subtree is a Transfer operation, not a mkdir one. */
+export type MkdirConflictMode = "error" | "skip" | "rename";
+export interface StatsIndex {
+    totalEntities: number;
+    totalFiles: number;
+    totalDirs: number;
+    dbSizeBytes: number;
+}
+export interface StatsCache {
+    pathEntries: number;
+    pathCapacity: number;
+    pathUtilRatio: number;
+}
+export interface StatsMount {
+    id: string;
+    name: string;
+    path: string;
+    files: number;
+    dirs: number;
+}
+export interface StatsDisk {
+    diskName: string;
+    fsType: string;
+    used: number;
+    size: number;
+    roots: string[];
+}
+export interface StatsSystem {
+    goroutines: number;
+    heapAllocBytes: number;
+    heapSysBytes: number;
+    heapObjects: number;
+    numGC: number;
+    lastGCPauseNs: number;
+    openFDs: number;
+    maxFDs: number;
+}
+export interface StatsResponse {
+    generatedAt: number;
+    index: StatsIndex;
+    cache: StatsCache;
+    mounts: StatsMount[];
+    disks: StatsDisk[];
+    system: StatsSystem;
+}
+export interface ActivityActor {
+    kind: "system" | "bearer_token" | "s3_key" | "signed_url" | string;
+    id: string;
+    label?: string;
+    delegatedActor?: string;
+}
+export interface ActivityTarget {
+    kind: string;
+    id?: string;
+    path?: string;
+}
+export interface ActivityEvent {
+    id: string;
+    at: number;
+    actor: ActivityActor;
+    operation: string;
+    outcome: "succeeded" | "failed" | "skipped" | string;
+    target?: ActivityTarget;
+    durationMs?: number;
+    requestId?: string;
+    error?: string;
+    meta?: Record<string, string | number | boolean>;
+}
+export interface ActivityListResponse {
+    items: ActivityEvent[];
+    total: number;
+    offset: number;
+    limit: number;
+    retained: number;
+    capacity: number;
+    operations: string[];
+}
+export interface CapabilitiesResponse {
+    uploads: UploadCapabilities;
+}
+export interface UploadCapabilities {
+    maxChunkBytes: number;
+    maxUploadBytes: number;
+    maxSessionUploadBytes: number;
+    maxConcurrentSegmentWrites: number;
+}
+export interface MkdirRequest {
+    path: string;
+    recursive?: boolean;
+    ownership?: Ownership;
+    /** Default `"error"`. `"skip"` returns the existing directory unchanged
+     * if one with the same name exists. `"rename"` picks a unique sibling
+     * name and creates a fresh directory there. `"overwrite"` is rejected. */
+    onConflict?: MkdirConflictMode;
+}
+export interface UpdateNodeRequest {
+    name?: string;
+    ownership?: Ownership;
+}
+export interface TransferRequest {
+    op: "move" | "copy";
+    sourceId: string;
+    targetParentId: string;
+    targetName: string;
+    /** Default `"error"`. Same vocabulary as the other file-write endpoints —
+     * see `FileConflictMode`. */
+    onConflict?: FileConflictMode;
+    ownership?: Ownership;
+}
+export interface TransferResponse {
+    node: Node;
+    op: string;
+}
+export interface GlobSearchError {
+    path: string;
+    cause: string;
+}
+export interface GlobSearchPath {
+    path: string;
+    returned: number;
+    hasMore: boolean;
+}
+export interface GlobSearchMeta {
+    pattern: string;
+    limit: number;
+    resultCount: number;
+    errorCount: number;
+}
+export interface GlobSearchResponse {
+    results: Node[];
+    errors: GlobSearchError[];
+    meta: GlobSearchMeta;
+    paths: GlobSearchPath[];
+}
+export interface DirectUploadURLRequest {
+    path: string;
+    expiresInSeconds?: number;
+    contentType?: string;
+    onConflict?: FileConflictMode;
+    maxBytes?: number;
+}
+export interface DirectUploadURLResponse {
+    uploadUrl: string;
+    method: "PUT";
+    path: string;
+    expiresAt: number;
+    maxBytes: number;
+}
+export interface DirectDownloadURLRequest {
+    nodeId?: string;
+    path?: string;
+    expiresInSeconds?: number;
+    inline?: boolean;
+}
+export interface DirectDownloadURLResponse {
+    downloadUrl: string;
+    method: "GET";
+    expiresAt: number;
+    node: Node;
+}
+export interface UploadSessionDirectRequest {
+    expiresInSeconds?: number;
+    allow?: Array<"putSegment" | "status" | "commit" | "abort">;
+}
+export interface UploadSessionCreateRequest {
+    path: string;
+    size: number;
+    checksum: string;
+    segmentSize?: number;
+    contentType?: string;
+    ownership?: Ownership;
+    onConflict?: UploadSessionConflictMode;
+    direct?: UploadSessionDirectRequest;
+}
+export interface UploadSessionBatchCreateRequest {
+    uploads: UploadSessionCreateRequest[];
+    segmentSize?: number;
+    direct?: UploadSessionDirectRequest;
+}
+export interface UploadSessionSegment {
+    index: number;
+    offset: number;
+    size: number;
+}
+export interface UploadSessionDirect {
+    baseUrl: string;
+    token: string;
+    expiresAt: number;
+    allow: Array<"putSegment" | "status" | "commit" | "abort">;
+}
+export interface UploadSessionResponse {
+    id: string;
+    path: string;
+    size: number;
+    checksum: string;
+    segmentSize: number;
+    totalSegments: number;
+    segments: UploadSessionSegment[];
+    uploadedSegments: number[];
+    phase: "in_progress" | "committing" | "committed" | "aborted";
+    direct?: UploadSessionDirect;
+}
+export interface UploadSessionBatchCreateResponse {
+    sessions: UploadSessionResponse[];
+}
+export interface UploadSegmentResponse {
+    sessionId: string;
+    index: number;
+    uploadedSegments: number[];
+}
+export interface UploadSessionCommitResponse {
+    node: Node;
+    checksum: string;
+}
+export interface IndexResolveRequest {
+    path?: string;
+    paths?: string[];
+    id?: string;
+    ids?: string[];
+}
+export interface IndexResolveSingleResponse {
+    item: Node | null;
+}
+export interface IndexResolveManyResponse {
+    items: (Node | null)[];
+    total: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}