@sylphx/contract 0.2.0

package/dist/endpoints/session-replay.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Session Replay endpoints — Console-plane playback viewer + admin.
+ * Mirrors `apps/api/src/server/platform/routes/session-replay.ts`.
+ *
+ * Production mount: `/session-replay/*`.
+ */
+import { Schema } from 'effect';
+export declare const sessionReplayEndpoints: {
+    readonly list: import("../endpoint.js").Endpoint<"GET", "/session-replay/projects/:projectId/sessions", Schema.Struct<{
+        projectId: typeof Schema.String;
+    }>, Schema.Struct<{
+        hasErrors: Schema.optional<typeof Schema.String>;
+        hasRageClicks: Schema.optional<typeof Schema.String>;
+        hasDeadClicks: Schema.optional<typeof Schema.String>;
+        userId: Schema.optional<typeof Schema.String>;
+        startDate: Schema.optional<typeof Schema.String>;
+        endDate: Schema.optional<typeof Schema.String>;
+        limit: Schema.optional<typeof Schema.String>;
+        offset: Schema.optional<typeof Schema.String>;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        sessions: Schema.Array$<Schema.Struct<{
+            id: typeof Schema.String;
+            sessionId: typeof Schema.String;
+            userId: Schema.NullOr<typeof Schema.String>;
+            url: Schema.NullOr<typeof Schema.String>;
+            userAgent: Schema.NullOr<typeof Schema.String>;
+            screenWidth: Schema.NullOr<typeof Schema.Number>;
+            screenHeight: Schema.NullOr<typeof Schema.Number>;
+            devicePixelRatio: Schema.NullOr<typeof Schema.Number>;
+            timezone: Schema.NullOr<typeof Schema.String>;
+            language: Schema.NullOr<typeof Schema.String>;
+            duration: Schema.NullOr<typeof Schema.Number>;
+            eventCount: typeof Schema.Number;
+            bytesStored: typeof Schema.Number;
+            hasErrors: typeof Schema.Boolean;
+            errorIds: Schema.Array$<typeof Schema.String>;
+            hasRageClicks: typeof Schema.Boolean;
+            hasDeadClicks: typeof Schema.Boolean;
+            rageClickCount: typeof Schema.Number;
+            deadClickCount: typeof Schema.Number;
+            networkRequestCount: typeof Schema.Number;
+            consoleLogCount: typeof Schema.Number;
+            markers: Schema.Array$<Schema.Struct<{
+                type: typeof Schema.String;
+                timestamp: typeof Schema.Number;
+                payload: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+            }>>;
+            isComplete: typeof Schema.Boolean;
+            startedAt: typeof Schema.String;
+            endedAt: Schema.NullOr<typeof Schema.String>;
+            createdAt: typeof Schema.String;
+            updatedAt: typeof Schema.String;
+        }>>;
+        total: typeof Schema.Number;
+        hasMore: typeof Schema.Boolean;
+    }>>;
+    readonly get: import("../endpoint.js").Endpoint<"GET", "/session-replay/projects/:projectId/sessions/:sessionId", Schema.Struct<{
+        projectId: typeof Schema.String;
+        sessionId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        id: typeof Schema.String;
+        sessionId: typeof Schema.String;
+        userId: Schema.NullOr<typeof Schema.String>;
+        url: Schema.NullOr<typeof Schema.String>;
+        userAgent: Schema.NullOr<typeof Schema.String>;
+        screenWidth: Schema.NullOr<typeof Schema.Number>;
+        screenHeight: Schema.NullOr<typeof Schema.Number>;
+        devicePixelRatio: Schema.NullOr<typeof Schema.Number>;
+        timezone: Schema.NullOr<typeof Schema.String>;
+        language: Schema.NullOr<typeof Schema.String>;
+        duration: Schema.NullOr<typeof Schema.Number>;
+        eventCount: typeof Schema.Number;
+        bytesStored: typeof Schema.Number;
+        hasErrors: typeof Schema.Boolean;
+        errorIds: Schema.Array$<typeof Schema.String>;
+        hasRageClicks: typeof Schema.Boolean;
+        hasDeadClicks: typeof Schema.Boolean;
+        rageClickCount: typeof Schema.Number;
+        deadClickCount: typeof Schema.Number;
+        networkRequestCount: typeof Schema.Number;
+        consoleLogCount: typeof Schema.Number;
+        markers: Schema.Array$<Schema.Struct<{
+            type: typeof Schema.String;
+            timestamp: typeof Schema.Number;
+            payload: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+        }>>;
+        isComplete: typeof Schema.Boolean;
+        startedAt: typeof Schema.String;
+        endedAt: Schema.NullOr<typeof Schema.String>;
+        createdAt: typeof Schema.String;
+        updatedAt: typeof Schema.String;
+        events: Schema.Array$<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+        rageClicks: Schema.Array$<Schema.Struct<{
+            timestamp: typeof Schema.Number;
+            element: typeof Schema.String;
+            selector: Schema.optional<typeof Schema.String>;
+            clickCount: typeof Schema.Number;
+            duration: Schema.optional<typeof Schema.Number>;
+            x: Schema.optional<typeof Schema.Number>;
+            y: Schema.optional<typeof Schema.Number>;
+        }>>;
+        deadClicks: Schema.Array$<Schema.Struct<{
+            timestamp: typeof Schema.Number;
+            element: typeof Schema.String;
+            selector: Schema.optional<typeof Schema.String>;
+            expectedAction: Schema.optional<typeof Schema.String>;
+            x: Schema.optional<typeof Schema.Number>;
+            y: Schema.optional<typeof Schema.Number>;
+            waitTime: Schema.optional<typeof Schema.Number>;
+        }>>;
+        networkRequests: Schema.Array$<Schema.Struct<{
+            timestamp: typeof Schema.Number;
+            method: typeof Schema.String;
+            url: typeof Schema.String;
+            status: typeof Schema.Number;
+            duration: typeof Schema.Number;
+        }>>;
+        consoleLogs: Schema.Array$<Schema.Struct<{
+            timestamp: typeof Schema.Number;
+            level: Schema.Literal<["log", "info", "warn", "error"]>;
+            message: typeof Schema.String;
+            stack: Schema.optional<typeof Schema.String>;
+        }>>;
+    }>>;
+    readonly stats: import("../endpoint.js").Endpoint<"GET", "/session-replay/projects/:projectId/sessions/stats", Schema.Struct<{
+        projectId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        totalSessions: typeof Schema.Number;
+        sessionsThisMonth: typeof Schema.Number;
+        sessionsThisWeek: typeof Schema.Number;
+        sessionsWithErrors: typeof Schema.Number;
+        sessionsWithRageClicks: typeof Schema.Number;
+        totalStorageBytes: typeof Schema.Number;
+    }>>;
+    readonly delete: import("../endpoint.js").Endpoint<"DELETE", "/session-replay/projects/:projectId/sessions/:sessionId", Schema.Struct<{
+        projectId: typeof Schema.String;
+        sessionId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        success: typeof Schema.Boolean;
+    }>>;
+};
+//# sourceMappingURL=session-replay.d.ts.map

package/dist/endpoints/session-replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-replay.d.ts","sourceRoot":"","sources":["../../src/endpoints/session-replay.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAgB/B,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCzB,CAAA"}

package/dist/endpoints/session-replay.js

@@ -0,0 +1,53 @@
+/**
+ * Session Replay endpoints — Console-plane playback viewer + admin.
+ * Mirrors `apps/api/src/server/platform/routes/session-replay.ts`.
+ *
+ * Production mount: `/session-replay/*`.
+ */
+import { Schema } from 'effect';
+import { defineEndpoint } from '../endpoint.js';
+import { DeleteSessionResult, GetSessionResult, ListSessionsQuery, ListSessionsResult, SessionStatsResult, } from '../schemas/session-replay.js';
+const ProjectPath = Schema.Struct({ projectId: Schema.String });
+const ProjectSessionPath = Schema.Struct({
+    projectId: Schema.String,
+    sessionId: Schema.String,
+});
+export const sessionReplayEndpoints = {
+    list: defineEndpoint({
+        method: 'GET',
+        path: '/session-replay/projects/:projectId/sessions',
+        params: ProjectPath,
+        query: ListSessionsQuery,
+        response: ListSessionsResult,
+        plane: 'management',
+        summary: 'List session replay recordings with filtering and pagination',
+        tags: ['session-replay'],
+    }),
+    get: defineEndpoint({
+        method: 'GET',
+        path: '/session-replay/projects/:projectId/sessions/:sessionId',
+        params: ProjectSessionPath,
+        response: GetSessionResult,
+        plane: 'management',
+        summary: 'Get a single session with decompressed events for playback',
+        tags: ['session-replay'],
+    }),
+    stats: defineEndpoint({
+        method: 'GET',
+        path: '/session-replay/projects/:projectId/sessions/stats',
+        params: ProjectPath,
+        response: SessionStatsResult,
+        plane: 'management',
+        summary: 'Get aggregate statistics about session replays',
+        tags: ['session-replay'],
+    }),
+    delete: defineEndpoint({
+        method: 'DELETE',
+        path: '/session-replay/projects/:projectId/sessions/:sessionId',
+        params: ProjectSessionPath,
+        response: DeleteSessionResult,
+        plane: 'management',
+        summary: 'Delete a session replay recording and all its chunks',
+        tags: ['session-replay'],
+    }),
+};

package/dist/endpoints/storage-admin.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Storage Admin endpoints — Console-plane legacy SDK Storage service.
+ * Mirrors `apps/api/src/server/platform/routes/storage/**`.
+ *
+ * Production mount: `/storage/*`. `-admin` distinguishes from
+ * `storageEndpoints` (BaaS plane served on the standalone runtime).
+ *
+ * Note: this sub-tree is the LEGACY per-project SDK Storage service
+ * (`storageBuckets` table). The newer managed-resource Storage flow is
+ * separate (`POST /api/v1/projects/:id/storage` under `managementResources`).
+ * See `routes/storage/index.ts` for the deprecation notice.
+ */
+export declare const storageAdminEndpoints: {
+    readonly listBuckets: import("../endpoint.js").Endpoint<"GET", "/storage/projects/:id/buckets", import("effect/Schema").Struct<{
+        id: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        limit: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        offset: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        prefix: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        cursor: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        path: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        search: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, typeof import("effect/Schema").Unknown>;
+    readonly getBucket: import("../endpoint.js").Endpoint<"GET", "/storage/projects/:projectId/buckets/:bucketId", import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        bucketId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, typeof import("effect/Schema").Unknown>;
+    readonly createBucket: import("../endpoint.js").Endpoint<"POST", "/storage/buckets", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        environmentId: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        name: typeof import("effect/Schema").String;
+        description: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        isPublic: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+        accessRules: import("effect/Schema").optional<import("effect/Schema").Array$<import("effect/Schema").Struct<{
+            type: import("effect/Schema").Literal<["public", "authenticated", "owner_only", "admin_only"]>;
+            permission: import("effect/Schema").Literal<["read", "read-write", "full"]>;
+        }>>>;
+        corsEnabled: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+        allowedOrigins: import("effect/Schema").optional<import("effect/Schema").Array$<typeof import("effect/Schema").String>>;
+        maxFileSize: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+        allowedMimeTypes: import("effect/Schema").optional<import("effect/Schema").Array$<typeof import("effect/Schema").String>>;
+    }>, typeof import("effect/Schema").Unknown>;
+    readonly updateBucket: import("../endpoint.js").Endpoint<"PATCH", "/storage/projects/:projectId/buckets/:bucketId", import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        bucketId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        name: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        description: import("effect/Schema").optional<import("effect/Schema").NullOr<typeof import("effect/Schema").String>>;
+        isPublic: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+        accessRules: import("effect/Schema").optional<import("effect/Schema").Array$<import("effect/Schema").Struct<{
+            type: import("effect/Schema").Literal<["public", "authenticated", "owner_only", "admin_only"]>;
+            permission: import("effect/Schema").Literal<["read", "read-write", "full"]>;
+        }>>>;
+        corsEnabled: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+        allowedOrigins: import("effect/Schema").optional<import("effect/Schema").Array$<typeof import("effect/Schema").String>>;
+        maxFileSize: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+        allowedMimeTypes: import("effect/Schema").optional<import("effect/Schema").Array$<typeof import("effect/Schema").String>>;
+    }>, typeof import("effect/Schema").Unknown>;
+    readonly deleteBucket: import("../endpoint.js").Endpoint<"DELETE", "/storage/projects/:projectId/buckets/:bucketId", import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        bucketId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, typeof import("effect/Schema").Unknown>;
+    readonly bulkDeleteBuckets: import("../endpoint.js").Endpoint<"POST", "/storage/buckets/bulk-delete", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        bucketIds: import("effect/Schema").Array$<typeof import("effect/Schema").String>;
+    }>, typeof import("effect/Schema").Unknown>;
+    readonly listBucketFiles: import("../endpoint.js").Endpoint<"GET", "/storage/projects/:projectId/buckets/:bucketId/files", import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        bucketId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        limit: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        offset: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        prefix: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        cursor: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        path: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        search: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, typeof import("effect/Schema").Unknown>;
+    readonly listProjectFiles: import("../endpoint.js").Endpoint<"GET", "/storage/projects/:id/files", import("effect/Schema").Struct<{
+        id: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        limit: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        offset: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        prefix: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        cursor: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        path: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        search: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, typeof import("effect/Schema").Unknown>;
+    readonly deleteFile: import("../endpoint.js").Endpoint<"DELETE", "/storage/projects/:projectId/files/:fileId", import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        fileId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, typeof import("effect/Schema").Unknown>;
+    readonly getServiceData: import("../endpoint.js").Endpoint<"GET", "/storage/projects/:id/service-data", import("effect/Schema").Struct<{
+        id: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, typeof import("effect/Schema").Unknown>;
+};
+//# sourceMappingURL=storage-admin.d.ts.map

package/dist/endpoints/storage-admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-admin.d.ts","sourceRoot":"","sources":["../../src/endpoints/storage-admin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkGxB,CAAA"}

package/dist/endpoints/storage-admin.js

@@ -0,0 +1,113 @@
+/**
+ * Storage Admin endpoints — Console-plane legacy SDK Storage service.
+ * Mirrors `apps/api/src/server/platform/routes/storage/**`.
+ *
+ * Production mount: `/storage/*`. `-admin` distinguishes from
+ * `storageEndpoints` (BaaS plane served on the standalone runtime).
+ *
+ * Note: this sub-tree is the LEGACY per-project SDK Storage service
+ * (`storageBuckets` table). The newer managed-resource Storage flow is
+ * separate (`POST /api/v1/projects/:id/storage` under `managementResources`).
+ * See `routes/storage/index.ts` for the deprecation notice.
+ */
+import { defineEndpoint } from '../endpoint.js';
+import { BulkDeleteBucketsInput, CreateBucketInput, StorageAdminResult, StorageProjectBucketParams, StorageProjectFileParams, StorageProjectIdParams, StorageQuery, UpdateBucketInput, } from '../schemas/storage-admin.js';
+export const storageAdminEndpoints = {
+    // ── buckets.ts ───────────────────────────────────────────────────────
+    listBuckets: defineEndpoint({
+        method: 'GET',
+        path: '/storage/projects/:id/buckets',
+        params: StorageProjectIdParams,
+        query: StorageQuery,
+        response: StorageAdminResult,
+        plane: 'management',
+        summary: 'List storage buckets for a project',
+        tags: ['storage-admin'],
+    }),
+    getBucket: defineEndpoint({
+        method: 'GET',
+        path: '/storage/projects/:projectId/buckets/:bucketId',
+        params: StorageProjectBucketParams,
+        response: StorageAdminResult,
+        plane: 'management',
+        summary: 'Get a storage bucket by ID',
+        tags: ['storage-admin'],
+    }),
+    createBucket: defineEndpoint({
+        method: 'POST',
+        path: '/storage/buckets',
+        body: CreateBucketInput,
+        response: StorageAdminResult,
+        plane: 'management',
+        summary: 'Create a storage bucket',
+        tags: ['storage-admin'],
+    }),
+    updateBucket: defineEndpoint({
+        method: 'PATCH',
+        path: '/storage/projects/:projectId/buckets/:bucketId',
+        params: StorageProjectBucketParams,
+        body: UpdateBucketInput,
+        response: StorageAdminResult,
+        plane: 'management',
+        summary: 'Update a storage bucket',
+        tags: ['storage-admin'],
+    }),
+    deleteBucket: defineEndpoint({
+        method: 'DELETE',
+        path: '/storage/projects/:projectId/buckets/:bucketId',
+        params: StorageProjectBucketParams,
+        response: StorageAdminResult,
+        plane: 'management',
+        summary: 'Delete a storage bucket',
+        tags: ['storage-admin'],
+    }),
+    bulkDeleteBuckets: defineEndpoint({
+        method: 'POST',
+        path: '/storage/buckets/bulk-delete',
+        body: BulkDeleteBucketsInput,
+        response: StorageAdminResult,
+        plane: 'management',
+        summary: 'Bulk delete storage buckets',
+        tags: ['storage-admin'],
+    }),
+    // ── files.ts ─────────────────────────────────────────────────────────
+    listBucketFiles: defineEndpoint({
+        method: 'GET',
+        path: '/storage/projects/:projectId/buckets/:bucketId/files',
+        params: StorageProjectBucketParams,
+        query: StorageQuery,
+        response: StorageAdminResult,
+        plane: 'management',
+        summary: 'List files in a bucket',
+        tags: ['storage-admin'],
+    }),
+    listProjectFiles: defineEndpoint({
+        method: 'GET',
+        path: '/storage/projects/:id/files',
+        params: StorageProjectIdParams,
+        query: StorageQuery,
+        response: StorageAdminResult,
+        plane: 'management',
+        summary: 'List files across all buckets in a project',
+        tags: ['storage-admin'],
+    }),
+    deleteFile: defineEndpoint({
+        method: 'DELETE',
+        path: '/storage/projects/:projectId/files/:fileId',
+        params: StorageProjectFileParams,
+        response: StorageAdminResult,
+        plane: 'management',
+        summary: 'Delete a stored file',
+        tags: ['storage-admin'],
+    }),
+    // ── service-data.ts ──────────────────────────────────────────────────
+    getServiceData: defineEndpoint({
+        method: 'GET',
+        path: '/storage/projects/:id/service-data',
+        params: StorageProjectIdParams,
+        response: StorageAdminResult,
+        plane: 'management',
+        summary: 'Get storage dashboard overview (buckets + usage)',
+        tags: ['storage-admin'],
+    }),
+};

package/dist/endpoints/storage.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Storage endpoints — BaaS plane. Paths mirror `@sylphx/sdk/storage.ts`.
+ */
+import { Schema } from 'effect';
+export declare const storageEndpoints: {
+    /**
+     * Mint an upload token for client-direct uploads. Returns either a
+     * simple `{ uploadUrl, publicUrl }` pair or a Vercel-Blob-style
+     * `{ uploadEndpoint, clientPayload, instructions }` envelope.
+     * This is the SDK's primary upload path (`uploadFile` / `uploadAvatar`).
+     */
+    readonly upload: import("../endpoint.js").Endpoint<"POST", "/storage/upload", Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        filename: typeof Schema.String;
+        contentType: Schema.optional<typeof Schema.String>;
+        size: Schema.optional<typeof Schema.Number>;
+        path: Schema.optional<typeof Schema.String>;
+        type: Schema.optional<Schema.Literal<["file", "avatar"]>>;
+        userId: Schema.optional<typeof Schema.String>;
+        metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    }>, 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>;
+        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>>;
+    }>>;
+    readonly presignedUrl: import("../endpoint.js").Endpoint<"POST", "/storage/upload-url", Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        filename: typeof Schema.String;
+        contentType: typeof Schema.String;
+        size: Schema.optional<typeof Schema.Number>;
+    }>, Schema.Struct<{
+        uploadUrl: typeof Schema.String;
+        fileId: typeof Schema.String;
+        expiresAt: typeof Schema.String;
+    }>>;
+    /**
+     * Generate a time-limited signed URL for accessing a private file.
+     * Signed URLs avoid exposing permanent credentials and can be scoped
+     * to a specific user via the `userId` field.
+     */
+    readonly signedUrl: import("../endpoint.js").Endpoint<"POST", "/storage/signed-url", Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        fileId: typeof Schema.String;
+        expiresIn: Schema.optional<typeof Schema.Number>;
+        disposition: Schema.optional<Schema.Literal<["attachment", "inline"]>>;
+        userId: Schema.optional<typeof Schema.String>;
+    }>, Schema.Struct<{
+        url: typeof Schema.String;
+        expiresAt: typeof Schema.String;
+        file: Schema.Struct<{
+            id: typeof Schema.String;
+            filename: typeof Schema.String;
+            mimeType: typeof Schema.String;
+            sizeBytes: typeof Schema.Number;
+            isPrivate: typeof Schema.Boolean;
+        }>;
+    }>>;
+    readonly list: import("../endpoint.js").Endpoint<"GET", "/storage/files", Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        prefix: Schema.optional<typeof Schema.String>;
+        limit: Schema.optional<typeof Schema.String>;
+        cursor: Schema.optional<typeof Schema.String>;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        files: Schema.Array$<Schema.Struct<{
+            id: typeof Schema.String;
+            size: typeof Schema.Number;
+            name: Schema.optional<typeof Schema.String>;
+            filename: Schema.optional<typeof Schema.String>;
+            path: Schema.optional<typeof Schema.String>;
+            key: Schema.optional<typeof Schema.String>;
+            url: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            contentType: Schema.optional<typeof Schema.String>;
+            mimeType: Schema.optional<typeof Schema.String>;
+            isPrivate: Schema.optional<typeof Schema.Boolean>;
+            metadata: Schema.optional<Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>>;
+            createdAt: Schema.optional<typeof Schema.String>;
+            uploadedAt: Schema.optional<typeof Schema.String>;
+        }>>;
+        nextCursor: Schema.NullOr<typeof Schema.String>;
+        hasMore: Schema.optional<typeof Schema.Boolean>;
+    }>>;
+    readonly get: import("../endpoint.js").Endpoint<"GET", "/storage/files/:id", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        id: typeof Schema.String;
+        size: typeof Schema.Number;
+        name: Schema.optional<typeof Schema.String>;
+        filename: Schema.optional<typeof Schema.String>;
+        path: Schema.optional<typeof Schema.String>;
+        key: Schema.optional<typeof Schema.String>;
+        url: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        contentType: Schema.optional<typeof Schema.String>;
+        mimeType: Schema.optional<typeof Schema.String>;
+        isPrivate: Schema.optional<typeof Schema.Boolean>;
+        metadata: Schema.optional<Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>>;
+        createdAt: Schema.optional<typeof Schema.String>;
+        uploadedAt: Schema.optional<typeof Schema.String>;
+    }>>;
+    readonly delete: import("../endpoint.js").Endpoint<"DELETE", "/storage/files/:id", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        success: typeof Schema.Boolean;
+    }>>;
+    readonly listVersions: import("../endpoint.js").Endpoint<"GET", "/storage/files/:id/versions", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        versions: Schema.Array$<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;
+        }>>;
+    }>>;
+    readonly restoreVersion: import("../endpoint.js").Endpoint<"POST", "/storage/files/:id/versions/:versionId/restore", Schema.Struct<{
+        id: typeof Schema.String;
+        versionId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        success: Schema.Literal<[true]>;
+        version: 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;
+        }>;
+    }>>;
+    readonly restoreFile: import("../endpoint.js").Endpoint<"POST", "/storage/files/:id/restore", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        success: Schema.Literal<[true]>;
+        file: Schema.Struct<{
+            id: typeof Schema.String;
+            size: typeof Schema.Number;
+            name: Schema.optional<typeof Schema.String>;
+            filename: Schema.optional<typeof Schema.String>;
+            path: Schema.optional<typeof Schema.String>;
+            key: Schema.optional<typeof Schema.String>;
+            url: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            contentType: Schema.optional<typeof Schema.String>;
+            mimeType: Schema.optional<typeof Schema.String>;
+            isPrivate: Schema.optional<typeof Schema.Boolean>;
+            metadata: Schema.optional<Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>>;
+            createdAt: Schema.optional<typeof Schema.String>;
+            uploadedAt: Schema.optional<typeof Schema.String>;
+        }>;
+    }>>;
+    readonly softDelete: import("../endpoint.js").Endpoint<"DELETE", "/storage/files/:id", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        success: Schema.Literal<[true]>;
+        isDeleted: Schema.Literal<[true]>;
+    }>>;
+};
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/endpoints/storage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAyB/B,eAAO,MAAM,gBAAgB;IAC5B;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmBH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4EM,CAAA"}