@nsp-labs/agnostic-sdk 1.1.0 → 1.5.0

package/src/index.d.ts

@@ -1,5 +1,5 @@
-export { AgnosticRuntime, RuntimeAppAuthNamespace, RuntimeContextNamespace, RuntimeDataNamespace, RuntimeDataRecordsClient, RuntimeDataTableClient, RuntimeDataViewClient, RuntimeDataViewTableClient, RuntimeWorkflowRunsNamespace, RuntimeWorkflowsNamespace, createAgnosticRuntime, } from './lib/runtime-client';
+export { AgnosticRuntime, RuntimeAppAuthNamespace, RuntimeContextNamespace, RuntimeDataNamespace, RuntimeDataRecordsClient, RuntimeDataTableClient, RuntimeDataViewClient, RuntimeDataViewTableClient, RuntimeAnonymousUploadsClient, RuntimeStorageBucketClient, RuntimeStorageNamespace, RuntimeWorkflowRunsNamespace, RuntimeWorkflowsNamespace, createAgnosticRuntime, } from './lib/runtime-client';
 export { normalizeApiUrl, resolveRuntimeContext } from './lib/context';
 export { AgnosticRuntimeError } from './lib/errors';
 export { AGNOSTIC_RUNTIME_SDK_MANIFEST, type AgnosticRuntimeSdkManifest, } from './lib/manifest';
-export type { AgnosticRuntimeConfig, ResolvedRuntimeContext, RuntimeActorMetadata, RuntimeActorType, RuntimeAppAuthActor, RuntimeAppAuthCachePolicy, RuntimeAppAuthRequestLike, RuntimeAppAuthSession, RuntimeAppAuthSessionClaims, RuntimeAppAuthUserClaims, RuntimeAppAuthUserResult, RuntimeCreateRecordInput, RuntimeDataField, RuntimeDataViewState, RuntimeIdentityContext, RuntimeListRecordsOptions, RuntimeListWindowOptions, RuntimeRecord, RuntimeRecordMutation, RuntimeRecordsList, RuntimeRequestOptions, RuntimeRowData, RuntimeRowValue, RuntimeTableWindow, RuntimeUpdateRecordInput, RuntimeWorkflowRun, RuntimeWorkflowStepRun, RuntimeWorkflowWaitOptions, WorkflowRunStatus, } from './lib/types';
+export type { RuntimeQueryRecordsInput, RuntimeBatchQueryItem, RuntimeBatchQueryResult, AgnosticRuntimeConfig, RuntimeAggregateMetric, RuntimeAggregateOperation, RuntimeAggregateOrderBy, RuntimeAggregateRecordsInput, RuntimeAggregateRecordsResult, RuntimeAggregateRow, ResolvedRuntimeContext, RuntimeActorMetadata, RuntimeActorType, RuntimeAnonymousClaimFileHandle, RuntimeAnonymousClaimInput, RuntimeAnonymousClaimResult, RuntimeAppAuthActor, RuntimeAppAuthCachePolicy, RuntimeAppAuthRequestLike, RuntimeAppAuthSession, RuntimeAppAuthSessionClaims, RuntimeAppAuthUserClaims, RuntimeAppAuthUserResult, RuntimeCreateRecordInput, RuntimeCreateFileUploadInput, RuntimeDataField, RuntimeDataViewState, RuntimeIdentityContext, RuntimeFileAccessMode, RuntimeFileDownloadUrl, RuntimeFileObject, RuntimeFileObjectStatus, RuntimeFileUploadCompletion, RuntimeFileUploadGrant, RuntimeListRecordsOptions, RuntimeListWindowOptions, RuntimeRecord, RuntimeRecordMutation, RuntimeRecordsList, RuntimeRequestOptions, RuntimeRowData, RuntimeRowValue, RuntimeTableWindow, RuntimeUpdateRecordInput, RuntimeWorkflowRun, RuntimeWorkflowStepRun, RuntimeWorkflowWaitOptions, WorkflowRunStatus, } from './lib/types';

package/src/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AGNOSTIC_RUNTIME_SDK_MANIFEST = exports.AgnosticRuntimeError = exports.resolveRuntimeContext = exports.normalizeApiUrl = exports.createAgnosticRuntime = exports.RuntimeWorkflowsNamespace = exports.RuntimeWorkflowRunsNamespace = exports.RuntimeDataViewTableClient = exports.RuntimeDataViewClient = exports.RuntimeDataTableClient = exports.RuntimeDataRecordsClient = exports.RuntimeDataNamespace = exports.RuntimeContextNamespace = exports.RuntimeAppAuthNamespace = exports.AgnosticRuntime = void 0;
+exports.AGNOSTIC_RUNTIME_SDK_MANIFEST = exports.AgnosticRuntimeError = exports.resolveRuntimeContext = exports.normalizeApiUrl = exports.createAgnosticRuntime = exports.RuntimeWorkflowsNamespace = exports.RuntimeWorkflowRunsNamespace = exports.RuntimeStorageNamespace = exports.RuntimeStorageBucketClient = exports.RuntimeAnonymousUploadsClient = exports.RuntimeDataViewTableClient = exports.RuntimeDataViewClient = exports.RuntimeDataTableClient = exports.RuntimeDataRecordsClient = exports.RuntimeDataNamespace = exports.RuntimeContextNamespace = exports.RuntimeAppAuthNamespace = exports.AgnosticRuntime = void 0;
 var runtime_client_1 = require("./lib/runtime-client");
 Object.defineProperty(exports, "AgnosticRuntime", { enumerable: true, get: function () { return runtime_client_1.AgnosticRuntime; } });
 Object.defineProperty(exports, "RuntimeAppAuthNamespace", { enumerable: true, get: function () { return runtime_client_1.RuntimeAppAuthNamespace; } });
@@ -10,6 +10,9 @@ Object.defineProperty(exports, "RuntimeDataRecordsClient", { enumerable: true, g
 Object.defineProperty(exports, "RuntimeDataTableClient", { enumerable: true, get: function () { return runtime_client_1.RuntimeDataTableClient; } });
 Object.defineProperty(exports, "RuntimeDataViewClient", { enumerable: true, get: function () { return runtime_client_1.RuntimeDataViewClient; } });
 Object.defineProperty(exports, "RuntimeDataViewTableClient", { enumerable: true, get: function () { return runtime_client_1.RuntimeDataViewTableClient; } });
+Object.defineProperty(exports, "RuntimeAnonymousUploadsClient", { enumerable: true, get: function () { return runtime_client_1.RuntimeAnonymousUploadsClient; } });
+Object.defineProperty(exports, "RuntimeStorageBucketClient", { enumerable: true, get: function () { return runtime_client_1.RuntimeStorageBucketClient; } });
+Object.defineProperty(exports, "RuntimeStorageNamespace", { enumerable: true, get: function () { return runtime_client_1.RuntimeStorageNamespace; } });
 Object.defineProperty(exports, "RuntimeWorkflowRunsNamespace", { enumerable: true, get: function () { return runtime_client_1.RuntimeWorkflowRunsNamespace; } });
 Object.defineProperty(exports, "RuntimeWorkflowsNamespace", { enumerable: true, get: function () { return runtime_client_1.RuntimeWorkflowsNamespace; } });
 Object.defineProperty(exports, "createAgnosticRuntime", { enumerable: true, get: function () { return runtime_client_1.createAgnosticRuntime; } });

package/src/lib/manifest.d.ts

@@ -9,7 +9,7 @@ export declare const AGNOSTIC_RUNTIME_SDK_MANIFEST: Readonly<{
     readonly schema: "agnostic_runtime_sdk_manifest.v1";
     readonly package: Readonly<{
         name: "@nsp-labs/agnostic-sdk";
-        version: "1.1.0";
+        version: "1.5.0";
         factory: "createAgnosticRuntime";
         runtime: "server_only";
     }>;
@@ -18,12 +18,13 @@ export declare const AGNOSTIC_RUNTIME_SDK_MANIFEST: Readonly<{
         environmentVariables: readonly string[];
         secretEnvironmentVariables: readonly string[];
     }>;
-    readonly rootMembers: readonly [...("data" | "auth" | "context" | "workflows" | "workflowRuns")[], "getRuntimeContext"];
+    readonly rootMembers: readonly [...("data" | "auth" | "context" | "storage" | "workflows" | "workflowRuns")[], "getRuntimeContext"];
     readonly clientMethods: readonly ["getRuntimeContext"];
     readonly namespaces: Readonly<{
         auth: readonly ("requireSession" | "getSession" | "requireScopes" | "getUser")[];
         context: readonly "get"[];
-        data: readonly ("table(name).records.delete" | "table(name).records.list" | "table(name).records.create" | "table(name).records.update" | "view(id).table.window")[];
+        data: readonly ("batchQuery" | "table(name).records.delete" | "table(name).records.query" | "table(name).records.list" | "table(name).records.aggregate" | "table(name).records.create" | "table(name).records.update" | "view(id).table.window")[];
+        storage: readonly ("bucket(name).get" | "bucket(name).delete" | "bucket(name).createUpload" | "bucket(name).completeUpload" | "bucket(name).createDownloadUrl" | "bucket(name).anonymousUploads.claim")[];
         workflows: readonly ("start" | "getRun")[];
         workflowRuns: readonly ("get" | "wait" | "listSteps")[];
     }>;
@@ -32,6 +33,7 @@ export declare const AGNOSTIC_RUNTIME_SDK_MANIFEST: Readonly<{
         controlPlaneProvisioning: "agent_product_tools";
         runtimeAccess: "server_sdk";
         browserAccess: "public_api_or_app_auth_session";
+        appAuthSelfService: "public_api_via_project_backend_bff";
         browserPackageImportAllowed: false;
         browserRuntimeTokenAllowed: false;
     }>;

package/src/lib/manifest.js

@@ -11,12 +11,14 @@ const AUTH_KEYS_LITERAL = [
 const AUTH_KEYS = AUTH_KEYS_LITERAL;
 const CONTEXT_KEYS_LITERAL = ['get'];
 const CONTEXT_KEYS = CONTEXT_KEYS_LITERAL;
-const DATA_NAMESPACE_KEYS_LITERAL = ['table', 'view'];
+const DATA_NAMESPACE_KEYS_LITERAL = ['table', 'view', 'batchQuery'];
 const DATA_NAMESPACE_KEYS = DATA_NAMESPACE_KEYS_LITERAL;
 const DATA_TABLE_KEYS_LITERAL = ['records'];
 const DATA_TABLE_KEYS = DATA_TABLE_KEYS_LITERAL;
 const DATA_RECORD_KEYS_LITERAL = [
     'list',
+    'query',
+    'aggregate',
     'create',
     'update',
     'delete',
@@ -26,6 +28,19 @@ const DATA_VIEW_KEYS_LITERAL = ['table'];
 const DATA_VIEW_KEYS = DATA_VIEW_KEYS_LITERAL;
 const DATA_VIEW_TABLE_KEYS_LITERAL = ['window'];
 const DATA_VIEW_TABLE_KEYS = DATA_VIEW_TABLE_KEYS_LITERAL;
+const STORAGE_NAMESPACE_KEYS_LITERAL = ['bucket'];
+const STORAGE_NAMESPACE_KEYS = STORAGE_NAMESPACE_KEYS_LITERAL;
+const STORAGE_BUCKET_KEYS_LITERAL = [
+    'anonymousUploads',
+    'createUpload',
+    'completeUpload',
+    'get',
+    'createDownloadUrl',
+    'delete',
+];
+const STORAGE_BUCKET_KEYS = STORAGE_BUCKET_KEYS_LITERAL;
+const ANONYMOUS_UPLOAD_KEYS_LITERAL = ['claim'];
+const ANONYMOUS_UPLOAD_KEYS = ANONYMOUS_UPLOAD_KEYS_LITERAL;
 const WORKFLOW_KEYS_LITERAL = ['start', 'getRun'];
 const WORKFLOW_KEYS = WORKFLOW_KEYS_LITERAL;
 const WORKFLOW_RUN_KEYS_LITERAL = ['get', 'wait', 'listSteps'];
@@ -37,6 +52,11 @@ const NAMESPACES = Object.freeze({
     data: Object.freeze([
         ...DATA_RECORD_KEYS.map((method) => `${DATA_NAMESPACE_KEYS[0]}(name).${DATA_TABLE_KEYS[0]}.${method}`),
         ...DATA_VIEW_TABLE_KEYS.map((method) => `${DATA_NAMESPACE_KEYS[1]}(id).${DATA_VIEW_KEYS[0]}.${method}`),
+        DATA_NAMESPACE_KEYS[2],
+    ]),
+    storage: Object.freeze([
+        ...STORAGE_BUCKET_KEYS.filter((method) => method !== 'anonymousUploads').map((method) => `${STORAGE_NAMESPACE_KEYS[0]}(name).${method}`),
+        ...ANONYMOUS_UPLOAD_KEYS.map((method) => `${STORAGE_NAMESPACE_KEYS[0]}(name).${STORAGE_BUCKET_KEYS[0]}.${method}`),
     ]),
     workflows: Object.freeze([...WORKFLOW_KEYS]),
     workflowRuns: Object.freeze([...WORKFLOW_RUN_KEYS]),
@@ -50,7 +70,7 @@ const MANIFEST_CONTRACT = Object.freeze({
     schema: 'agnostic_runtime_sdk_manifest.v1',
     package: Object.freeze({
         name: '@nsp-labs/agnostic-sdk',
-        version: '1.1.0',
+        version: '1.5.0',
         factory: 'createAgnosticRuntime',
         runtime: 'server_only',
     }),
@@ -73,12 +93,12 @@ const MANIFEST_CONTRACT = Object.freeze({
         'gateway',
         'jobs',
         'realtime',
-        'storage',
     ]),
     boundaries: Object.freeze({
         controlPlaneProvisioning: 'agent_product_tools',
         runtimeAccess: 'server_sdk',
         browserAccess: 'public_api_or_app_auth_session',
+        appAuthSelfService: 'public_api_via_project_backend_bff',
         browserPackageImportAllowed: false,
         browserRuntimeTokenAllowed: false,
     }),

package/src/lib/runtime-client.d.ts

@@ -1,9 +1,10 @@
 import { type RuntimeOpenApiClient } from './http-client';
-import type { AgnosticRuntimeConfig, ResolvedRuntimeContext, RuntimeAppAuthRequestLike, RuntimeAppAuthSession, RuntimeAppAuthUserResult, RuntimeCreateRecordInput, RuntimeIdentityContext, RuntimeListRecordsOptions, RuntimeListWindowOptions, RuntimeRecordMutation, RuntimeRecordsList, RuntimeRequestOptions, RuntimeRowData, RuntimeTableWindow, RuntimeUpdateRecordInput, RuntimeWorkflowRun, RuntimeWorkflowStepRun, RuntimeWorkflowWaitOptions } from './types';
+import type { AgnosticRuntimeConfig, ResolvedRuntimeContext, RuntimeAppAuthRequestLike, RuntimeAppAuthSession, RuntimeAppAuthUserResult, RuntimeAnonymousClaimInput, RuntimeAnonymousClaimResult, RuntimeAggregateRecordsInput, RuntimeAggregateRecordsResult, RuntimeCreateFileUploadInput, RuntimeCreateRecordInput, RuntimeIdentityContext, RuntimeFileDownloadUrl, RuntimeFileObject, RuntimeFileUploadCompletion, RuntimeFileUploadGrant, RuntimeListRecordsOptions, RuntimeQueryRecordsInput, RuntimeBatchQueryItem, RuntimeBatchQueryResult, RuntimeListWindowOptions, RuntimeRecordMutation, RuntimeRecordsList, RuntimeRequestOptions, RuntimeRowData, RuntimeTableWindow, RuntimeUpdateRecordInput, RuntimeWorkflowRun, RuntimeWorkflowStepRun, RuntimeWorkflowWaitOptions } from './types';
 export declare class AgnosticRuntime {
     readonly auth: RuntimeAppAuthNamespace;
     readonly context: RuntimeContextNamespace;
     readonly data: RuntimeDataNamespace;
+    readonly storage: RuntimeStorageNamespace;
     readonly workflows: RuntimeWorkflowsNamespace;
     readonly workflowRuns: RuntimeWorkflowRunsNamespace;
     private readonly openapi;
@@ -30,6 +31,29 @@ export declare class RuntimeDataNamespace {
     constructor(openapi: RuntimeOpenApiClient);
     table(tableName: string): RuntimeDataTableClient;
     view(viewId: string): RuntimeDataViewClient;
+    batchQuery(queries: RuntimeBatchQueryItem[], options?: RuntimeRequestOptions): Promise<RuntimeBatchQueryResult>;
+}
+export declare class RuntimeStorageNamespace {
+    private readonly openapi;
+    constructor(openapi: RuntimeOpenApiClient);
+    bucket(bucketIdOrSlug: string): RuntimeStorageBucketClient;
+}
+export declare class RuntimeStorageBucketClient {
+    private readonly openapi;
+    private readonly bucketIdOrSlug;
+    readonly anonymousUploads: RuntimeAnonymousUploadsClient;
+    constructor(openapi: RuntimeOpenApiClient, bucketIdOrSlug: string);
+    createUpload(input: RuntimeCreateFileUploadInput, options?: RuntimeRequestOptions): Promise<RuntimeFileUploadGrant>;
+    completeUpload(uploadId: string, options?: RuntimeRequestOptions): Promise<RuntimeFileUploadCompletion>;
+    get(fileId: string, options?: RuntimeRequestOptions): Promise<RuntimeFileObject>;
+    createDownloadUrl(fileId: string, options?: RuntimeRequestOptions): Promise<RuntimeFileDownloadUrl>;
+    delete(fileId: string, options?: RuntimeRequestOptions): Promise<void>;
+}
+export declare class RuntimeAnonymousUploadsClient {
+    private readonly openapi;
+    private readonly bucketIdOrSlug;
+    constructor(openapi: RuntimeOpenApiClient, bucketIdOrSlug: string);
+    claim(input: RuntimeAnonymousClaimInput, options?: RuntimeRequestOptions): Promise<RuntimeAnonymousClaimResult>;
 }
 export declare class RuntimeDataTableClient {
     private readonly tableName;
@@ -41,6 +65,8 @@ export declare class RuntimeDataRecordsClient {
     private readonly tableName;
     constructor(openapi: RuntimeOpenApiClient, tableName: string);
     list(query?: RuntimeListRecordsOptions, options?: RuntimeRequestOptions): Promise<RuntimeRecordsList>;
+    query(input?: RuntimeQueryRecordsInput, options?: RuntimeRequestOptions): Promise<RuntimeRecordsList>;
+    aggregate(input: RuntimeAggregateRecordsInput, options?: RuntimeRequestOptions): Promise<RuntimeAggregateRecordsResult>;
     create(input: RuntimeCreateRecordInput | RuntimeRowData, options?: RuntimeRequestOptions): Promise<RuntimeRecordMutation>;
     update(recordId: string, input: RuntimeUpdateRecordInput | RuntimeRowData, options?: RuntimeRequestOptions): Promise<RuntimeRecordMutation>;
     delete(recordId: string, options?: RuntimeRequestOptions): Promise<RuntimeRecordMutation>;

package/src/lib/runtime-client.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RuntimeWorkflowRunsNamespace = exports.RuntimeWorkflowsNamespace = exports.RuntimeDataViewTableClient = exports.RuntimeDataViewClient = exports.RuntimeDataRecordsClient = exports.RuntimeDataTableClient = exports.RuntimeDataNamespace = exports.RuntimeContextNamespace = exports.RuntimeAppAuthNamespace = exports.AgnosticRuntime = void 0;
+exports.RuntimeWorkflowRunsNamespace = exports.RuntimeWorkflowsNamespace = exports.RuntimeDataViewTableClient = exports.RuntimeDataViewClient = exports.RuntimeDataRecordsClient = exports.RuntimeDataTableClient = exports.RuntimeAnonymousUploadsClient = exports.RuntimeStorageBucketClient = exports.RuntimeStorageNamespace = exports.RuntimeDataNamespace = exports.RuntimeContextNamespace = exports.RuntimeAppAuthNamespace = exports.AgnosticRuntime = void 0;
 exports.createAgnosticRuntime = createAgnosticRuntime;
 const http_client_1 = require("./http-client");
 const context_1 = require("./context");
@@ -9,8 +9,16 @@ const APP_AUTH_VERIFY_SESSION_PATH = '/api/v1/runtime/app-auth/session/verify';
 const APP_AUTH_USER_PATH = '/api/v1/runtime/app-auth/users/{userId}';
 const AUTH_CONTEXT_PATH = '/api/v1/runtime/auth/context';
 const DATA_RECORDS_PATH = '/api/v1/runtime/data/tables/{tableName}/records';
+const DATA_QUERY_PATH = '/api/v1/runtime/data/tables/{tableName}/records/query';
+const DATA_BATCH_QUERY_PATH = '/api/v1/runtime/data/records/batch-query';
+const DATA_AGGREGATE_PATH = '/api/v1/runtime/data/tables/{tableName}/records/aggregate';
 const DATA_RECORD_PATH = '/api/v1/runtime/data/tables/{tableName}/records/{recordId}';
 const DATA_VIEW_WINDOW_PATH = '/api/v1/runtime/data/views/{viewId}/table/window';
+const FILES_ANONYMOUS_CLAIM_PATH = '/api/v1/runtime/files/buckets/{bucketRef}/anonymous-upload-sessions/claim';
+const FILES_UPLOADS_PATH = '/api/v1/runtime/files/buckets/{bucketRef}/uploads';
+const FILES_UPLOAD_COMPLETE_PATH = '/api/v1/runtime/files/buckets/{bucketRef}/uploads/{uploadId}/complete';
+const FILES_OBJECT_PATH = '/api/v1/runtime/files/buckets/{bucketRef}/objects/{fileId}';
+const FILES_DOWNLOAD_PATH = '/api/v1/runtime/files/buckets/{bucketRef}/objects/{fileId}/download';
 const WORKFLOWS_START_PATH = '/api/v1/runtime/workflows/{workflowSlug}/runs';
 const WORKFLOW_RUN_PATH = '/api/v1/runtime/workflow-runs/{runId}';
 const WORKFLOW_RUN_STEPS_PATH = '/api/v1/runtime/workflow-runs/{runId}/steps';
@@ -32,6 +40,7 @@ class AgnosticRuntime {
         this.auth = new RuntimeAppAuthNamespace(this.openapi);
         this.context = new RuntimeContextNamespace(this.openapi);
         this.data = new RuntimeDataNamespace(this.openapi);
+        this.storage = new RuntimeStorageNamespace(this.openapi);
         this.workflowRuns = new RuntimeWorkflowRunsNamespace(this.openapi);
         this.workflows = new RuntimeWorkflowsNamespace(this.openapi, this.workflowRuns);
     }
@@ -131,8 +140,85 @@ class RuntimeDataNamespace {
     view(viewId) {
         return new RuntimeDataViewClient(this.openapi, viewId);
     }
+    async batchQuery(queries, options) {
+        const result = await this.openapi.POST(DATA_BATCH_QUERY_PATH, {
+            body: { queries },
+            headers: (0, http_client_1.runtimeRequestHeaders)(options),
+        });
+        return (0, http_client_1.unwrapRuntimeResult)(result, 'Failed to batch query data records');
+    }
 }
 exports.RuntimeDataNamespace = RuntimeDataNamespace;
+class RuntimeStorageNamespace {
+    constructor(openapi) {
+        this.openapi = openapi;
+    }
+    bucket(bucketIdOrSlug) {
+        return new RuntimeStorageBucketClient(this.openapi, bucketIdOrSlug);
+    }
+}
+exports.RuntimeStorageNamespace = RuntimeStorageNamespace;
+class RuntimeStorageBucketClient {
+    constructor(openapi, bucketIdOrSlug) {
+        this.openapi = openapi;
+        this.bucketIdOrSlug = bucketIdOrSlug;
+        this.anonymousUploads = new RuntimeAnonymousUploadsClient(openapi, bucketIdOrSlug);
+    }
+    async createUpload(input, options) {
+        const result = await this.openapi.POST(FILES_UPLOADS_PATH, {
+            body: input,
+            headers: (0, http_client_1.runtimeRequestHeaders)(options),
+            params: { path: { bucketRef: this.bucketIdOrSlug } },
+        });
+        return (0, http_client_1.unwrapRuntimeResult)(result, 'Failed to create file upload');
+    }
+    async completeUpload(uploadId, options) {
+        const result = await this.openapi.POST(FILES_UPLOAD_COMPLETE_PATH, {
+            headers: (0, http_client_1.runtimeRequestHeaders)(options),
+            params: { path: { bucketRef: this.bucketIdOrSlug, uploadId } },
+        });
+        return (0, http_client_1.unwrapRuntimeResult)(result, 'Failed to complete file upload');
+    }
+    async get(fileId, options) {
+        const result = await this.openapi.GET(FILES_OBJECT_PATH, {
+            headers: (0, http_client_1.runtimeRequestHeaders)(options),
+            params: { path: { bucketRef: this.bucketIdOrSlug, fileId } },
+        });
+        return (0, http_client_1.unwrapRuntimeResult)(result, 'Failed to load file status');
+    }
+    async createDownloadUrl(fileId, options) {
+        const result = await this.openapi.POST(FILES_DOWNLOAD_PATH, {
+            headers: (0, http_client_1.runtimeRequestHeaders)(options),
+            params: { path: { bucketRef: this.bucketIdOrSlug, fileId } },
+        });
+        return (0, http_client_1.unwrapRuntimeResult)(result, 'Failed to create file download URL');
+    }
+    async delete(fileId, options) {
+        const result = await this.openapi.DELETE(FILES_OBJECT_PATH, {
+            headers: (0, http_client_1.runtimeRequestHeaders)(options),
+            params: { path: { bucketRef: this.bucketIdOrSlug, fileId } },
+        });
+        return (0, http_client_1.unwrapRuntimeResult)(result, 'Failed to delete file');
+    }
+}
+exports.RuntimeStorageBucketClient = RuntimeStorageBucketClient;
+class RuntimeAnonymousUploadsClient {
+    constructor(openapi, bucketIdOrSlug) {
+        this.openapi = openapi;
+        this.bucketIdOrSlug = bucketIdOrSlug;
+    }
+    async claim(input, options) {
+        const result = await this.openapi.POST(FILES_ANONYMOUS_CLAIM_PATH, {
+            body: input,
+            headers: (0, http_client_1.runtimeRequestHeaders)(options),
+            params: {
+                path: { bucketRef: this.bucketIdOrSlug },
+            },
+        });
+        return (0, http_client_1.unwrapRuntimeResult)(result, 'Failed to claim anonymous uploads');
+    }
+}
+exports.RuntimeAnonymousUploadsClient = RuntimeAnonymousUploadsClient;
 class RuntimeDataTableClient {
     constructor(openapi, tableName) {
         this.tableName = tableName;
@@ -155,6 +241,24 @@ class RuntimeDataRecordsClient {
         });
         return (0, http_client_1.unwrapRuntimeResult)(result, 'Failed to list data records');
     }
+    async query(input = {}, options) {
+        const result = await this.openapi.POST(DATA_QUERY_PATH, {
+            body: input,
+            headers: (0, http_client_1.runtimeRequestHeaders)(options),
+            params: { path: { tableName: this.tableName } },
+        });
+        return (0, http_client_1.unwrapRuntimeResult)(result, 'Failed to query data records');
+    }
+    async aggregate(input, options) {
+        const result = await this.openapi.POST(DATA_AGGREGATE_PATH, {
+            body: input,
+            headers: (0, http_client_1.runtimeRequestHeaders)(options),
+            params: {
+                path: { tableName: this.tableName },
+            },
+        });
+        return (0, http_client_1.unwrapRuntimeResult)(result, 'Failed to aggregate data records');
+    }
     async create(input, options) {
         const result = await this.openapi.POST(DATA_RECORDS_PATH, {
             body: normalizeCreateRecordInput(input),

package/src/lib/types.d.ts

@@ -39,6 +39,72 @@ export interface RuntimeRequestOptions {
     actor?: RuntimeActorMetadata | null;
     headers?: Record<string, string>;
 }
+export interface RuntimeAnonymousClaimInput {
+    token: string;
+    externalRef: string;
+    idempotencyKey: string;
+}
+export interface RuntimeAnonymousClaimFileHandle {
+    fileId: string;
+    status: 'ready' | 'processing';
+}
+export interface RuntimeAnonymousClaimResult {
+    sessionId: string;
+    bucketId: string;
+    externalRef: string;
+    claimedAt: string;
+    files: RuntimeAnonymousClaimFileHandle[];
+}
+export type RuntimeFileAccessMode = 'private' | 'authenticated' | 'team' | 'public';
+export type RuntimeFileObjectStatus = 'pending_upload' | 'uploaded' | 'scanning' | 'ready' | 'verified_unclaimed' | 'claimed_ready' | 'deleting' | 'deleted' | 'rejected' | 'quarantined' | 'expired';
+export interface RuntimeCreateFileUploadInput {
+    fileName: string;
+    contentType: string;
+    size: number;
+    checksumSha256: string;
+    access?: RuntimeFileAccessMode;
+    idempotencyKey: string;
+}
+export interface RuntimeFileUploadGrant {
+    id: string;
+    fileId: string;
+    bucketId: string;
+    status: 'issued' | 'uploaded' | 'verifying' | 'completed' | 'rejected' | 'expired';
+    expectedSizeBytes: number;
+    expiresAt: string;
+    completedAt: string | null;
+    uploadUrl: string;
+    uploadUrlExpiresAt: string;
+    requiredHeaders: Readonly<Record<string, string>>;
+}
+export interface RuntimeFileObject {
+    id: string;
+    bucketId: string;
+    projectId: string;
+    environment: string;
+    originalName: string;
+    detectedMime: string | null;
+    sizeBytes: number | null;
+    checksumSha256: string | null;
+    status: RuntimeFileObjectStatus;
+    access: RuntimeFileAccessMode;
+    readyAt: string | null;
+    deletedAt: string | null;
+    billableUntil: string | null;
+    physicalDeleteDueAt: string | null;
+    physicalDeletedAt: string | null;
+    expiresAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface RuntimeFileUploadCompletion {
+    upload: Omit<RuntimeFileUploadGrant, 'uploadUrl' | 'uploadUrlExpiresAt' | 'requiredHeaders'>;
+    file: RuntimeFileObject;
+}
+export interface RuntimeFileDownloadUrl {
+    url: string;
+    expiresAt: string;
+}
 export type RuntimeHeaderValue = string | string[] | undefined;
 export interface RuntimeAppAuthRequestLike {
     headers?: Headers | Record<string, RuntimeHeaderValue> | {
@@ -92,6 +158,45 @@ export interface RuntimeListRecordsOptions {
     q?: string;
     sort?: string;
 }
+export type RuntimeAggregateOperation = 'count' | 'sum' | 'avg' | 'min' | 'max';
+export interface RuntimeQueryRecordsInput extends RuntimeListRecordsOptions {
+    /** Technical names; id is always included. Omit to read all fields. */
+    fields?: string[];
+}
+export interface RuntimeBatchQueryItem {
+    tableName: string;
+    query: RuntimeQueryRecordsInput;
+}
+export interface RuntimeBatchQueryResult {
+    /** Independent pages, in request order; no shared transactional snapshot. */
+    results: RuntimeRecordsList[];
+}
+export interface RuntimeAggregateMetric {
+    operation: RuntimeAggregateOperation;
+    field?: string;
+    as: string;
+}
+export interface RuntimeAggregateOrderBy {
+    by: string;
+    direction: 'asc' | 'desc';
+}
+export interface RuntimeAggregateRecordsInput {
+    filter?: Record<string, unknown>;
+    q?: string;
+    groupBy?: string[];
+    metrics: RuntimeAggregateMetric[];
+    orderBy?: RuntimeAggregateOrderBy[];
+    limit?: number;
+}
+export interface RuntimeAggregateRow {
+    dimensions: Record<string, RuntimeScalar>;
+    metrics: Record<string, string | number | null>;
+}
+export interface RuntimeAggregateRecordsResult {
+    rows: RuntimeAggregateRow[];
+    limit: number;
+    hasMore: boolean;
+}
 export interface RuntimeListWindowOptions {
     cursor?: string;
     limit?: number;