@vibesdotdev/storage 0.0.1 → 1.0.0-rc.3

package/dist/adapters/cloud-api/cloud-api.fetch-client.js

@@ -0,0 +1,357 @@
+import {} from "../../schemas/cloud-api.js";
+export { CloudEndpointConfigSchema } from "../../schemas/cloud-api.js";
+/**
+ * Cloud API fetch transport.
+ *
+ * Every request goes to the store's resolved origin (`apiEndpoint`) plus a
+ * per-namespace API path through the active runtime's `fetch`, bounded by the
+ * configured timeout combined with (never replacing) the caller's signal.
+ *
+ * Every failure is a `CapabilityError` with a fixed, value-free message; the
+ * original failure travels as `cause`. No reason phrase, response body, URL
+ * query or credential reaches a message or a detail:
+ *
+ * - the transport failed (refused, DNS, reset): UNAVAILABLE `cloud-api-unreachable`
+ * - the request's bound elapsed: TIMEOUT `cloud-api-timeout`
+ * - the caller's signal aborted: CANCELLED `cloud-api-cancelled`
+ * - a non-success status: `cloud-api-status`, coded by the status, with
+ *   `details.status`; a 404 is NOT_FOUND naming the requested resource
+ *   (`details.kind`/`details.id`), the only failure a reader may take as absence
+ * - a body that is not JSON: INTERNAL `cloud-api-body-invalid`
+ */
+import { CapabilityError, CaughtFailureSchema } from '@vibesdotdev/kernel';
+import { JsonValueSchema, isJsonObject } from '@vibesdotdev/kernel/schemas/json';
+import * as z from 'zod/v4';
+/** The `details.kind` of a 404: `details.id` is the requested resource path (its query withheld). */
+export const CLOUD_API_RESOURCE_KIND = 'storage/cloud-api-resource';
+const DEFAULT_TIMEOUT_MS = 30_000;
+/** The resource a path names, its query withheld (a query may carry a credential). */
+export function cloudApiResourceOf(path) {
+    const query = path.indexOf('?');
+    return query === -1 ? path : path.slice(0, query);
+}
+/**
+ * The API path for `namespace`: its manifest's declared endpoint, else the
+ * generic storage API.
+ */
+function resolveEndpoint(namespace, endpoint) {
+    return endpoint ? endpoint.endpoint : `/api/storage/${encodeURIComponent(namespace)}`;
+}
+/** The item path under a collection path. */
+function itemPath(collectionPath, id) {
+    return `${collectionPath.replace(/\/$/, '')}/${encodeURIComponent(id)}`;
+}
+/** The capability code a non-success HTTP status reports as. */
+function statusCode(status) {
+    switch (status) {
+        case 400:
+        case 422:
+            return 'INVALID_INPUT';
+        case 401:
+            return 'AUTH_REQUIRED';
+        case 403:
+            return 'PERMISSION_DENIED';
+        case 404:
+            return 'NOT_FOUND';
+        case 408:
+            return 'TIMEOUT';
+        case 409:
+        case 412:
+            return 'CONFLICT';
+        case 429:
+            return 'RATE_LIMITED';
+        default:
+            return 'UNAVAILABLE';
+    }
+}
+/** A non-success status, by its status only: the reason phrase and body are never read. */
+function statusFailure(status, path) {
+    const code = statusCode(status);
+    const resource = cloudApiResourceOf(path);
+    return new CapabilityError('The cloud API answered with a non-success status.', code, {
+        reason: 'cloud-api-status',
+        retryable: status >= 500 || status === 408 || status === 429,
+        details: code === 'NOT_FOUND' ? { status, kind: CLOUD_API_RESOURCE_KIND, id: resource } : { status, path: resource }
+    });
+}
+/** The request's own time bound elapsed. */
+function timeoutFailure(path, cause) {
+    return new CapabilityError('The cloud API request exceeded its time bound.', 'TIMEOUT', {
+        reason: 'cloud-api-timeout',
+        retryable: true,
+        details: { path: cloudApiResourceOf(path) },
+        cause
+    });
+}
+/** The caller's signal aborted the request. */
+function cancelledFailure(path, cause) {
+    return new CapabilityError('The cloud API request was cancelled by its caller.', 'CANCELLED', {
+        reason: 'cloud-api-cancelled',
+        retryable: false,
+        details: { path: cloudApiResourceOf(path) },
+        cause
+    });
+}
+/** The transport failed (refused, DNS, reset) before an answer arrived. */
+function unreachableFailure(path, cause) {
+    return new CapabilityError('The cloud API could not be reached.', 'UNAVAILABLE', {
+        reason: 'cloud-api-unreachable',
+        retryable: true,
+        details: { path: cloudApiResourceOf(path) },
+        cause
+    });
+}
+/** A response body that is not JSON (an HTML error page, a truncated payload). */
+function bodyInvalid(path, cause) {
+    return new CapabilityError('The cloud API answered with a body that is not JSON.', 'INTERNAL', {
+        reason: 'cloud-api-body-invalid',
+        retryable: false,
+        details: { path: cloudApiResourceOf(path) },
+        cause
+    });
+}
+/** A JSON body whose shape no document reading accepts (a bare scalar or null). */
+function documentBodyUnsupported(path) {
+    return new CapabilityError('The cloud API answered with a document body of an unsupported shape.', 'INTERNAL', {
+        reason: 'cloud-api-body-invalid',
+        retryable: false,
+        details: { path: cloudApiResourceOf(path) }
+    });
+}
+/** The body text parsed: JSON.parse output is JSON by construction, and the schema types it. */
+function parseJsonBody(path, text) {
+    try {
+        return JsonValueSchema.parse(JSON.parse(text));
+    }
+    catch (thrown) {
+        throw bodyInvalid(path, thrown);
+    }
+}
+/**
+ * An items collection keyed by `idField`. An item without a string id is
+ * skipped: one remote row cannot be keyed, the rest still are.
+ */
+function keyedCollection(items, idField = 'id') {
+    const keyed = {};
+    for (const item of items) {
+        if (item === null || !isJsonObject(item))
+            continue;
+        const id = z.string().safeParse(item[idField]);
+        if (id.success)
+            keyed[id.data] = item;
+    }
+    return keyed;
+}
+/**
+ * Create the fetch transport for one resolved origin. `resolveApiToken` is
+ * asked for the bearer on every request (an explicit token, the host's service
+ * token, or the caller's login), so a refreshed login is presented at once.
+ */
+export function createFetchClient(runtime, connection, resolveApiToken, request) {
+    const timeout = connection.timeout ?? DEFAULT_TIMEOUT_MS;
+    const endpoints = new Map();
+    /** The kernel owns the deadline and cancellation through token lookup, headers and body. */
+    const withRequest = async (path, options, read) => {
+        try {
+            return await runtime.lifecycle.wait(async (signal) => {
+                const headers = new Headers(options.headers);
+                if (!headers.has('content-type'))
+                    headers.set('Content-Type', 'application/json');
+                const apiToken = (await resolveApiToken())?.trim();
+                if (apiToken)
+                    headers.set('Authorization', `Bearer ${apiToken}`);
+                signal.throwIfAborted();
+                let response;
+                try {
+                    response = await request(`${connection.apiEndpoint}${path}`, { ...options, headers, signal });
+                }
+                catch (thrown) {
+                    signal.throwIfAborted();
+                    throw unreachableFailure(path, thrown);
+                }
+                if (!response.ok) {
+                    try {
+                        await response.body?.cancel();
+                    }
+                    catch (thrown) {
+                        signal.throwIfAborted();
+                        throw unreachableFailure(path, thrown);
+                    }
+                    throw statusFailure(response.status, path);
+                }
+                return read(response, signal);
+            }, {
+                timeoutMs: timeout,
+                signal: options.signal ?? undefined,
+                reason: 'storage-cloud-api-request'
+            });
+        }
+        catch (thrown) {
+            const failure = CaughtFailureSchema.parse(thrown);
+            if (failure instanceof CapabilityError && failure.reason === 'wait-timeout') {
+                throw timeoutFailure(path, thrown);
+            }
+            if (runtime.lifecycle.signal.aborted || options.signal?.aborted ||
+                (failure instanceof CapabilityError && failure.reason === 'wait-aborted')) {
+                throw cancelledFailure(path, thrown);
+            }
+            throw thrown;
+        }
+    };
+    /** A successful mutation needs no response body; release its stream before returning. */
+    const send = (path, options = {}) => withRequest(path, options, async (response, signal) => {
+        try {
+            await response.body?.cancel();
+        }
+        catch (thrown) {
+            signal.throwIfAborted();
+            throw unreachableFailure(path, thrown);
+        }
+    });
+    /** The JSON body of one request; a 204 answers null. */
+    const requestJson = (path, options = {}) => withRequest(path, options, async (response, signal) => {
+        if (response.status === 204)
+            return null;
+        let text;
+        try {
+            text = await response.text();
+        }
+        catch (thrown) {
+            signal.throwIfAborted();
+            throw unreachableFailure(path, thrown);
+        }
+        return parseJsonBody(path, text);
+    });
+    /** The document at `path`; a 404 for exactly that resource is absence, anything else propagates. */
+    const readDocument = async (path, signal) => {
+        try {
+            return await requestJson(path, signal ? { signal } : {});
+        }
+        catch (thrown) {
+            const failure = CaughtFailureSchema.parse(thrown);
+            if (CapabilityError.isAbsenceOf(failure, CLOUD_API_RESOURCE_KIND, cloudApiResourceOf(path)))
+                return null;
+            throw failure;
+        }
+    };
+    /**
+     * The canonical wire shapes (see `@vibesdotdev/kit/server/crud`), read as
+     * the namespace's manifest declares:
+     * - `{ results: T[] }`, a collection: a records manifest without a
+     *   collection field receives the array, a document manifest a keyed record;
+     * - `{ result: T }`, an item, and `{ value: T }`, the legacy storage-sync
+     *   shape, unwrapped (a null item is absence);
+     * - an array body is the document itself; a bare scalar or null is refused.
+     */
+    const documentOf = (path, body, endpoint) => {
+        if (body === null)
+            return null;
+        if (Array.isArray(body))
+            return body;
+        if (!isJsonObject(body))
+            throw documentBodyUnsupported(path);
+        const records = endpoint?.dataType === 'records';
+        const collectionField = endpoint?.collectionField;
+        const results = body.results;
+        if (Array.isArray(results)) {
+            if (records && collectionField)
+                return { [collectionField]: keyedCollection(results, endpoint.idField) };
+            if (records)
+                return results;
+            return keyedCollection(results, endpoint?.idField);
+        }
+        if (records && collectionField) {
+            const collection = body[collectionField];
+            if (Array.isArray(collection))
+                return { [collectionField]: keyedCollection(collection, endpoint.idField) };
+            if (collection !== undefined && collection !== null && isJsonObject(collection))
+                return { [collectionField]: collection };
+        }
+        if (Object.hasOwn(body, 'result'))
+            return body.result ?? null;
+        if (Object.hasOwn(body, 'value'))
+            return body.value ?? null;
+        return body;
+    };
+    /** The remote collection of a records namespace, keyed by its id field. */
+    const remoteCollection = (path, document, endpoint) => {
+        if (document === null)
+            return {};
+        if (Array.isArray(document))
+            return keyedCollection(document, endpoint?.idField);
+        if (!isJsonObject(document))
+            throw documentBodyUnsupported(path);
+        const collectionField = endpoint?.collectionField;
+        const collection = collectionField ? document[collectionField] : undefined;
+        if (collection !== undefined && collection !== null && isJsonObject(collection))
+            return collection;
+        return document;
+    };
+    return {
+        registerEndpoint(namespace, endpoint) {
+            endpoints.set(namespace, { endpoint });
+        },
+        registerEndpointConfig(namespace, config) {
+            endpoints.set(namespace, config);
+        },
+        request(path, options = {}) {
+            return requestJson(path, options);
+        },
+        async get(namespace, options) {
+            const endpoint = endpoints.get(namespace);
+            const path = resolveEndpoint(namespace, endpoint);
+            return documentOf(path, await readDocument(path, options?.signal), endpoint);
+        },
+        async set(namespace, data) {
+            const endpoint = endpoints.get(namespace);
+            const raw = endpoint?.dataType === 'objects' || endpoint?.dataType === 'raw';
+            await send(resolveEndpoint(namespace, endpoint), {
+                method: 'PUT',
+                body: JSON.stringify(raw ? data : { value: data })
+            });
+        },
+        async reconcile(namespace, items) {
+            const endpoint = endpoints.get(namespace);
+            const collectionPath = resolveEndpoint(namespace, endpoint);
+            // 1. The current remote collection.
+            const current = remoteCollection(collectionPath, documentOf(collectionPath, await readDocument(collectionPath), endpoint), endpoint);
+            const currentIds = new Set(Object.keys(current));
+            // 2. New items: POST the raw body to the collection endpoint.
+            for (const [id, item] of Object.entries(items)) {
+                if (currentIds.has(id))
+                    continue;
+                await send(collectionPath, { method: 'POST', body: JSON.stringify(item) });
+            }
+            // 3. Changed items: PATCH the raw body to the item endpoint.
+            for (const [id, item] of Object.entries(items)) {
+                if (!currentIds.has(id) || JSON.stringify(current[id]) === JSON.stringify(item))
+                    continue;
+                await send(itemPath(collectionPath, id), { method: 'PATCH', body: JSON.stringify(item) });
+            }
+            // 4. Removed items: DELETE the item endpoint.
+            for (const id of currentIds) {
+                if (Object.hasOwn(items, id))
+                    continue;
+                await send(itemPath(collectionPath, id), { method: 'DELETE' });
+            }
+        },
+        async delete(namespace) {
+            await send(resolveEndpoint(namespace, endpoints.get(namespace)), { method: 'DELETE' });
+        },
+        async exists(namespace) {
+            const path = resolveEndpoint(namespace, endpoints.get(namespace));
+            try {
+                await send(path, { method: 'HEAD' });
+                return true;
+            }
+            catch (thrown) {
+                const failure = CaughtFailureSchema.parse(thrown);
+                // Only a 404 for this resource answers "does not exist"; any other failure is not absence.
+                if (CapabilityError.isAbsenceOf(failure, CLOUD_API_RESOURCE_KIND, cloudApiResourceOf(path)))
+                    return false;
+                throw failure;
+            }
+        }
+    };
+}
+//# sourceMappingURL=cloud-api.fetch-client.js.map

package/dist/adapters/cloud-api/cloud-api.fetch-client.js.map

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

package/dist/adapters/cloud-api/cloud-api.record.d.ts

@@ -0,0 +1,85 @@
+import { z } from 'zod/v4';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { type JsonValue } from '@vibesdotdev/kernel/schemas/json';
+import type { StorageRecordDescriptor } from '@vibesdotdev/storage/schemas/record';
+import type { StorageRelation } from '@vibesdotdev/storage/schemas/record/relation';
+import type { CreateInput, CreateManyOptions, DeleteOptions, DeleteResult, QueryOptions, QueryResult, SearchOptions, SearchResult, StorageRecordInterface, StreamOptions, UpdateInput, UpdateOptions, UpdateResult, WhereFilter } from '@vibesdotdev/storage/interfaces/record';
+import { type RecordRevisionAccess } from '../../schemas/record/revision.ts';
+/** What a cloud record sends its requests through. */
+export interface CloudRecordClient {
+    request(path: string, options?: RequestInit): Promise<JsonValue | null>;
+}
+/** One batched operation: what to do, with which data, on which id. */
+export interface CloudRecordBatchOperation<Data> {
+    readonly type: 'create' | 'update' | 'delete';
+    readonly data?: Data;
+    readonly id?: string;
+}
+export declare class CloudAPIStorageRecord<T = unknown> implements StorageRecordInterface<T> {
+    private descriptor;
+    private client;
+    private runtime?;
+    readonly tableName: string;
+    readonly primaryKey: string;
+    readonly schema: z.ZodType<T>;
+    readonly relations: Record<string, StorageRelation>;
+    readonly supportsConditionalWrites = false;
+    get revisions(): RecordRevisionAccess<T> | undefined;
+    private revisionRequest;
+    /**
+     * `runtime` is the one this record's targets resolve on for `include`
+     * (`storage/record` by id); a record built without one refuses a
+     * non-empty include `UNAVAILABLE`.
+     */
+    constructor(descriptor: StorageRecordDescriptor, client: CloudRecordClient, runtime?: RuntimeRef | undefined);
+    create(data: CreateInput<T>): Promise<T>;
+    /** Create from checked fields: the descriptor's id, timestamps and hook applied, then the schema's parse sent. */
+    private createFields;
+    createMany(data: CreateInput<T>[], _options?: CreateManyOptions): Promise<T[]>;
+    get(id: string, options?: Pick<QueryOptions<T>, 'include'>): Promise<T | null>;
+    getOrThrow(id: string, options?: Pick<QueryOptions<T>, 'include'>): Promise<T>;
+    getMany(ids: string[], options?: Pick<QueryOptions<T>, 'include'>): Promise<T[]>;
+    list(options?: QueryOptions<T>): Promise<QueryResult<T>>;
+    findFirst(options?: QueryOptions<T>): Promise<T | null>;
+    findFirstOrThrow(options?: QueryOptions<T>): Promise<T>;
+    exists(id: string): Promise<boolean>;
+    count(where?: WhereFilter<T>): Promise<number>;
+    search(_query: string, _options?: SearchOptions<T>): Promise<SearchResult<T>>;
+    getDescendants(): Promise<QueryResult<T & {
+        depth: number;
+        path?: string[];
+    }>>;
+    getAncestors(): Promise<T[]>;
+    getTree(): Promise<[]>;
+    update(id: string, data: UpdateInput<T>, options?: UpdateOptions): Promise<T>;
+    /** Update from checked changes: merged over the live row, hooked, stamped, and the schema's parse sent. */
+    private updateFields;
+    updateMany(where: WhereFilter<T>, data: UpdateInput<T>, options?: UpdateOptions): Promise<UpdateResult>;
+    upsert(id: string, create: CreateInput<T>, update: UpdateInput<T>): Promise<T>;
+    delete(id: string, options?: DeleteOptions): Promise<DeleteResult>;
+    deleteMany(where: WhereFilter<T>, options?: DeleteOptions): Promise<DeleteResult>;
+    restore(id: string): Promise<T>;
+    aggregate(): Promise<[]>;
+    transaction(): Promise<never>;
+    stream(options?: StreamOptions<T>): AsyncIterable<T>;
+    batch<Data>(operations: Array<CloudRecordBatchOperation<Data>>): Promise<Array<T | DeleteResult>>;
+    raw(): Promise<[]>;
+    queryRaw(): Promise<[]>;
+    validate<Candidate>(data: Candidate): Promise<{
+        success: boolean;
+        data?: T;
+        errors?: z.ZodError;
+    }>;
+    initialize(): Promise<void>;
+    getAdapterId(): string;
+    close(): Promise<void>;
+    private allMatches;
+    /** What relation loading reads of this record: its kind, primary key, declared relations and runtime. */
+    private get relationOwner();
+    private get config();
+    private entityPath;
+    private listPath;
+    private softDeleteField;
+    private requireId;
+}
+//# sourceMappingURL=cloud-api.record.d.ts.map

package/dist/adapters/cloud-api/cloud-api.record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-api.record.d.ts","sourceRoot":"","sources":["../../../src/adapters/cloud-api/cloud-api.record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAwC,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,KAAK,EACX,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,MAAM,wCAAwC,CAAC;AAehD,OAAO,EAEN,KAAK,oBAAoB,EACzB,MAAM,kCAAkC,CAAC;AAW1C,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IACjC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;CACxE;AAED,uEAAuE;AACvE,MAAM,WAAW,yBAAyB,CAAC,IAAI;IAC9C,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACrB;AAuBD,qBAAa,qBAAqB,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,sBAAsB,CAAC,CAAC,CAAC;IAkClF,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO,CAAC;IAnCjB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACpD,QAAQ,CAAC,yBAAyB,SAAS;IAE3C,IAAI,SAAS,IAAI,oBAAoB,CAAC,CAAC,CAAC,GAAG,SAAS,CAOnD;YAEa,eAAe;IAY7B;;;;OAIG;gBAEM,UAAU,EAAE,uBAAuB,EACnC,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,UAAU,YAAA;IASvB,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI9C,kHAAkH;YACpG,YAAY;IAS1B,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAIxE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAe9E,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAY9E,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAQhF,IAAI,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IA0B9D,SAAS,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAIjD,gBAAgB,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAY7D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAGpC,KAAK,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAS9C,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAG7E,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAG9E,YAAY,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAG5B,OAAO,IAAI,OAAO,CAAC,EAAE,CAAC;IAIhB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAKnF,2GAA2G;YAC7F,YAAY;IASpB,UAAU,CACf,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EACrB,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC;IAQlB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAK9E,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAkBlE,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAQvF,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAK/B,SAAS,IAAI,OAAO,CAAC,EAAE,CAAC;IAGxB,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC;IAGtB,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC;IAG3D,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC;IA0BjG,GAAG,IAAI,OAAO,CAAC,EAAE,CAAC;IAGlB,QAAQ,IAAI,OAAO,CAAC,EAAE,CAAC;IAGvB,QAAQ,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAA;KAAE,CAAC;IAQ5F,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAGjC,YAAY,IAAI,MAAM;IAGtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAIR,UAAU;IAiBxB,yGAAyG;IACzG,OAAO,KAAK,aAAa,GAExB;IACD,OAAO,KAAK,MAAM,GAEjB;IACD,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,SAAS;CAWjB"}

package/dist/adapters/cloud-api/cloud-api.record.helpers.d.ts

@@ -0,0 +1,71 @@
+import { type RecordFields } from '../../schemas/cloud-api.ts';
+export { RecordFieldsSchema, type RecordFields } from '../../schemas/cloud-api.ts';
+import { z } from 'zod/v4';
+import { type JsonValue } from '@vibesdotdev/kernel/schemas/json';
+import type { StorageRecordDescriptor } from '@vibesdotdev/storage/schemas/record';
+import type { DeleteOptions, QueryOptions, UpdateOptions, WhereFilter } from '@vibesdotdev/storage/interfaces/record';
+/** One operand schema per RecordFilterOperatorSchema option; `satisfies` keeps the key set in step with it. */
+export declare const cloudRecordConditionSchema: z.ZodObject<{
+    eq: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodDate]>>;
+    ne: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodDate]>>;
+    gt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodDate]>>;
+    gte: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodDate]>>;
+    lt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodDate]>>;
+    lte: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodDate]>>;
+    in: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodDate]>>>;
+    notIn: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodDate]>>>;
+    between: z.ZodOptional<z.ZodTuple<[z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodDate]>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodDate]>], null>>;
+    contains: z.ZodOptional<z.ZodString>;
+    startsWith: z.ZodOptional<z.ZodString>;
+    endsWith: z.ZodOptional<z.ZodString>;
+    isNull: z.ZodOptional<z.ZodBoolean>;
+    isNotNull: z.ZodOptional<z.ZodBoolean>;
+    like: z.ZodOptional<z.ZodString>;
+    ilike: z.ZodOptional<z.ZodString>;
+    hasNot: z.ZodOptional<z.ZodString>;
+    hasAll: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+declare const filtersSchema: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodDate]>, z.ZodObject<{
+    eq: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodDate]>>;
+    ne: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodDate]>>;
+    gt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodDate]>>;
+    gte: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodDate]>>;
+    lt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodDate]>>;
+    lte: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodDate]>>;
+    in: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodDate]>>>;
+    notIn: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodDate]>>>;
+    between: z.ZodOptional<z.ZodTuple<[z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodDate]>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodDate]>], null>>;
+    contains: z.ZodOptional<z.ZodString>;
+    startsWith: z.ZodOptional<z.ZodString>;
+    endsWith: z.ZodOptional<z.ZodString>;
+    isNull: z.ZodOptional<z.ZodBoolean>;
+    isNotNull: z.ZodOptional<z.ZodBoolean>;
+    like: z.ZodOptional<z.ZodString>;
+    ilike: z.ZodOptional<z.ZodString>;
+    hasNot: z.ZodOptional<z.ZodString>;
+    hasAll: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>]>>;
+type Filters = z.infer<typeof filtersSchema>;
+/** The fields of a record value (a caller's input, a stored row): refused typed when it is not a field map. */
+export declare function recordFieldsOf<Value>(value: Value, descriptor: StorageRecordDescriptor): RecordFields;
+export declare function unsupported(name: string): never;
+export declare function prepareCreateRecord<T>(descriptor: StorageRecordDescriptor, primaryKey: string, schema: z.ZodType<T>, fields: RecordFields): Promise<RecordFields>;
+export declare function prepareUpdatedRecord<T>(descriptor: StorageRecordDescriptor, schema: z.ZodType<T>, existing: T, changes: RecordFields): Promise<RecordFields>;
+/**
+ * A record carries its declared primary key. Otherwise the response may carry
+ * a standard record envelope. Select that wire payload before applying the
+ * owner schema: a schema transform can throw a typed refusal.
+ */
+export declare function parseRecord<T>(descriptor: StorageRecordDescriptor, schema: z.ZodType<T>, response: JsonValue | null, fallback?: RecordFields): T;
+/**
+ * The items of a list response: the array itself, or the array under the
+ * declared list field, `results`, `items`, `data` or `value`. No content is an
+ * empty list; any other body is a malformed answer, refused rather than read
+ * as empty.
+ */
+export declare function extractList(response: JsonValue | null, descriptor: StorageRecordDescriptor, listField?: string): JsonValue[];
+export declare function applyOptions<T>(items: T[], descriptor: StorageRecordDescriptor, options?: QueryOptions<T>): T[];
+export declare function assertSupportedFilters<T>(where?: WhereFilter<T>): Filters | undefined;
+export declare function assertSupportedUpdateOptions(options?: UpdateOptions): void;
+export declare function assertSupportedDeleteOptions(options?: DeleteOptions): void;
+//# sourceMappingURL=cloud-api.record.helpers.d.ts.map

package/dist/adapters/cloud-api/cloud-api.record.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-api.record.helpers.d.ts","sourceRoot":"","sources":["../../../src/adapters/cloud-api/cloud-api.record.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAGnF,OAAO,KAAK,EACX,aAAa,EAEb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,MAAM,wCAAwC,CAAC;AAMhD,+GAA+G;AAC/G,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;kBAUa,CAAC;AAErD,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;qBAAiE,CAAC;AAIrF,KAAK,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAW7C,+GAA+G;AAC/G,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,uBAAuB,GAAG,YAAY,CAOrG;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAM/C;AAkBD,wBAAsB,mBAAmB,CAAC,CAAC,EAC1C,UAAU,EAAE,uBAAuB,EACnC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,EAAE,YAAY,GAClB,OAAO,CAAC,YAAY,CAAC,CAOvB;AAED,wBAAsB,oBAAoB,CAAC,CAAC,EAC3C,UAAU,EAAE,uBAAuB,EACnC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,YAAY,GACnB,OAAO,CAAC,YAAY,CAAC,CAMvB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC5B,UAAU,EAAE,uBAAuB,EACnC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,QAAQ,EAAE,SAAS,GAAG,IAAI,EAC1B,QAAQ,CAAC,EAAE,YAAY,GACrB,CAAC,CAkBH;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,EAAE,UAAU,EAAE,uBAAuB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAkB5H;AAED,wBAAgB,YAAY,CAAC,CAAC,EAC7B,KAAK,EAAE,CAAC,EAAE,EACV,UAAU,EAAE,uBAAuB,EACnC,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,CAAC,EAAE,CAoBL;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,SAAS,CAiBrF;AA2BD,wBAAgB,4BAA4B,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAW1E;AAED,wBAAgB,4BAA4B,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAS1E"}