@functional-systems/lambdadb 0.4.3 → 0.5.0-rc.2

package/dist/commonjs/versioning.d.ts

@@ -0,0 +1,63 @@
+import type { LambdaDBCore } from "./core.js";
+import type { RequestOptions } from "./lib/sdks.js";
+import * as errors from "./models/errors/index.js";
+import type { LambdaDBError } from "./models/errors/lambdadberror.js";
+import type { ResponseValidationError } from "./models/errors/responsevalidationerror.js";
+import type { SDKValidationError } from "./models/errors/sdkvalidationerror.js";
+import { type AliasRef, type BranchRef, type BranchSource, type TagRef, type TagSource } from "./models/versioning.js";
+import type { ConnectionError, InvalidRequestError, RequestAbortedError, RequestTimeoutError, UnexpectedClientError } from "./models/errors/httpclienterrors.js";
+import { type AliasResponse, type CreateAliasInput, type CreateBranchInput, type CreateBranchResponse, type CreateTagInput, type CreateTagResponse, type ListAliasesResponse, type ListBranchesResponse, type ListTagsResponse, type MessageResponse, type RetargetAliasInput } from "./types/public.js";
+import type { Result } from "./types/fp.js";
+/** Exact public contract revision implemented by this SDK. */
+export declare const DATA_VERSIONING_CONTRACT_REVISION: "b171ff0a408bbeb024535941b83b861d205a829f";
+/** Creates a validated Branch read ref. */
+export declare function branchRef(name: string): BranchRef;
+/** Creates a validated Tag read ref. */
+export declare function tagRef(name: string): TagRef;
+/** Creates a validated Alias read ref. */
+export declare function aliasRef(name: string): AliasRef;
+/** Creates a validated Branch source, optionally at a Unix-millisecond cutoff. */
+export declare function branchSource(name: string, asOf?: Date | number): BranchSource;
+/** Creates a validated Tag source. `asOf` is intentionally unavailable. */
+export declare function tagSource(name: string): TagSource;
+/** Creates a validated Branch Alias target. */
+export declare function branchTarget(name: string): BranchRef;
+/** Creates a validated Tag Alias target. */
+export declare function tagTarget(name: string): TagRef;
+export type VersioningError = errors.BadRequestError | errors.UnauthenticatedError | errors.ResourceNotFoundError | errors.ResourceAlreadyExistsError | errors.CatalogConflictError | errors.PayloadTooLargeError | errors.TooManyRequestsError | errors.InternalServerError | errors.BadGatewayError | errors.ServiceUnavailableError | errors.GatewayTimeoutError | LambdaDBError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError;
+export declare class CollectionBranches {
+    private readonly client;
+    private readonly collectionName;
+    constructor(client: LambdaDBCore, collectionName: string);
+    create(input: CreateBranchInput, options?: RequestOptions): Promise<CreateBranchResponse>;
+    createSafe(input: CreateBranchInput, options?: RequestOptions): Promise<Result<CreateBranchResponse, VersioningError>>;
+    list(options?: RequestOptions): Promise<ListBranchesResponse>;
+    listSafe(options?: RequestOptions): Promise<Result<ListBranchesResponse, VersioningError>>;
+    delete(branchName: string, options?: RequestOptions): Promise<MessageResponse>;
+    deleteSafe(branchName: string, options?: RequestOptions): Promise<Result<MessageResponse, VersioningError>>;
+}
+export declare class CollectionTags {
+    private readonly client;
+    private readonly collectionName;
+    constructor(client: LambdaDBCore, collectionName: string);
+    create(input: CreateTagInput, options?: RequestOptions): Promise<CreateTagResponse>;
+    createSafe(input: CreateTagInput, options?: RequestOptions): Promise<Result<CreateTagResponse, VersioningError>>;
+    list(options?: RequestOptions): Promise<ListTagsResponse>;
+    listSafe(options?: RequestOptions): Promise<Result<ListTagsResponse, VersioningError>>;
+    delete(tagName: string, options?: RequestOptions): Promise<MessageResponse>;
+    deleteSafe(tagName: string, options?: RequestOptions): Promise<Result<MessageResponse, VersioningError>>;
+}
+export declare class CollectionAliases {
+    private readonly client;
+    private readonly collectionName;
+    constructor(client: LambdaDBCore, collectionName: string);
+    create(input: CreateAliasInput, options?: RequestOptions): Promise<AliasResponse>;
+    createSafe(input: CreateAliasInput, options?: RequestOptions): Promise<Result<AliasResponse, VersioningError>>;
+    list(options?: RequestOptions): Promise<ListAliasesResponse>;
+    listSafe(options?: RequestOptions): Promise<Result<ListAliasesResponse, VersioningError>>;
+    retarget(aliasName: string, input: RetargetAliasInput, options?: RequestOptions): Promise<AliasResponse>;
+    retargetSafe(aliasName: string, input: RetargetAliasInput, options?: RequestOptions): Promise<Result<AliasResponse, VersioningError>>;
+    delete(aliasName: string, options?: RequestOptions): Promise<MessageResponse>;
+    deleteSafe(aliasName: string, options?: RequestOptions): Promise<Result<MessageResponse, VersioningError>>;
+}
+//# sourceMappingURL=versioning.d.ts.map

package/dist/commonjs/versioning.d.ts.map

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

package/dist/commonjs/versioning.js

@@ -0,0 +1,402 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollectionAliases = exports.CollectionTags = exports.CollectionBranches = exports.DATA_VERSIONING_CONTRACT_REVISION = void 0;
+exports.branchRef = branchRef;
+exports.tagRef = tagRef;
+exports.aliasRef = aliasRef;
+exports.branchSource = branchSource;
+exports.tagSource = tagSource;
+exports.branchTarget = branchTarget;
+exports.tagTarget = tagTarget;
+const z = __importStar(require("zod/v3"));
+const M = __importStar(require("./lib/matchers.js"));
+const primitives_js_1 = require("./lib/primitives.js");
+const schemas_js_1 = require("./lib/schemas.js");
+const security_js_1 = require("./lib/security.js");
+const errors = __importStar(require("./models/errors/index.js"));
+const versioning_js_1 = require("./models/versioning.js");
+const public_js_1 = require("./types/public.js");
+/** Exact public contract revision implemented by this SDK. */
+exports.DATA_VERSIONING_CONTRACT_REVISION = "b171ff0a408bbeb024535941b83b861d205a829f";
+const refNamePattern = /^[a-zA-Z0-9_-]{3,52}$/;
+const refNameSchema = z.string().regex(refNamePattern);
+function checkedRefName(name) {
+    if (!refNamePattern.test(name)) {
+        throw new TypeError("Ref names must contain 3 to 52 letters, numbers, underscores, or hyphens");
+    }
+    return name;
+}
+/** Creates a validated Branch read ref. */
+function branchRef(name) {
+    return { kind: "branch", name: checkedRefName(name) };
+}
+/** Creates a validated Tag read ref. */
+function tagRef(name) {
+    return { kind: "tag", name: checkedRefName(name) };
+}
+/** Creates a validated Alias read ref. */
+function aliasRef(name) {
+    return { kind: "alias", name: checkedRefName(name) };
+}
+/** Creates a validated Branch source, optionally at a Unix-millisecond cutoff. */
+function branchSource(name, asOf) {
+    const source = { kind: "branch", name: checkedRefName(name) };
+    if (asOf !== undefined) {
+        const milliseconds = asOf instanceof Date ? asOf.getTime() : asOf;
+        if (!Number.isInteger(milliseconds)) {
+            throw new TypeError("Branch source asOf must be a valid Date or integer Unix milliseconds");
+        }
+        source.asOf = milliseconds;
+    }
+    return source;
+}
+/** Creates a validated Tag source. `asOf` is intentionally unavailable. */
+function tagSource(name) {
+    return tagRef(name);
+}
+/** Creates a validated Branch Alias target. */
+function branchTarget(name) {
+    return branchRef(name);
+}
+/** Creates a validated Tag Alias target. */
+function tagTarget(name) {
+    return tagRef(name);
+}
+async function requestVersioning(client, request, options) {
+    let body = null;
+    if (request.bodySchema !== undefined) {
+        const parsed = (0, schemas_js_1.safeParse)(request.body, (value) => request.bodySchema?.parse(value), "Input validation failed");
+        if (!parsed.ok)
+            return parsed;
+        body = JSON.stringify(parsed.value);
+    }
+    const headers = new Headers((0, primitives_js_1.compactMap)({
+        Accept: "application/json",
+        "Content-Type": body == null ? undefined : "application/json",
+    }));
+    const secConfig = await (0, security_js_1.extractSecurity)(client._options.projectApiKey);
+    const securityInput = secConfig == null ? {} : { projectApiKey: secConfig };
+    const requestSecurity = (0, security_js_1.resolveGlobalSecurity)(securityInput);
+    const retryConfig = options?.retries
+        || client._options.retryConfig
+        || {
+            strategy: "backoff",
+            backoff: {
+                initialInterval: 500,
+                maxInterval: 60000,
+                exponent: 1.5,
+                maxElapsedTime: 3600000,
+            },
+            retryConnectionErrors: true,
+        };
+    const retryCodes = options?.retryCodes || ["429", "5XX"];
+    const context = {
+        options: client._options,
+        baseURL: options?.serverURL ?? client._baseURL ?? "",
+        operationID: `${request.method} ${request.path}`,
+        oAuth2Scopes: null,
+        resolvedSecurity: requestSecurity,
+        securitySource: client._options.projectApiKey,
+        retryConfig,
+        retryCodes,
+    };
+    const requestResult = client._createRequest(context, {
+        security: requestSecurity,
+        method: request.method,
+        baseURL: options?.serverURL,
+        path: request.path,
+        headers,
+        body,
+        userAgent: client._options.userAgent,
+        timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+    }, options);
+    if (!requestResult.ok)
+        return requestResult;
+    const httpRequest = requestResult.value;
+    const responseResult = await client._do(httpRequest, {
+        context,
+        errorCodes: ["400", "401", "404", "409", "429", "4XX", "500", "5XX"],
+        retryConfig,
+        retryCodes,
+    });
+    if (!responseResult.ok)
+        return responseResult;
+    const response = responseResult.value;
+    const conflictMatchers = request.conflict === "already-exists"
+        ? [M.jsonErr(409, errors.ResourceAlreadyExistsError$inboundSchema)]
+        : request.conflict === "catalog"
+            ? [M.jsonErr(409, errors.CatalogConflictError$inboundSchema)]
+            : [];
+    const [result] = await M.match(M.json(request.successStatus, request.responseSchema), M.jsonErr(400, errors.BadRequestError$inboundSchema), M.jsonErr(401, errors.UnauthenticatedError$inboundSchema), M.jsonErr(404, errors.ResourceNotFoundError$inboundSchema), ...conflictMatchers, M.jsonErr(429, errors.TooManyRequestsError$inboundSchema), M.jsonErr(500, errors.InternalServerError$inboundSchema), ...M.gatewayErrorMatchers(), M.fail("4XX"), M.fail("5XX"))(response, httpRequest, {
+        extraFields: { HttpMeta: { Response: response, Request: httpRequest } },
+    });
+    return result;
+}
+function pathFor(collectionName, suffix) {
+    return `/collections/${encodeURIComponent(collectionName)}${suffix}`;
+}
+const createBranchSchema = z.object({
+    branchName: z.string().regex(refNamePattern),
+    source: versioning_js_1.RefSource$schema.optional(),
+}).strict();
+const createBranchResponseSchema = z.object({ branch: versioning_js_1.RefDetails$inboundSchema });
+const listBranchesResponseSchema = z.object({ branches: z.array(versioning_js_1.RefDetails$inboundSchema) });
+const createTagSchema = z.object({
+    tagName: z.string().regex(refNamePattern),
+    source: versioning_js_1.RefSource$schema.optional(),
+}).strict();
+const createTagResponseSchema = z.object({ tag: versioning_js_1.RefDetails$inboundSchema });
+const listTagsResponseSchema = z.object({ tags: z.array(versioning_js_1.RefDetails$inboundSchema) });
+const createAliasSchema = z.object({
+    aliasName: z.string().regex(refNamePattern),
+    target: versioning_js_1.AliasTarget$schema,
+}).strict();
+const retargetAliasSchema = z.object({
+    target: versioning_js_1.AliasTarget$schema,
+}).strict();
+const aliasResponseSchema = z.object({ alias: versioning_js_1.AliasDetails$inboundSchema });
+const listAliasesResponseSchema = z.object({ aliases: z.array(versioning_js_1.AliasDetails$inboundSchema) });
+const messageResponseSchema = z.object({ message: z.string() });
+class CollectionBranches {
+    constructor(client, collectionName) {
+        this.client = client;
+        this.collectionName = collectionName;
+    }
+    async create(input, options) {
+        const result = await this.createSafe(input, options);
+        if (!result.ok)
+            throw result.error;
+        return result.value;
+    }
+    async createSafe(input, options) {
+        const result = await requestVersioning(this.client, {
+            body: input,
+            bodySchema: createBranchSchema,
+            method: "POST",
+            path: pathFor(this.collectionName, "/branches"),
+            responseSchema: createBranchResponseSchema,
+            successStatus: 201,
+            conflict: "already-exists",
+        }, options);
+        if (!result.ok)
+            return result;
+        return { ok: true, value: { branch: (0, public_js_1.refDetailsWithDate)(result.value.branch) } };
+    }
+    async list(options) {
+        const result = await this.listSafe(options);
+        if (!result.ok)
+            throw result.error;
+        return result.value;
+    }
+    async listSafe(options) {
+        const result = await requestVersioning(this.client, {
+            method: "GET",
+            path: pathFor(this.collectionName, "/branches"),
+            responseSchema: listBranchesResponseSchema,
+            successStatus: 200,
+        }, options);
+        if (!result.ok)
+            return result;
+        return { ok: true, value: { branches: result.value.branches.map(public_js_1.refDetailsWithDate) } };
+    }
+    async delete(branchName, options) {
+        const result = await this.deleteSafe(branchName, options);
+        if (!result.ok)
+            throw result.error;
+        return result.value;
+    }
+    async deleteSafe(branchName, options) {
+        const parsedName = (0, schemas_js_1.safeParse)(branchName, (value) => refNameSchema.parse(value), "Input validation failed");
+        if (!parsedName.ok)
+            return parsedName;
+        return requestVersioning(this.client, {
+            method: "DELETE",
+            path: pathFor(this.collectionName, `/branches/${encodeURIComponent(parsedName.value)}`),
+            responseSchema: messageResponseSchema,
+            successStatus: 200,
+            conflict: "catalog",
+        }, options);
+    }
+}
+exports.CollectionBranches = CollectionBranches;
+class CollectionTags {
+    constructor(client, collectionName) {
+        this.client = client;
+        this.collectionName = collectionName;
+    }
+    async create(input, options) {
+        const result = await this.createSafe(input, options);
+        if (!result.ok)
+            throw result.error;
+        return result.value;
+    }
+    async createSafe(input, options) {
+        const result = await requestVersioning(this.client, {
+            body: input,
+            bodySchema: createTagSchema,
+            method: "POST",
+            path: pathFor(this.collectionName, "/tags"),
+            responseSchema: createTagResponseSchema,
+            successStatus: 201,
+            conflict: "already-exists",
+        }, options);
+        if (!result.ok)
+            return result;
+        return { ok: true, value: { tag: (0, public_js_1.refDetailsWithDate)(result.value.tag) } };
+    }
+    async list(options) {
+        const result = await this.listSafe(options);
+        if (!result.ok)
+            throw result.error;
+        return result.value;
+    }
+    async listSafe(options) {
+        const result = await requestVersioning(this.client, {
+            method: "GET",
+            path: pathFor(this.collectionName, "/tags"),
+            responseSchema: listTagsResponseSchema,
+            successStatus: 200,
+        }, options);
+        if (!result.ok)
+            return result;
+        return { ok: true, value: { tags: result.value.tags.map(public_js_1.refDetailsWithDate) } };
+    }
+    async delete(tagName, options) {
+        const result = await this.deleteSafe(tagName, options);
+        if (!result.ok)
+            throw result.error;
+        return result.value;
+    }
+    async deleteSafe(tagName, options) {
+        const parsedName = (0, schemas_js_1.safeParse)(tagName, (value) => refNameSchema.parse(value), "Input validation failed");
+        if (!parsedName.ok)
+            return parsedName;
+        return requestVersioning(this.client, {
+            method: "DELETE",
+            path: pathFor(this.collectionName, `/tags/${encodeURIComponent(parsedName.value)}`),
+            responseSchema: messageResponseSchema,
+            successStatus: 200,
+            conflict: "catalog",
+        }, options);
+    }
+}
+exports.CollectionTags = CollectionTags;
+class CollectionAliases {
+    constructor(client, collectionName) {
+        this.client = client;
+        this.collectionName = collectionName;
+    }
+    async create(input, options) {
+        const result = await this.createSafe(input, options);
+        if (!result.ok)
+            throw result.error;
+        return result.value;
+    }
+    async createSafe(input, options) {
+        const result = await requestVersioning(this.client, {
+            body: input,
+            bodySchema: createAliasSchema,
+            method: "POST",
+            path: pathFor(this.collectionName, "/aliases"),
+            responseSchema: aliasResponseSchema,
+            successStatus: 201,
+            conflict: "already-exists",
+        }, options);
+        if (!result.ok)
+            return result;
+        return { ok: true, value: { alias: (0, public_js_1.aliasDetailsWithDate)(result.value.alias) } };
+    }
+    async list(options) {
+        const result = await this.listSafe(options);
+        if (!result.ok)
+            throw result.error;
+        return result.value;
+    }
+    async listSafe(options) {
+        const result = await requestVersioning(this.client, {
+            method: "GET",
+            path: pathFor(this.collectionName, "/aliases"),
+            responseSchema: listAliasesResponseSchema,
+            successStatus: 200,
+        }, options);
+        if (!result.ok)
+            return result;
+        return { ok: true, value: { aliases: result.value.aliases.map(public_js_1.aliasDetailsWithDate) } };
+    }
+    async retarget(aliasName, input, options) {
+        const result = await this.retargetSafe(aliasName, input, options);
+        if (!result.ok)
+            throw result.error;
+        return result.value;
+    }
+    async retargetSafe(aliasName, input, options) {
+        const parsedName = (0, schemas_js_1.safeParse)(aliasName, (value) => refNameSchema.parse(value), "Input validation failed");
+        if (!parsedName.ok)
+            return parsedName;
+        const result = await requestVersioning(this.client, {
+            body: input,
+            bodySchema: retargetAliasSchema,
+            method: "PATCH",
+            path: pathFor(this.collectionName, `/aliases/${encodeURIComponent(parsedName.value)}`),
+            responseSchema: aliasResponseSchema,
+            successStatus: 200,
+            conflict: "catalog",
+        }, options);
+        if (!result.ok)
+            return result;
+        return { ok: true, value: { alias: (0, public_js_1.aliasDetailsWithDate)(result.value.alias) } };
+    }
+    async delete(aliasName, options) {
+        const result = await this.deleteSafe(aliasName, options);
+        if (!result.ok)
+            throw result.error;
+        return result.value;
+    }
+    async deleteSafe(aliasName, options) {
+        const parsedName = (0, schemas_js_1.safeParse)(aliasName, (value) => refNameSchema.parse(value), "Input validation failed");
+        if (!parsedName.ok)
+            return parsedName;
+        return requestVersioning(this.client, {
+            method: "DELETE",
+            path: pathFor(this.collectionName, `/aliases/${encodeURIComponent(parsedName.value)}`),
+            responseSchema: messageResponseSchema,
+            successStatus: 200,
+            conflict: "catalog",
+        }, options);
+    }
+}
+exports.CollectionAliases = CollectionAliases;
+//# sourceMappingURL=versioning.js.map

package/dist/commonjs/versioning.js.map

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

package/dist/esm/client.d.ts

@@ -11,11 +11,13 @@
  */
 import { LambdaDBCore } from "./core.js";
 import type { SDKOptions } from "./lib/config.js";
+import { HTTPClient } from "./lib/http.js";
 import type { RequestOptions } from "./lib/sdks.js";
+import { CollectionAliases, CollectionBranches, CollectionTags } from "./versioning.js";
 import type { Result } from "./types/fp.js";
 import type * as operations from "./models/operations/index.js";
 import type * as models from "./models/index.js";
-import { type CreateCollectionInput, type UpdateCollectionInput, type QueryCollectionInput, type QueryCollectionResponse, type ListDocsInput, type ListDocsResponse, type ListCollectionsInput, type ListCollectionsResponseWithDates, type GetCollectionResponseWithDates, UpsertDocsInput, UpdateDocsInput, DeleteDocsInput, FetchDocsInput, FetchDocsResponse, BulkUpsertInput, MessageResponse, CreateCollectionResponse, UpdateCollectionResponse, GetBulkUpsertDocsResponse } from "./types/public.js";
+import { type CreateCollectionInput, type UpdateCollectionInput, type QueryCollectionInput, type QueryCollectionResponse, type ListDocsInput, type ListDocsResponse, type ListCollectionsInput, type ListCollectionsResponseWithDates, type GetCollectionResponseWithDates, type CreateCollectionResponseWithDates, type UpdateCollectionResponseWithDates, type GetBulkUpsertInput, type UpsertDocsInput, type UpdateDocsInput, type DeleteDocsInput, type FetchDocsInput, type FetchDocsResponse, type BulkUpsertInput, type MessageResponse, type GetBulkUpsertDocsResponse } from "./types/public.js";
 import type { ListCollectionsError, CreateCollectionError, GetCollectionError, UpdateCollectionError, DeleteCollectionError, QueryCollectionError, ListDocsError, UpsertDocsError, UpdateDocsError, DeleteDocsError, FetchDocsError, GetBulkUpsertDocsError, BulkUpsertDocsError } from "./types/errors.js";
 export type { RequestOptions };
 export type * from "./types/public.js";
@@ -41,12 +43,18 @@ export type LambdaDBClientOptions = SDKOptions & {
      * Project name (path segment under /projects/). Default: "playground"
      */
     projectName?: string;
+    /**
+     * Separate unauthenticated transport for presigned uploads and downloads.
+     * API authentication and API request headers are never copied to it.
+     */
+    transferClient?: HTTPClient;
 };
 /**
  * Client with collection-scoped API. Prefer this over the legacy
  * `LambdaDB` when you want to avoid passing collectionName on every call.
  */
 export declare class LambdaDBClient extends LambdaDBCore {
+    #private;
     constructor(options?: LambdaDBClientOptions);
     /**
      * Get a handle for a specific collection. All methods on the handle
@@ -80,11 +88,11 @@ export declare class LambdaDBClient extends LambdaDBCore {
     /**
      * Create a new collection.
      */
-    createCollection(request: CreateCollectionInput, options?: RequestOptions): Promise<operations.CreateCollectionResponse>;
+    createCollection(request: CreateCollectionInput, options?: RequestOptions): Promise<CreateCollectionResponseWithDates>;
     /**
      * Create a new collection (Safe: returns Result instead of throwing).
      */
-    createCollectionSafe(request: CreateCollectionInput, options?: RequestOptions): Promise<Result<CreateCollectionResponse, CreateCollectionError>>;
+    createCollectionSafe(request: CreateCollectionInput, options?: RequestOptions): Promise<Result<CreateCollectionResponseWithDates, CreateCollectionError>>;
 }
 /**
  * Handle for a single collection. All methods operate on this collection.
@@ -92,7 +100,11 @@ export declare class LambdaDBClient extends LambdaDBCore {
 export declare class CollectionHandle {
     private readonly client;
     readonly collectionName: string;
-    constructor(client: LambdaDBCore, collectionName: string);
+    private readonly transferClient;
+    constructor(client: LambdaDBCore, collectionName: string, transferClient?: HTTPClient);
+    readonly branches: CollectionBranches;
+    readonly tags: CollectionTags;
+    readonly aliases: CollectionAliases;
     /**
      * Get metadata of this collection. Timestamp fields are returned as Date.
      */
@@ -104,11 +116,11 @@ export declare class CollectionHandle {
     /**
      * Configure (update) this collection.
      */
-    update(requestBody: UpdateCollectionInput, options?: RequestOptions): Promise<operations.UpdateCollectionResponse>;
+    update(requestBody: UpdateCollectionInput, options?: RequestOptions): Promise<UpdateCollectionResponseWithDates>;
     /**
      * Configure (update) this collection (Safe: returns Result instead of throwing).
      */
-    updateSafe(requestBody: UpdateCollectionInput, options?: RequestOptions): Promise<Result<UpdateCollectionResponse, UpdateCollectionError>>;
+    updateSafe(requestBody: UpdateCollectionInput, options?: RequestOptions): Promise<Result<UpdateCollectionResponseWithDates, UpdateCollectionError>>;
     /**
      * Delete this collection.
      */
@@ -133,10 +145,11 @@ export declare class CollectionHandle {
 /**
  * Document operations scoped to a collection.
  */
-declare class CollectionDocs {
+export declare class CollectionDocs {
     private readonly client;
     private readonly collectionName;
-    constructor(client: LambdaDBCore, collectionName: string);
+    private readonly transferClient;
+    constructor(client: LambdaDBCore, collectionName: string, transferClient: HTTPClient);
     /**
      * List documents in the collection.
      * When the API returns docs via docsUrl (isDocsInline false), documents are
@@ -153,7 +166,8 @@ declare class CollectionDocs {
      * Use this to process large result sets without loading everything into memory.
      *
      * Note: The API limits response size by payload, not by document count. The number of docs per page
-     * may be less than the requested `size` and can vary from page to page.
+     * may be less than the requested `size` and can vary from page to page. A page token is a search
+     * position, not a Snapshot pin; use one immutable Tag throughout a stable export.
      *
      * @example
      * for await (const page of collection.docs.listPages({ size: 50 })) {
@@ -188,11 +202,11 @@ declare class CollectionDocs {
      */
     updateSafe(body: UpdateDocsInput, options?: RequestOptions): Promise<Result<MessageResponse, UpdateDocsError>>;
     /**
-     * Delete documents by ids and/or filter.
+     * Delete documents by exactly one of ids or filter. partitionFilter only narrows that selector.
      */
     delete(body: DeleteDocsInput, options?: RequestOptions): Promise<MessageResponse>;
     /**
-     * Delete documents by ids and/or filter (Safe: returns Result instead of throwing).
+     * Delete documents by exactly one of ids or filter (Safe: returns Result instead of throwing).
      */
     deleteSafe(body: DeleteDocsInput, options?: RequestOptions): Promise<Result<MessageResponse, DeleteDocsError>>;
     /**
@@ -209,11 +223,13 @@ declare class CollectionDocs {
     /**
      * Get presigned URL and metadata for bulk upload (up to 200MB). Not supported for collections with managed embedding vector fields.
      */
-    getBulkUpsert(options?: RequestOptions): Promise<operations.GetBulkUpsertDocsResponse>;
+    getBulkUpsert(options?: RequestOptions): Promise<GetBulkUpsertDocsResponse>;
+    getBulkUpsert(input: GetBulkUpsertInput, options?: RequestOptions): Promise<GetBulkUpsertDocsResponse>;
     /**
      * Get presigned URL and metadata for bulk upload (Safe: returns Result instead of throwing). Not supported for collections with managed embedding vector fields.
      */
     getBulkUpsertSafe(options?: RequestOptions): Promise<Result<GetBulkUpsertDocsResponse, GetBulkUpsertDocsError>>;
+    getBulkUpsertSafe(input: GetBulkUpsertInput, options?: RequestOptions): Promise<Result<GetBulkUpsertDocsResponse, GetBulkUpsertDocsError>>;
     /**
      * Trigger bulk upsert with an object key from getBulkUpsert(). Not supported for collections with managed embedding vector fields.
      */
@@ -225,12 +241,13 @@ declare class CollectionDocs {
     /**
      * Bulk upsert documents in one call (up to 200MB). Not supported for collections with managed embedding vector fields. Abstracts getBulkUpsert,
      * S3 upload via presigned URL, and bulkUpsert. Use this for better DX when
-     * you have a document list; use getBulkUpsert + bulkUpsert for low-level control.
+     * you have a document list; use getBulkUpsert + bulkUpsert for low-level control. The create-only
+     * signed PUT is not retried, and a failed upload is not finalized.
      */
     bulkUpsertDocs(body: UpsertDocsInput, options?: RequestOptions): Promise<MessageResponse>;
     /**
      * Bulk upsert documents in one call (Safe: returns Result instead of throwing). Not supported for collections with managed embedding vector fields.
-     * May return Error for local failures (payload size, upload). API errors use GetBulkUpsertDocsError or BulkUpsertDocsError.
+     * May return Error for local failures (serialization, payload size, upload). API errors use GetBulkUpsertDocsError or BulkUpsertDocsError.
      */
     bulkUpsertDocsSafe(body: UpsertDocsInput, options?: RequestOptions): Promise<Result<MessageResponse, GetBulkUpsertDocsError | BulkUpsertDocsError | Error>>;
 }