@sylphx/contract 0.3.0 → 0.5.0

package/dist/schemas/resources.js

@@ -19,7 +19,7 @@ export const VolumeStatus = Schema.Literal('provisioning', 'active', 'error');
  *   caches / parallel workers)
  */
 export const VolumeAccessMode = Schema.Literal('ReadWriteOnce', 'ReadWriteMany');
-export const BindingRole = Schema.Literal('primary', 'replica', 'analytics', 'backup');
+export const BindingRole = Schema.Literal('primary', 'replica', 'analytics', 'backup', 'session');
 // ── Tier Badge (display) ───────────────────────────────────────────────────
 export const TierBadge = Schema.Struct({
     tier: ResourceTier,
@@ -218,3 +218,54 @@ export const CreateSearchResourceInput = Schema.Struct({
 export const ListSearchResourcesResult = Schema.Struct({
     resources: Schema.Array(SearchResource),
 });
+// ── Unified Managed Resource Wire Shape ───────────────────────────────────
+export const ManagedResource = Schema.Struct({
+    id: Schema.String,
+    orgId: Schema.optional(Schema.String),
+    name: Schema.String,
+    slug: Schema.optional(Schema.NullOr(Schema.String)),
+    kind: Schema.optional(ResourceType),
+    provider: Schema.optional(Schema.String),
+    tier: Schema.optional(Schema.String),
+    status: Schema.optional(Schema.String),
+    reconcileStatus: Schema.optional(Schema.String),
+    bindingCount: Schema.optional(Schema.Number),
+    host: Schema.optional(Schema.NullOr(Schema.String)),
+    directHost: Schema.optional(Schema.NullOr(Schema.String)),
+    port: Schema.optional(Schema.Number),
+    publicPort: Schema.optional(Schema.NullOr(Schema.Number)),
+    publicHost: Schema.optional(Schema.NullOr(Schema.String)),
+    dbUser: Schema.optional(Schema.NullOr(Schema.String)),
+    dbName: Schema.optional(Schema.NullOr(Schema.String)),
+    cacheUser: Schema.optional(Schema.NullOr(Schema.String)),
+    keyPrefix: Schema.optional(Schema.NullOr(Schema.String)),
+    connectionString: Schema.optional(Schema.NullOr(Schema.String)),
+    maskedConnectionString: Schema.optional(Schema.NullOr(Schema.String)),
+    publicConnectionString: Schema.optional(Schema.NullOr(Schema.String)),
+    maskedPublicConnectionString: Schema.optional(Schema.NullOr(Schema.String)),
+    storageGb: Schema.optional(Schema.Number),
+    env: Schema.optional(Schema.String),
+    engine: Schema.optional(Schema.String),
+    instances: Schema.optional(Schema.Number),
+    clusterName: Schema.optional(Schema.NullOr(Schema.String)),
+    branchName: Schema.optional(Schema.NullOr(Schema.String)),
+    backupRetentionDays: Schema.optional(Schema.Number),
+    bucket: Schema.optional(Schema.String),
+    endpoint: Schema.optional(Schema.NullOr(Schema.String)),
+    region: Schema.optional(Schema.NullOr(Schema.String)),
+    prefix: Schema.optional(Schema.NullOr(Schema.String)),
+    publicUrl: Schema.optional(Schema.NullOr(Schema.String)),
+    accessMode: Schema.optional(VolumeAccessMode),
+    hostPath: Schema.optional(Schema.NullOr(Schema.String)),
+    mountPath: Schema.optional(Schema.NullOr(Schema.String)),
+    sizeGb: Schema.optional(Schema.NullOr(Schema.Number)),
+    memoryGb: Schema.optional(Schema.Number),
+    nodes: Schema.optional(Schema.Number),
+    apiKey: Schema.optional(Schema.NullOr(Schema.String)),
+    message: Schema.optional(Schema.String),
+    provisioningError: Schema.optional(Schema.NullOr(Schema.String)),
+    conditions: Schema.optional(Schema.Array(Schema.Unknown)),
+    config: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.Unknown })),
+    createdAt: Schema.optional(Schema.String),
+    updatedAt: Schema.optional(Schema.String),
+});

package/dist/schemas/storage.d.ts

@@ -1,256 +1,317 @@
 /**
- * Storage — BaaS plane file upload / download. Uses presigned URLs per AWS
- * S3 convention. Mirrors `@sylphx/sdk/storage.ts`.
+ * Storage — BaaS plane object storage. Per ADR-100.
  *
- * Shape policy (ADR-084 Wave 2d): schemas here are the UNION superset of
- * all production SDK / OpenAPI-generated wire shapes. Any field that is not
- * universally present on the wire is `optional`, so contract consumers
- * never have to narrow to parse a legitimate server response. When the
- * server response narrows in future, tighten the optional in a dedicated
- * wave — never break existing callers by removing a field.
+ * Wire is one resource (`uploads`) plus the existing `files` resource. No
+ * polymorphic POSTs, no vendor-namespaced wire envelopes, no historical
+ * field aliases. Every endpoint has exactly one request and one response
+ * schema.
+ *
+ * Storage backends (B2, R2) are abstracted by `apps/storage-gateway`. The
+ * BaaS handler returns presigned URLs against `storage.sylphx.com`; the
+ * client uploads bytes there directly. Mid-flow tenant subdomain hops are
+ * forbidden (ADR-083.1).
  */
 import { Schema } from 'effect';
 export declare const FileId: Schema.brand<typeof Schema.String, "FileId">;
 export type FileId = typeof FileId.Type;
+export declare const UploadId: Schema.brand<typeof Schema.String, "UploadId">;
+export type UploadId = typeof UploadId.Type;
+export declare const FileVersionId: Schema.brand<typeof Schema.String, "FileVersionId">;
+export type FileVersionId = typeof FileVersionId.Type;
+export declare const FileVisibility: Schema.Literal<["public", "private"]>;
+export type FileVisibility = typeof FileVisibility.Type;
+export declare const SignedUrlDisposition: Schema.Literal<["attachment", "inline"]>;
+export type SignedUrlDisposition = typeof SignedUrlDisposition.Type;
+/** Method discriminator on the upload-create response. */
+export declare const UploadMethod: Schema.Literal<["PUT", "MULTIPART"]>;
+export type UploadMethod = typeof UploadMethod.Type;
 /**
- * File metadata superset — reconciles three historical shapes:
- *
- * - SDK `FileInfo` interface: `{ id, url, name, size, contentType,
- *   isPrivate, createdAt }`
- * - Generated OpenAPI `FileInfo` / `GetFileResponse`: `{ id, filename,
- *   path, url, mimeType, size, metadata, createdAt }`
- * - Previous contract shape: `{ id, key, size, contentType, url?,
- *   uploadedAt }`
- *
- * Every historical field is preserved as optional so older and newer
- * clients can both parse server responses. `id` and `size` are the only
- * guaranteed-present fields across all three shapes.
+ * Canonical file metadata. Single shape — no aliases, no nullable hacks
+ * for legacy callers. ADR-100 §2.6.
  */
-export declare const FileInfo: Schema.Struct<{
-    id: typeof Schema.String;
+export declare const File: Schema.Struct<{
+    id: Schema.brand<typeof Schema.String, "FileId">;
+    filename: typeof Schema.String;
+    contentType: typeof Schema.String;
     size: typeof Schema.Number;
-    /** SDK-native filename (preferred). Alias of `filename` on newer servers. */
-    name: Schema.optional<typeof Schema.String>;
-    /** OpenAPI-native filename. Alias of `name` on older servers. */
-    filename: Schema.optional<typeof Schema.String>;
-    /** Folder path or storage key. */
-    path: Schema.optional<typeof Schema.String>;
-    /** Legacy storage object key (contract v1). */
-    key: Schema.optional<typeof Schema.String>;
-    /** Public URL — null for private files, absent on some delete responses. */
-    url: Schema.optional<Schema.NullOr<typeof Schema.String>>;
-    /** SDK-native MIME type. */
-    contentType: Schema.optional<typeof Schema.String>;
-    /** OpenAPI-native MIME type (alias of `contentType`). */
-    mimeType: Schema.optional<typeof Schema.String>;
-    /** Private/public visibility flag. Absent => treat as public. */
-    isPrivate: Schema.optional<typeof Schema.Boolean>;
-    /** Arbitrary caller-attached metadata. */
-    metadata: Schema.optional<Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>>;
-    /** SDK-native creation timestamp (ISO string). */
-    createdAt: Schema.optional<typeof Schema.String>;
-    /** Legacy contract v1 upload timestamp (alias of createdAt). */
-    uploadedAt: Schema.optional<typeof Schema.String>;
+    checksumSha256: typeof Schema.String;
+    etag: typeof Schema.String;
+    visibility: Schema.Literal<["public", "private"]>;
+    folder: Schema.NullOr<typeof Schema.String>;
+    metadata: Schema.Record$<typeof Schema.String, typeof Schema.Unknown>;
+    /** Public URL when `visibility === 'public'`; `null` otherwise. Use `:signedUrl` for private files. */
+    url: Schema.NullOr<typeof Schema.String>;
+    isDeleted: typeof Schema.Boolean;
+    createdAt: typeof Schema.DateFromString;
+    updatedAt: typeof Schema.DateFromString;
+}>;
+export type File = typeof File.Type;
+export declare const FileVersion: Schema.Struct<{
+    id: Schema.brand<typeof Schema.String, "FileVersionId">;
+    fileId: Schema.brand<typeof Schema.String, "FileId">;
+    versionNumber: typeof Schema.Number;
+    size: typeof Schema.Number;
+    contentType: typeof Schema.String;
+    checksumSha256: typeof Schema.String;
+    etag: typeof Schema.String;
+    createdAt: typeof Schema.DateFromString;
+    createdBy: Schema.NullOr<typeof Schema.String>;
+    isCurrent: typeof Schema.Boolean;
+}>;
+export type FileVersion = typeof FileVersion.Type;
+export declare const UploadCreateRequest: Schema.Struct<{
+    filename: Schema.filter<typeof Schema.String>;
+    contentType: Schema.filter<typeof Schema.String>;
+    size: Schema.filter<typeof Schema.Number>;
+    folder: Schema.optional<typeof Schema.String>;
+    visibility: Schema.optional<Schema.Literal<["public", "private"]>>;
+    metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    /** Pre-computed SHA-256 (hex); verified server-side on `:complete` (multipart) or after PUT (single). */
+    checksumSha256: Schema.optional<typeof Schema.String>;
+    /** S3-style precondition; if `'*'`, fail when a file already exists at (folder, filename). */
+    ifNoneMatch: Schema.optional<Schema.Literal<["*"]>>;
+}>;
+export type UploadCreateRequest = typeof UploadCreateRequest.Type;
+export declare const UploadPart: Schema.Struct<{
+    partNumber: Schema.filter<typeof Schema.Number>;
+    url: typeof Schema.String;
+    expiresAt: typeof Schema.DateFromString;
 }>;
-export type FileInfo = typeof FileInfo.Type;
+export type UploadPart = typeof UploadPart.Type;
 /**
- * Input for the richer `/storage/upload` token flow used by the SDK for
- * client-direct uploads (Vercel Blob pattern). Server mints an upload
- * endpoint + client payload, and the SDK performs the actual PUT against
- * storage. Superset of `UploadUrlInput`.
+ * Single-part response — the request body fits in one PUT. Client uploads
+ * the whole blob to `url` with the supplied `headers`, captures the `ETag`
+ * response header, then calls `:complete` with `parts: [{partNumber: 1,
+ * etag}]` to finalise. The `:complete` step is non-optional even for
+ * single-part uploads because it is what writes the file row to the
+ * database and consumes quota — without it the storage object is
+ * orphaned and reclaimed by the multipart-aborts sweeper after
+ * `expiresAt`.
  */
-export declare const UploadTokenInput: Schema.Struct<{
-    filename: typeof Schema.String;
-    contentType: Schema.optional<typeof Schema.String>;
-    size: Schema.optional<typeof Schema.Number>;
-    /** Folder path for organizing the file. */
-    path: Schema.optional<typeof Schema.String>;
-    /** `file` | `avatar` — avatars apply user-scoped policy. */
-    type: Schema.optional<Schema.Literal<["file", "avatar"]>>;
-    /** User ID (required for `type: 'avatar'`). */
-    userId: Schema.optional<typeof Schema.String>;
-    /** Arbitrary caller-attached metadata persisted alongside the blob. */
-    metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+export declare const UploadCreateSinglePartResult: Schema.Struct<{
+    method: Schema.Literal<["PUT"]>;
+    uploadId: Schema.brand<typeof Schema.String, "UploadId">;
+    fileId: Schema.brand<typeof Schema.String, "FileId">;
+    url: typeof Schema.String;
+    headers: Schema.Record$<typeof Schema.String, typeof Schema.String>;
+    expiresAt: typeof Schema.DateFromString;
 }>;
-export type UploadTokenInput = typeof UploadTokenInput.Type;
+export type UploadCreateSinglePartResult = typeof UploadCreateSinglePartResult.Type;
 /**
- * Upload token response. Supports both the simple `{ uploadUrl, publicUrl,
- * fileId, expiresAt }` shape and the richer Vercel-Blob-style
- * `{ uploadEndpoint, clientPayload, instructions, ... }` shape.
+ * Multipart response — client PUTs each part to its presigned URL, then
+ * calls `POST /uploads/{uploadId}:complete` with the per-part etags.
  */
-export declare const UploadTokenResult: Schema.Struct<{
-    uploadUrl: Schema.optional<typeof Schema.String>;
-    publicUrl: Schema.optional<typeof Schema.String>;
-    fileId: Schema.optional<typeof Schema.String>;
-    expiresAt: Schema.optional<typeof Schema.String>;
-    presignedUrl: Schema.optional<typeof Schema.String>;
-    storageKey: Schema.optional<typeof Schema.String>;
-    tokenPayload: Schema.optional<typeof Schema.String>;
-    url: Schema.optional<typeof Schema.String>;
-    uploadEndpoint: Schema.optional<typeof Schema.String>;
-    clientPayload: Schema.optional<typeof Schema.String>;
-    maxSize: Schema.optional<typeof Schema.Number>;
-    maxMultipartSize: Schema.optional<typeof Schema.Number>;
-    multipartThreshold: Schema.optional<typeof Schema.Number>;
-    allowedContentTypes: Schema.optional<Schema.Array$<typeof Schema.String>>;
-    instructions: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+export declare const UploadCreateMultipartResult: Schema.Struct<{
+    method: Schema.Literal<["MULTIPART"]>;
+    uploadId: Schema.brand<typeof Schema.String, "UploadId">;
+    fileId: Schema.brand<typeof Schema.String, "FileId">;
+    partSize: typeof Schema.Number;
+    partCount: typeof Schema.Number;
+    parts: Schema.Array$<Schema.Struct<{
+        partNumber: Schema.filter<typeof Schema.Number>;
+        url: typeof Schema.String;
+        expiresAt: typeof Schema.DateFromString;
+    }>>;
+    expiresAt: typeof Schema.DateFromString;
 }>;
-export type UploadTokenResult = typeof UploadTokenResult.Type;
-export declare const UploadUrlInput: Schema.Struct<{
-    filename: typeof Schema.String;
-    contentType: typeof Schema.String;
-    size: Schema.optional<typeof Schema.Number>;
+export type UploadCreateMultipartResult = typeof UploadCreateMultipartResult.Type;
+/**
+ * Discriminated union on `method`. SDK narrows via the literal; downstream
+ * code never has to inspect optional fields.
+ */
+export declare const UploadCreateResult: Schema.Union<[Schema.Struct<{
+    method: Schema.Literal<["PUT"]>;
+    uploadId: Schema.brand<typeof Schema.String, "UploadId">;
+    fileId: Schema.brand<typeof Schema.String, "FileId">;
+    url: typeof Schema.String;
+    headers: Schema.Record$<typeof Schema.String, typeof Schema.String>;
+    expiresAt: typeof Schema.DateFromString;
+}>, Schema.Struct<{
+    method: Schema.Literal<["MULTIPART"]>;
+    uploadId: Schema.brand<typeof Schema.String, "UploadId">;
+    fileId: Schema.brand<typeof Schema.String, "FileId">;
+    partSize: typeof Schema.Number;
+    partCount: typeof Schema.Number;
+    parts: Schema.Array$<Schema.Struct<{
+        partNumber: Schema.filter<typeof Schema.Number>;
+        url: typeof Schema.String;
+        expiresAt: typeof Schema.DateFromString;
+    }>>;
+    expiresAt: typeof Schema.DateFromString;
+}>]>;
+export type UploadCreateResult = typeof UploadCreateResult.Type;
+/** Refresh a single part presigned URL — used when an upload pauses past `expiresAt`. */
+export declare const UploadPartPresignResult: Schema.Struct<{
+    url: typeof Schema.String;
+    expiresAt: typeof Schema.DateFromString;
 }>;
-export type UploadUrlInput = typeof UploadUrlInput.Type;
-export declare const UploadUrlResult: Schema.Struct<{
-    uploadUrl: typeof Schema.String;
-    fileId: typeof Schema.String;
-    expiresAt: typeof Schema.String;
+export type UploadPartPresignResult = typeof UploadPartPresignResult.Type;
+export declare const UploadCompletePart: Schema.Struct<{
+    partNumber: Schema.filter<typeof Schema.Number>;
+    etag: Schema.filter<typeof Schema.String>;
+}>;
+export type UploadCompletePart = typeof UploadCompletePart.Type;
+export declare const UploadCompleteRequest: Schema.Struct<{
+    parts: Schema.Array$<Schema.Struct<{
+        partNumber: Schema.filter<typeof Schema.Number>;
+        etag: Schema.filter<typeof Schema.String>;
+    }>>;
+}>;
+export type UploadCompleteRequest = typeof UploadCompleteRequest.Type;
+export declare const UploadCompleteResult: Schema.Struct<{
+    fileId: Schema.brand<typeof Schema.String, "FileId">;
+    url: Schema.NullOr<typeof Schema.String>;
+    size: typeof Schema.Number;
+    etag: typeof Schema.String;
+    checksumSha256: typeof Schema.String;
 }>;
-export type UploadUrlResult = typeof UploadUrlResult.Type;
+export type UploadCompleteResult = typeof UploadCompleteResult.Type;
 export declare const ListFilesQuery: Schema.Struct<{
-    prefix: Schema.optional<typeof Schema.String>;
-    limit: Schema.optional<typeof Schema.String>;
+    folder: Schema.optional<typeof Schema.String>;
     cursor: Schema.optional<typeof Schema.String>;
+    /** Page size; clamped server-side to [1, 100]; default 25. */
+    limit: Schema.optional<typeof Schema.Number>;
+    includeDeleted: Schema.optional<typeof Schema.Boolean>;
 }>;
 export type ListFilesQuery = typeof ListFilesQuery.Type;
 export declare const ListFilesResult: Schema.Struct<{
     files: Schema.Array$<Schema.Struct<{
-        id: typeof Schema.String;
+        id: Schema.brand<typeof Schema.String, "FileId">;
+        filename: typeof Schema.String;
+        contentType: typeof Schema.String;
         size: typeof Schema.Number;
-        /** SDK-native filename (preferred). Alias of `filename` on newer servers. */
-        name: Schema.optional<typeof Schema.String>;
-        /** OpenAPI-native filename. Alias of `name` on older servers. */
-        filename: Schema.optional<typeof Schema.String>;
-        /** Folder path or storage key. */
-        path: Schema.optional<typeof Schema.String>;
-        /** Legacy storage object key (contract v1). */
-        key: Schema.optional<typeof Schema.String>;
-        /** Public URL — null for private files, absent on some delete responses. */
-        url: Schema.optional<Schema.NullOr<typeof Schema.String>>;
-        /** SDK-native MIME type. */
-        contentType: Schema.optional<typeof Schema.String>;
-        /** OpenAPI-native MIME type (alias of `contentType`). */
-        mimeType: Schema.optional<typeof Schema.String>;
-        /** Private/public visibility flag. Absent => treat as public. */
-        isPrivate: Schema.optional<typeof Schema.Boolean>;
-        /** Arbitrary caller-attached metadata. */
-        metadata: Schema.optional<Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>>;
-        /** SDK-native creation timestamp (ISO string). */
-        createdAt: Schema.optional<typeof Schema.String>;
-        /** Legacy contract v1 upload timestamp (alias of createdAt). */
-        uploadedAt: Schema.optional<typeof Schema.String>;
+        checksumSha256: typeof Schema.String;
+        etag: typeof Schema.String;
+        visibility: Schema.Literal<["public", "private"]>;
+        folder: Schema.NullOr<typeof Schema.String>;
+        metadata: Schema.Record$<typeof Schema.String, typeof Schema.Unknown>;
+        /** Public URL when `visibility === 'public'`; `null` otherwise. Use `:signedUrl` for private files. */
+        url: Schema.NullOr<typeof Schema.String>;
+        isDeleted: typeof Schema.Boolean;
+        createdAt: typeof Schema.DateFromString;
+        updatedAt: typeof Schema.DateFromString;
     }>>;
     nextCursor: Schema.NullOr<typeof Schema.String>;
-    /** True if there are more files beyond this page. */
-    hasMore: Schema.optional<typeof Schema.Boolean>;
 }>;
 export type ListFilesResult = typeof ListFilesResult.Type;
-export declare const DeleteFileResult: Schema.Struct<{
-    success: typeof Schema.Boolean;
+export declare const SoftDeleteFileResult: Schema.Struct<{
+    id: Schema.brand<typeof Schema.String, "FileId">;
+    isDeleted: Schema.Literal<[true]>;
 }>;
-export type DeleteFileResult = typeof DeleteFileResult.Type;
-/**
- * Signed download URL input. Returns a short-lived URL for private files
- * without exposing permanent credentials.
- */
-export declare const SignedUrlInput: Schema.Struct<{
-    fileId: typeof Schema.String;
-    /** Seconds until the URL expires (default: 3600, max: 604800 = 7 days). */
-    expiresIn: Schema.optional<typeof Schema.Number>;
-    /** `attachment` forces download, `inline` displays in browser. */
+export type SoftDeleteFileResult = typeof SoftDeleteFileResult.Type;
+export declare const RestoreFileResult: Schema.Struct<{
+    id: Schema.brand<typeof Schema.String, "FileId">;
+    filename: typeof Schema.String;
+    contentType: typeof Schema.String;
+    size: typeof Schema.Number;
+    checksumSha256: typeof Schema.String;
+    etag: typeof Schema.String;
+    visibility: Schema.Literal<["public", "private"]>;
+    folder: Schema.NullOr<typeof Schema.String>;
+    metadata: Schema.Record$<typeof Schema.String, typeof Schema.Unknown>;
+    /** Public URL when `visibility === 'public'`; `null` otherwise. Use `:signedUrl` for private files. */
+    url: Schema.NullOr<typeof Schema.String>;
+    isDeleted: typeof Schema.Boolean;
+    createdAt: typeof Schema.DateFromString;
+    updatedAt: typeof Schema.DateFromString;
+}>;
+export type RestoreFileResult = File;
+export declare const SignedUrlRequest: Schema.Struct<{
+    expiresIn: Schema.optional<Schema.filter<typeof Schema.Number>>;
     disposition: Schema.optional<Schema.Literal<["attachment", "inline"]>>;
-    /** Restrict URL access to a specific user. */
+    /** Restrict the signed URL to a specific authenticated user (claim baked into the signature). */
     userId: Schema.optional<typeof Schema.String>;
 }>;
-export type SignedUrlInput = typeof SignedUrlInput.Type;
+export type SignedUrlRequest = typeof SignedUrlRequest.Type;
 export declare const SignedUrlResult: Schema.Struct<{
     url: typeof Schema.String;
-    expiresAt: typeof Schema.String;
+    expiresAt: typeof Schema.DateFromString;
     file: Schema.Struct<{
-        id: typeof Schema.String;
+        id: Schema.brand<typeof Schema.String, "FileId">;
         filename: typeof Schema.String;
-        mimeType: typeof Schema.String;
-        sizeBytes: typeof Schema.Number;
-        isPrivate: typeof Schema.Boolean;
+        contentType: typeof Schema.String;
+        size: typeof Schema.Number;
+        checksumSha256: typeof Schema.String;
+        etag: typeof Schema.String;
+        visibility: Schema.Literal<["public", "private"]>;
+        folder: Schema.NullOr<typeof Schema.String>;
+        metadata: Schema.Record$<typeof Schema.String, typeof Schema.Unknown>;
+        /** Public URL when `visibility === 'public'`; `null` otherwise. Use `:signedUrl` for private files. */
+        url: Schema.NullOr<typeof Schema.String>;
+        isDeleted: typeof Schema.Boolean;
+        createdAt: typeof Schema.DateFromString;
+        updatedAt: typeof Schema.DateFromString;
     }>;
 }>;
 export type SignedUrlResult = typeof SignedUrlResult.Type;
-/**
- * A single version of a file. Append-only per-file history — every
- * upload creates one row with a monotonic `versionNumber`. Restore
- * creates a NEW version row pointing at the old object (never mutates
- * history).
- */
-export declare const StorageFileVersion: Schema.Struct<{
-    id: typeof Schema.String;
-    fileId: typeof Schema.String;
-    versionNumber: typeof Schema.Number;
-    sizeBytes: typeof Schema.Number;
-    contentType: Schema.NullOr<typeof Schema.String>;
-    checksumSha256: Schema.NullOr<typeof Schema.String>;
-    createdAt: typeof Schema.String;
-    createdBy: Schema.NullOr<typeof Schema.String>;
-    isCurrent: typeof Schema.Boolean;
+export declare const CopyFileRequest: Schema.Struct<{
+    folder: Schema.optional<typeof Schema.String>;
+    filename: Schema.optional<typeof Schema.String>;
+    visibility: Schema.optional<Schema.Literal<["public", "private"]>>;
+    metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
 }>;
-export type StorageFileVersion = typeof StorageFileVersion.Type;
+export type CopyFileRequest = typeof CopyFileRequest.Type;
+export declare const CopyFileResult: Schema.Struct<{
+    id: Schema.brand<typeof Schema.String, "FileId">;
+    filename: typeof Schema.String;
+    contentType: typeof Schema.String;
+    size: typeof Schema.Number;
+    checksumSha256: typeof Schema.String;
+    etag: typeof Schema.String;
+    visibility: Schema.Literal<["public", "private"]>;
+    folder: Schema.NullOr<typeof Schema.String>;
+    metadata: Schema.Record$<typeof Schema.String, typeof Schema.Unknown>;
+    /** Public URL when `visibility === 'public'`; `null` otherwise. Use `:signedUrl` for private files. */
+    url: Schema.NullOr<typeof Schema.String>;
+    isDeleted: typeof Schema.Boolean;
+    createdAt: typeof Schema.DateFromString;
+    updatedAt: typeof Schema.DateFromString;
+}>;
+export type CopyFileResult = File;
 export declare const ListFileVersionsResult: Schema.Struct<{
     versions: Schema.Array$<Schema.Struct<{
-        id: typeof Schema.String;
-        fileId: typeof Schema.String;
+        id: Schema.brand<typeof Schema.String, "FileVersionId">;
+        fileId: Schema.brand<typeof Schema.String, "FileId">;
         versionNumber: typeof Schema.Number;
-        sizeBytes: typeof Schema.Number;
-        contentType: Schema.NullOr<typeof Schema.String>;
-        checksumSha256: Schema.NullOr<typeof Schema.String>;
-        createdAt: typeof Schema.String;
+        size: typeof Schema.Number;
+        contentType: typeof Schema.String;
+        checksumSha256: typeof Schema.String;
+        etag: typeof Schema.String;
+        createdAt: typeof Schema.DateFromString;
         createdBy: Schema.NullOr<typeof Schema.String>;
         isCurrent: typeof Schema.Boolean;
     }>>;
 }>;
 export type ListFileVersionsResult = typeof ListFileVersionsResult.Type;
 export declare const RestoreVersionResult: Schema.Struct<{
-    success: Schema.Literal<[true]>;
+    file: Schema.Struct<{
+        id: Schema.brand<typeof Schema.String, "FileId">;
+        filename: typeof Schema.String;
+        contentType: typeof Schema.String;
+        size: typeof Schema.Number;
+        checksumSha256: typeof Schema.String;
+        etag: typeof Schema.String;
+        visibility: Schema.Literal<["public", "private"]>;
+        folder: Schema.NullOr<typeof Schema.String>;
+        metadata: Schema.Record$<typeof Schema.String, typeof Schema.Unknown>;
+        /** Public URL when `visibility === 'public'`; `null` otherwise. Use `:signedUrl` for private files. */
+        url: Schema.NullOr<typeof Schema.String>;
+        isDeleted: typeof Schema.Boolean;
+        createdAt: typeof Schema.DateFromString;
+        updatedAt: typeof Schema.DateFromString;
+    }>;
     version: Schema.Struct<{
-        id: typeof Schema.String;
-        fileId: typeof Schema.String;
+        id: Schema.brand<typeof Schema.String, "FileVersionId">;
+        fileId: Schema.brand<typeof Schema.String, "FileId">;
         versionNumber: typeof Schema.Number;
-        sizeBytes: typeof Schema.Number;
-        contentType: Schema.NullOr<typeof Schema.String>;
-        checksumSha256: Schema.NullOr<typeof Schema.String>;
-        createdAt: typeof Schema.String;
+        size: typeof Schema.Number;
+        contentType: typeof Schema.String;
+        checksumSha256: typeof Schema.String;
+        etag: typeof Schema.String;
+        createdAt: typeof Schema.DateFromString;
         createdBy: Schema.NullOr<typeof Schema.String>;
         isCurrent: typeof Schema.Boolean;
     }>;
 }>;
 export type RestoreVersionResult = typeof RestoreVersionResult.Type;
-export declare const RestoreFileResult: Schema.Struct<{
-    success: Schema.Literal<[true]>;
-    file: Schema.Struct<{
-        id: typeof Schema.String;
-        size: typeof Schema.Number;
-        /** SDK-native filename (preferred). Alias of `filename` on newer servers. */
-        name: Schema.optional<typeof Schema.String>;
-        /** OpenAPI-native filename. Alias of `name` on older servers. */
-        filename: Schema.optional<typeof Schema.String>;
-        /** Folder path or storage key. */
-        path: Schema.optional<typeof Schema.String>;
-        /** Legacy storage object key (contract v1). */
-        key: Schema.optional<typeof Schema.String>;
-        /** Public URL — null for private files, absent on some delete responses. */
-        url: Schema.optional<Schema.NullOr<typeof Schema.String>>;
-        /** SDK-native MIME type. */
-        contentType: Schema.optional<typeof Schema.String>;
-        /** OpenAPI-native MIME type (alias of `contentType`). */
-        mimeType: Schema.optional<typeof Schema.String>;
-        /** Private/public visibility flag. Absent => treat as public. */
-        isPrivate: Schema.optional<typeof Schema.Boolean>;
-        /** Arbitrary caller-attached metadata. */
-        metadata: Schema.optional<Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>>;
-        /** SDK-native creation timestamp (ISO string). */
-        createdAt: Schema.optional<typeof Schema.String>;
-        /** Legacy contract v1 upload timestamp (alias of createdAt). */
-        uploadedAt: Schema.optional<typeof Schema.String>;
-    }>;
-}>;
-export type RestoreFileResult = typeof RestoreFileResult.Type;
 //# sourceMappingURL=storage.d.ts.map

package/dist/schemas/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/schemas/storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/schemas/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAM/B,eAAO,MAAM,MAAM,8CAA6C,CAAA;AAChE,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,IAAI,CAAA;AAEvC,eAAO,MAAM,QAAQ,gDAA+C,CAAA;AACpE,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAA;AAE3C,eAAO,MAAM,aAAa,qDAAoD,CAAA;AAC9E,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AAMrD,eAAO,MAAM,cAAc,uCAAsC,CAAA;AACjE,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA;AAEvD,eAAO,MAAM,oBAAoB,0CAAyC,CAAA;AAC1E,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAA;AAEnE,0DAA0D;AAC1D,eAAO,MAAM,YAAY,sCAAqC,CAAA;AAC9D,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAMnD;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;IAUhB,uGAAuG;;;;;EAKtG,CAAA;AACF,MAAM,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,CAAA;AAEnC,eAAO,MAAM,WAAW;;;;;;;;;;;EAWtB,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAA;AAMjD,eAAO,MAAM,mBAAmB;;;;;;;IAO/B,yGAAyG;;IAEzG,8FAA8F;;EAE7F,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAA;AAEjE,eAAO,MAAM,UAAU;;;;EAIrB,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAE/C;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B;;;;;;;EAOvC,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAC,IAAI,CAAA;AAEnF;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;EAQtC,CAAA;AACF,MAAM,MAAM,2BAA2B,GAAG,OAAO,2BAA2B,CAAC,IAAI,CAAA;AAEjF;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;IAG9B,CAAA;AACD,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;AAM/D,yFAAyF;AACzF,eAAO,MAAM,uBAAuB;;;EAGlC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAA;AAEzE,eAAO,MAAM,kBAAkB;;;EAG7B,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;AAE/D,eAAO,MAAM,qBAAqB;;;;;EAEhC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC,IAAI,CAAA;AAErE,eAAO,MAAM,oBAAoB;;;;;;EAM/B,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAA;AAMnE,eAAO,MAAM,cAAc;;;IAG1B,8DAA8D;;;EAG7D,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA;AAEvD,eAAO,MAAM,eAAe;;;;;;;;;;;QAxI3B,uGAAuG;;;;;;;EA2ItG,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEzD,eAAO,MAAM,oBAAoB;;;EAG/B,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAA;AAEnE,eAAO,MAAM,iBAAiB;;;;;;;;;;IApJ7B,uGAAuG;;;;;EAoJnE,CAAA;AACrC,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAA;AAMpC,eAAO,MAAM,gBAAgB;;;IAG5B,iGAAiG;;EAEhG,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA;AAE3D,eAAO,MAAM,eAAe;;;;;;;;;;;;;QAnK3B,uGAAuG;;;;;;EAuKtG,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAMzD,eAAO,MAAM,eAAe;;;;;EAK1B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEzD,eAAO,MAAM,cAAc;;;;;;;;;;IAtL1B,uGAAuG;;;;;EAsLtE,CAAA;AAClC,MAAM,MAAM,cAAc,GAAG,IAAI,CAAA;AAMjC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;EAEjC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAC,IAAI,CAAA;AAEvE,eAAO,MAAM,oBAAoB;;;;;;;;;;;QAlMhC,uGAAuG;;;;;;;;;;;;;;;;;;EAqMtG,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAA"}