@vibesdotdev/storage 0.0.2 → 1.0.0-rc.4

package/dist/adapters/cloud-api/cloud-api.record.helpers.js

@@ -0,0 +1,270 @@
+import { RecordFieldsSchema } from "../../schemas/cloud-api.js";
+export { RecordFieldsSchema } from "../../schemas/cloud-api.js";
+import { z } from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { isJsonObject } from '@vibesdotdev/kernel/schemas/json';
+import { applyCreateTimestamps, applyUpdateTimestamp } from '@vibesdotdev/storage/record/base';
+import { unsupportedArrayOperation } from "../../record/array-fields.js";
+import { parseAdapterInput } from "../parse-adapter-input.js";
+const scalarSchema = z.union([z.string(), z.number(), z.boolean(), z.null(), z.date()]);
+const orderedScalarSchema = z.union([z.string(), z.number(), z.date()]);
+/** One operand schema per RecordFilterOperatorSchema option; `satisfies` keeps the key set in step with it. */
+export const cloudRecordConditionSchema = z.strictObject({
+    eq: scalarSchema.optional(), ne: scalarSchema.optional(),
+    gt: orderedScalarSchema.optional(), gte: orderedScalarSchema.optional(),
+    lt: orderedScalarSchema.optional(), lte: orderedScalarSchema.optional(),
+    in: z.array(scalarSchema).optional(), notIn: z.array(scalarSchema).optional(),
+    between: z.tuple([orderedScalarSchema, orderedScalarSchema]).optional(),
+    contains: z.string().optional(), startsWith: z.string().optional(), endsWith: z.string().optional(),
+    isNull: z.boolean().optional(), isNotNull: z.boolean().optional(),
+    like: z.string().optional(), ilike: z.string().optional(), hasNot: z.string().optional(),
+    hasAll: z.array(z.string()).optional()
+});
+const conditionSchema = cloudRecordConditionSchema;
+const filtersSchema = z.record(z.string(), z.union([scalarSchema, conditionSchema]));
+const optionsSchema = z.record(z.string(), z.unknown());
+const orderedPairSchema = z.union([z.tuple([z.string(), z.string()]), z.tuple([z.number(), z.number()])]);
+const SortDirectionSchema = z.enum(['asc', 'desc']);
+const HookFunctionSchema = z.function();
+const RecordWriteHookSchema = z.custom((value) => HookFunctionSchema.safeParse(value).success);
+/** The fields of a record value (a caller's input, a stored row): refused typed when it is not a field map. */
+export function recordFieldsOf(value, descriptor) {
+    return parseAdapterInput(RecordFieldsSchema, value, {
+        message: 'A cloud record value must be a field map.',
+        code: 'INVALID_INPUT',
+        reason: 'record-cloud-value-invalid',
+        details: { recordId: descriptor.id }
+    });
+}
+export function unsupported(name) {
+    throw new CapabilityError(`Cloud API record adapter does not support ${name}.`, 'UNAVAILABLE', {
+        reason: 'record-cloud-operation-unsupported',
+        retryable: false,
+        details: { operation: name }
+    });
+}
+/** The field a generated id is written to: the descriptor's `autoId.field`, else the primary key. */
+function autoIdField(autoId, primaryKey) {
+    if (autoId === undefined || autoId === true || autoId === false)
+        return primaryKey;
+    return autoId.field || primaryKey;
+}
+/** The descriptor's hook, parsed: absent, or a function. */
+function hookOf(hook, name, descriptor) {
+    return parseAdapterInput(RecordWriteHookSchema.optional(), hook, {
+        message: 'A record descriptor hook must be a function.',
+        code: 'INVALID_INPUT',
+        reason: 'record-hook-invalid',
+        details: { recordId: descriptor.id, hook: name }
+    });
+}
+export async function prepareCreateRecord(descriptor, primaryKey, schema, fields) {
+    const record = { ...fields };
+    const idField = autoIdField(descriptor.autoId, primaryKey);
+    if (descriptor.autoId && !record[idField])
+        record[idField] = crypto.randomUUID();
+    applyCreateTimestamps(record, descriptor.timestamps, new Date().toISOString());
+    await hookOf(descriptor.beforeCreate, 'beforeCreate', descriptor)?.(record);
+    return recordFieldsOf(schema.parse(record), descriptor);
+}
+export async function prepareUpdatedRecord(descriptor, schema, existing, changes) {
+    const current = recordFieldsOf(existing, descriptor);
+    const next = { ...current, ...changes };
+    await hookOf(descriptor.beforeUpdate, 'beforeUpdate', descriptor)?.(next);
+    applyUpdateTimestamp(current, next, descriptor.timestamps, new Date().toISOString());
+    return recordFieldsOf(schema.parse(next), descriptor);
+}
+/**
+ * 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 function parseRecord(descriptor, schema, response, fallback) {
+    let source = response ?? fallback;
+    if (response !== null && isJsonObject(response) && !Object.hasOwn(response, descriptor.primaryKey ?? 'id')) {
+        for (const field of ['result', 'item', 'data', 'value']) {
+            if (Object.hasOwn(response, field) && response[field] !== null) {
+                source = response[field];
+                break;
+            }
+        }
+    }
+    if (source === undefined) {
+        throw new CapabilityError('The cloud API returned no record payload.', 'INTERNAL', {
+            reason: 'record-cloud-payload-missing',
+            retryable: false,
+            details: { recordId: descriptor.id }
+        });
+    }
+    return schema.parse(source);
+}
+/**
+ * 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 function extractList(response, descriptor, listField) {
+    if (response === null)
+        return [];
+    if (Array.isArray(response))
+        return response;
+    const list = isJsonObject(response)
+        ? ((listField ? response[listField] : undefined) ??
+            response.results ??
+            response.items ??
+            response.data ??
+            response.value)
+        : undefined;
+    if (!Array.isArray(list)) {
+        throw new CapabilityError('The cloud API list response carries no item list.', 'INTERNAL', {
+            reason: 'record-cloud-list-invalid',
+            retryable: false,
+            details: { recordId: descriptor.id }
+        });
+    }
+    return list;
+}
+export function applyOptions(items, descriptor, options) {
+    const where = assertSupportedFilters(options?.where);
+    const softDeleteField = descriptor.softDelete
+        ? descriptor.softDelete === true ? 'deletedAt' : descriptor.softDelete
+        : null;
+    let next = items
+        .map((row) => ({ row, fields: recordFieldsOf(row, descriptor) }))
+        .filter(({ fields }) => matchesWhere(fields, where));
+    if (!options?.includeDeleted && softDeleteField) {
+        next = next.filter(({ fields }) => !fields[softDeleteField]);
+    }
+    const [field, direction] = sortEntry(options?.orderBy);
+    if (field) {
+        next.sort((a, b) => `${a.fields[field] ?? ''}`.localeCompare(`${b.fields[field] ?? ''}`) * (direction === 'desc' ? -1 : 1));
+    }
+    const offset = options?.offset ?? 0;
+    return next.slice(offset, offset + (options?.limit ?? next.length)).map(({ row }) => row);
+}
+export function assertSupportedFilters(where) {
+    if (where === undefined)
+        return undefined;
+    const parsed = filtersSchema.safeParse(where);
+    if (!parsed.success)
+        invalidFilter();
+    if (Object.keys(where).length !== Object.keys(parsed.data).length)
+        invalidFilter();
+    for (const expected of Object.values(parsed.data)) {
+        if (scalarSchema.safeParse(expected).success)
+            continue;
+        const condition = conditionSchema.parse(expected);
+        if (Object.keys(condition).length === 0 || Object.values(condition).some(value => value === undefined))
+            invalidFilter();
+        if (Object.hasOwn(condition, 'hasNot') || Object.hasOwn(condition, 'hasAll'))
+            unsupportedArrayOperation('storage.cloud-api');
+        if (Object.hasOwn(condition, 'like') || Object.hasOwn(condition, 'ilike')) {
+            throw new CapabilityError('Cloud API records do not support SQL pattern filters.', 'UNAVAILABLE', {
+                reason: 'record-cloud-filter-unsupported', retryable: false
+            });
+        }
+    }
+    return parsed.data;
+}
+function invalidFilter() {
+    throw new CapabilityError('Cloud API record filters must contain supported operators and valid scalar operands.', 'INVALID_INPUT', {
+        reason: 'record-cloud-filter-invalid', retryable: false
+    });
+}
+function writeOptions(options) {
+    const parsed = optionsSchema.safeParse(options === undefined ? {} : options);
+    if (!parsed.success) {
+        throw new CapabilityError('Cloud API record write options must be a field map.', 'INVALID_INPUT', {
+            reason: 'record-cloud-write-options-invalid', retryable: false
+        });
+    }
+    return parsed.data;
+}
+function assertUnconditionalWrite(where) {
+    const filters = assertSupportedFilters(where);
+    if (filters && Object.keys(filters).length > 0) {
+        throw new CapabilityError('Cloud API record CRUD does not declare atomic conditional writes.', 'UNAVAILABLE', {
+            reason: 'record-cloud-conditional-write-unsupported', retryable: false
+        });
+    }
+}
+export function assertSupportedUpdateOptions(options) {
+    const parsed = writeOptions(options);
+    assertUnconditionalWrite(options?.where);
+    for (const option of Object.keys(parsed)) {
+        if (option === 'addToSet')
+            unsupportedArrayOperation('storage.cloud-api');
+        if (option !== 'where') {
+            throw new CapabilityError(`Cloud API records do not support update option '${option}'.`, 'UNAVAILABLE', {
+                reason: 'record-update-option-unsupported', retryable: false
+            });
+        }
+    }
+}
+export function assertSupportedDeleteOptions(options) {
+    const parsed = writeOptions(options);
+    assertUnconditionalWrite(options?.where);
+    if (Object.keys(parsed).some(option => option !== 'where' && option !== 'force') ||
+        (parsed.force !== undefined && !z.boolean().safeParse(parsed.force).success)) {
+        throw new CapabilityError('Cloud API record deletion supports only force and an empty where field map.', 'INVALID_INPUT', {
+            reason: 'record-cloud-write-options-invalid', retryable: false
+        });
+    }
+}
+function encodeScalar(value) {
+    return value instanceof Date ? value.toISOString() : value;
+}
+function matchesOrder(value, expected, operator) {
+    const pair = orderedPairSchema.safeParse([encodeScalar(value), encodeScalar(expected)]);
+    if (!pair.success)
+        return false;
+    const [actual, operand] = pair.data;
+    switch (operator) {
+        case 'gt': return actual > operand;
+        case 'gte': return actual >= operand;
+        case 'lt': return actual < operand;
+        case 'lte': return actual <= operand;
+    }
+}
+function matchesWhere(fields, where) {
+    if (!where)
+        return true;
+    return Object.entries(where).every(([field, expected]) => {
+        const value = fields[field];
+        const scalar = scalarSchema.safeParse(expected);
+        if (scalar.success)
+            return encodeScalar(value) === encodeScalar(scalar.data);
+        const condition = conditionSchema.parse(expected);
+        const equals = (operand) => encodeScalar(value) === encodeScalar(operand);
+        const text = z.string().safeParse(value);
+        return ((condition.isNull === undefined || (value == null) === condition.isNull) &&
+            (condition.isNotNull === undefined || (value != null) === condition.isNotNull) &&
+            (condition.eq === undefined || equals(condition.eq)) &&
+            (condition.ne === undefined || !equals(condition.ne)) &&
+            (condition.gt === undefined || matchesOrder(value, condition.gt, 'gt')) &&
+            (condition.gte === undefined || matchesOrder(value, condition.gte, 'gte')) &&
+            (condition.lt === undefined || matchesOrder(value, condition.lt, 'lt')) &&
+            (condition.lte === undefined || matchesOrder(value, condition.lte, 'lte')) &&
+            (condition.in === undefined || condition.in.some(equals)) &&
+            (condition.notIn === undefined || !condition.notIn.some(equals)) &&
+            (condition.between === undefined ||
+                (matchesOrder(value, condition.between[0], 'gte') && matchesOrder(value, condition.between[1], 'lte'))) &&
+            (condition.contains === undefined ||
+                (text.success && text.data.includes(condition.contains))) &&
+            (condition.startsWith === undefined || (text.success && text.data.startsWith(condition.startsWith))) &&
+            (condition.endsWith === undefined || (text.success && text.data.endsWith(condition.endsWith))));
+    });
+}
+function sortEntry(orderBy) {
+    if (!orderBy)
+        return [null, 'asc'];
+    if (Array.isArray(orderBy))
+        return orderBy.length ? [String(orderBy[0].field), orderBy[0].direction] : [null, 'asc'];
+    const [entry] = Object.entries(orderBy);
+    if (!entry)
+        return [null, 'asc'];
+    const direction = SortDirectionSchema.safeParse(entry[1]);
+    return [entry[0], direction.success ? direction.data : 'asc'];
+}
+//# sourceMappingURL=cloud-api.record.helpers.js.map

package/dist/adapters/cloud-api/cloud-api.record.helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-api.record.helpers.js","sourceRoot":"","sources":["../../../src/adapters/cloud-api/cloud-api.record.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAqB,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAqB,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAkB,MAAM,kCAAkC,CAAC;AAEhF,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC/F,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAQzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACxF,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACxE,+GAA+G;AAC/G,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,YAAY,CAAC;IACxD,EAAE,EAAE,YAAY,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,YAAY,CAAC,QAAQ,EAAE;IACxD,EAAE,EAAE,mBAAmB,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,mBAAmB,CAAC,QAAQ,EAAE;IACvE,EAAE,EAAE,mBAAmB,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,mBAAmB,CAAC,QAAQ,EAAE;IACvE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE;IAC7E,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnG,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxF,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACY,CAAC,CAAC;AACrD,MAAM,eAAe,GAAG,0BAA0B,CAAC;AACnD,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;AACrF,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AACxD,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1G,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AASpD,MAAM,kBAAkB,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;AACxC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAkB,CAAC,KAAK,EAAE,EAAE,CAAC,kBAAkB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;AAEhH,+GAA+G;AAC/G,MAAM,UAAU,cAAc,CAAQ,KAAY,EAAE,UAAmC;IACtF,OAAO,iBAAiB,CAAC,kBAAkB,EAAE,KAAK,EAAE;QACnD,OAAO,EAAE,2CAA2C;QACpD,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,4BAA4B;QACpC,OAAO,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,EAAE;KACpC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACvC,MAAM,IAAI,eAAe,CAAC,6CAA6C,IAAI,GAAG,EAAE,aAAa,EAAE;QAC9F,MAAM,EAAE,oCAAoC;QAC5C,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;KAC5B,CAAC,CAAC;AACJ,CAAC;AAED,qGAAqG;AACrG,SAAS,WAAW,CAAC,MAAyC,EAAE,UAAkB;IACjF,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,UAAU,CAAC;IACnF,OAAO,MAAM,CAAC,KAAK,IAAI,UAAU,CAAC;AACnC,CAAC;AAED,4DAA4D;AAC5D,SAAS,MAAM,CAAC,IAA6C,EAAE,IAAY,EAAE,UAAmC;IAC/G,OAAO,iBAAiB,CAAC,qBAAqB,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE;QAChE,OAAO,EAAE,8CAA8C;QACvD,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,qBAAqB;QAC7B,OAAO,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;KAChD,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,UAAmC,EACnC,UAAkB,EAClB,MAAoB,EACpB,MAAoB;IAEpB,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC3D,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QAAE,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IACjF,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/E,MAAM,MAAM,CAAC,UAAU,CAAC,YAAY,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IAC5E,OAAO,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,UAAmC,EACnC,MAAoB,EACpB,QAAW,EACX,OAAqB;IAErB,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;IACxC,MAAM,MAAM,CAAC,UAAU,CAAC,YAAY,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAC1E,oBAAoB,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IACrF,OAAO,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAC1B,UAAmC,EACnC,MAAoB,EACpB,QAA0B,EAC1B,QAAuB;IAEvB,IAAI,MAAM,GAAG,QAAQ,IAAI,QAAQ,CAAC;IAClC,IAAI,QAAQ,KAAK,IAAI,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,UAAU,IAAI,IAAI,CAAC,EAAE,CAAC;QAC5G,KAAK,MAAM,KAAK,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;YACzD,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;gBAChE,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;gBACzB,MAAM;YACP,CAAC;QACF,CAAC;IACF,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,eAAe,CAAC,2CAA2C,EAAE,UAAU,EAAE;YAClF,MAAM,EAAE,8BAA8B;YACtC,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,EAAE;SACpC,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,QAA0B,EAAE,UAAmC,EAAE,SAAkB;IAC9G,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC7C,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC;QAClC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC/C,QAAQ,CAAC,OAAO;YAChB,QAAQ,CAAC,KAAK;YACd,QAAQ,CAAC,IAAI;YACb,QAAQ,CAAC,KAAK,CAAC;QAChB,CAAC,CAAC,SAAS,CAAC;IACb,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,eAAe,CAAC,mDAAmD,EAAE,UAAU,EAAE;YAC1F,MAAM,EAAE,2BAA2B;YACnC,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,EAAE;SACpC,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAC3B,KAAU,EACV,UAAmC,EACnC,OAAyB;IAEzB,MAAM,KAAK,GAAG,sBAAsB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACrD,MAAM,eAAe,GAAG,UAAU,CAAC,UAAU;QAC5C,CAAC,CAAC,UAAU,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU;QACtE,CAAC,CAAC,IAAI,CAAC;IACR,IAAI,IAAI,GAAG,KAAK;SACd,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;SAChE,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IACtD,IAAI,CAAC,OAAO,EAAE,cAAc,IAAI,eAAe,EAAE,CAAC;QACjD,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACvD,IAAI,KAAK,EAAE,CAAC;QACX,IAAI,CAAC,IAAI,CACR,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACR,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACvG,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAI,KAAsB;IAC/D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,aAAa,EAAE,CAAC;IACrC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM;QAAE,aAAa,EAAE,CAAC;IACnF,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,IAAI,YAAY,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,OAAO;YAAE,SAAS;QACvD,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;YAAE,aAAa,EAAE,CAAC;QACxH,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC;YAAE,yBAAyB,CAAC,mBAAmB,CAAC,CAAC;QAC7H,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC;YAC3E,MAAM,IAAI,eAAe,CAAC,uDAAuD,EAAE,aAAa,EAAE;gBACjG,MAAM,EAAE,iCAAiC,EAAE,SAAS,EAAE,KAAK;aAC3D,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACpB,CAAC;AAED,SAAS,aAAa;IACrB,MAAM,IAAI,eAAe,CAAC,sFAAsF,EAAE,eAAe,EAAE;QAClI,MAAM,EAAE,6BAA6B,EAAE,SAAS,EAAE,KAAK;KACvD,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,OAAuC;IAC5D,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC7E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,eAAe,CAAC,qDAAqD,EAAE,eAAe,EAAE;YACjG,MAAM,EAAE,oCAAoC,EAAE,SAAS,EAAE,KAAK;SAC9D,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACpB,CAAC;AAED,SAAS,wBAAwB,CAAC,KAA6B;IAC9D,MAAM,OAAO,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,eAAe,CAAC,mEAAmE,EAAE,aAAa,EAAE;YAC7G,MAAM,EAAE,4CAA4C,EAAE,SAAS,EAAE,KAAK;SACtE,CAAC,CAAC;IACJ,CAAC;AACF,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,OAAuB;IACnE,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACrC,wBAAwB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACzC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,IAAI,MAAM,KAAK,UAAU;YAAE,yBAAyB,CAAC,mBAAmB,CAAC,CAAC;QAC1E,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,eAAe,CAAC,mDAAmD,MAAM,IAAI,EAAE,aAAa,EAAE;gBACvG,MAAM,EAAE,kCAAkC,EAAE,SAAS,EAAE,KAAK;aAC5D,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;AACF,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,OAAuB;IACnE,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACrC,wBAAwB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,OAAO,CAAC;QAC/E,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/E,MAAM,IAAI,eAAe,CAAC,6EAA6E,EAAE,eAAe,EAAE;YACzH,MAAM,EAAE,oCAAoC,EAAE,SAAS,EAAE,KAAK;SAC9D,CAAC,CAAC;IACJ,CAAC;AACF,CAAC;AAED,SAAS,YAAY,CAAQ,KAAY;IACxC,OAAO,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC5D,CAAC;AAED,SAAS,YAAY,CAAQ,KAAY,EAAE,QAAgC,EAAE,QAAqC;IACjH,MAAM,IAAI,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACxF,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;IACpC,QAAQ,QAAQ,EAAE,CAAC;QAClB,KAAK,IAAI,CAAC,CAAC,OAAO,MAAM,GAAG,OAAO,CAAC;QACnC,KAAK,KAAK,CAAC,CAAC,OAAO,MAAM,IAAI,OAAO,CAAC;QACrC,KAAK,IAAI,CAAC,CAAC,OAAO,MAAM,GAAG,OAAO,CAAC;QACnC,KAAK,KAAK,CAAC,CAAC,OAAO,MAAM,IAAI,OAAO,CAAC;IACtC,CAAC;AACF,CAAC;AAED,SAAS,YAAY,CAAC,MAAoB,EAAE,KAAe;IAC1D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,EAAE;QACxD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,YAAY,CAAC,KAAK,CAAC,KAAK,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE7E,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC;QAClF,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,CACN,CAAC,SAAS,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC;YACxE,CAAC,SAAS,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,CAAC,SAAS,CAAC;YAC9E,CAAC,SAAS,CAAC,EAAE,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACpD,CAAC,SAAS,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACrD,CAAC,SAAS,CAAC,EAAE,KAAK,SAAS,IAAI,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACvE,CAAC,SAAS,CAAC,GAAG,KAAK,SAAS,IAAI,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC1E,CAAC,SAAS,CAAC,EAAE,KAAK,SAAS,IAAI,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACvE,CAAC,SAAS,CAAC,GAAG,KAAK,SAAS,IAAI,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC1E,CAAC,SAAS,CAAC,EAAE,KAAK,SAAS,IAAI,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzD,CAAC,SAAS,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAChE,CAAC,SAAS,CAAC,OAAO,KAAK,SAAS;gBAC/B,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;YACxG,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS;gBAChC,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC1D,CAAC,SAAS,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;YACpG,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAC9F,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAI,OAAoB;IACzC,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrH,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,mBAAmB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC"}

package/dist/adapters/cloud-api/cloud-api.record.js

@@ -0,0 +1,351 @@
+import { z } from 'zod/v4';
+import { CapabilityError, CaughtFailureSchema } from '@vibesdotdev/kernel';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import { applyOptions, assertSupportedDeleteOptions, assertSupportedFilters, assertSupportedUpdateOptions, extractList, parseRecord, prepareCreateRecord, prepareUpdatedRecord, recordFieldsOf, unsupported } from "./cloud-api.record.helpers.js";
+import { CloudRecordQuerySchema, CloudRecordQueryPageSchema } from "../../schemas/cloud-api.js";
+import { RecordRevisionMetadataSchema, RecordRevisionPageSchema, RecordRevisionRequestSchema, recordRevisionReadSchema } from "../../schemas/record/revision.js";
+import { CloudRecordBatchSchema } from "../../schemas/record/batch.js";
+import { loadRecordRelations } from "../../record/relations.js";
+import { assertRecordRevisionSchema } from "../../record/columns.js";
+import { parseAdapterInput } from "../parse-adapter-input.js";
+import { CLOUD_API_RESOURCE_KIND, cloudApiResourceOf } from "./cloud-api.fetch-client.js";
+import { resolveCloudRecordCrudConfig } from '@vibesdotdev/storage/sync/cloud-record-crud-config';
+const ZodSchemaSchema = z.instanceof(z.ZodType);
+/**
+ * The descriptor's row schema, checked to be a zod schema. `T` is the row type
+ * the caller declared with this descriptor (`StorageAdapterInterface.record<T>`);
+ * every row this record answers is that schema's parse.
+ */
+function rowSchemaOf(descriptor) {
+    const schema = ZodSchemaSchema.safeParse(descriptor.schema);
+    if (!schema.success) {
+        throw new CapabilityError('A cloud record descriptor needs a zod schema.', 'INVALID_INPUT', {
+            reason: 'record-schema-invalid',
+            retryable: false,
+            details: { recordId: descriptor.id },
+            cause: schema.error
+        });
+    }
+    // SAFETY: the line above proved the descriptor's schema is a zod schema; `T` is the row type its caller declared for this descriptor.
+    return schema.data;
+}
+export class CloudAPIStorageRecord {
+    descriptor;
+    client;
+    runtime;
+    tableName;
+    primaryKey;
+    schema;
+    relations;
+    supportsConditionalWrites = false;
+    get revisions() {
+        if (!this.descriptor.versioning)
+            return undefined;
+        return {
+            metadata: async (id) => RecordRevisionMetadataSchema.nullable().parse(await this.revisionRequest({ operation: 'metadata', id })),
+            list: async (query) => RecordRevisionPageSchema.parse(await this.revisionRequest({ operation: 'list', query: query ?? {} })),
+            readAtRevision: async (id, revision) => recordRevisionReadSchema(this.schema).parse(await this.revisionRequest({ operation: 'read', id, revision }))
+        };
+    }
+    async revisionRequest(request) {
+        const endpoint = this.config.revisionPath;
+        if (!endpoint)
+            throw new CapabilityError('The cloud record has no authoritative revision endpoint.', 'UNAVAILABLE', {
+                reason: 'record-revision-endpoint-unavailable', retryable: false, details: { recordKind: this.descriptor.id }
+            });
+        const body = parseAdapterInput(JsonValueSchema, RecordRevisionRequestSchema.parse(request), {
+            message: 'The cloud revision request must be JSON without missing filter operands.',
+            code: 'INVALID_INPUT', reason: 'record-revision-request-invalid'
+        });
+        return this.client.request(endpoint, { method: 'POST', body: JSON.stringify(body) });
+    }
+    /**
+     * `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, client, runtime) {
+        this.descriptor = descriptor;
+        this.client = client;
+        this.runtime = runtime;
+        this.tableName = descriptor.tableName;
+        assertRecordRevisionSchema(descriptor);
+        this.primaryKey = descriptor.primaryKey || 'id';
+        this.schema = rowSchemaOf(descriptor);
+        this.relations = descriptor.relations ?? {};
+    }
+    async create(data) {
+        return this.createFields(recordFieldsOf(data, this.descriptor));
+    }
+    /** Create from checked fields: the descriptor's id, timestamps and hook applied, then the schema's parse sent. */
+    async createFields(fields) {
+        const record = await prepareCreateRecord(this.descriptor, this.primaryKey, this.schema, fields);
+        const response = await this.client.request(this.config.apiPath, {
+            method: this.config.createMethod || 'POST',
+            body: JSON.stringify(record)
+        });
+        return parseRecord(this.descriptor, this.schema, response, record);
+    }
+    createMany(data, _options) {
+        return Promise.all(data.map((item) => this.create(item)));
+    }
+    async get(id, options) {
+        const path = this.entityPath(id);
+        let response;
+        try {
+            response = await this.client.request(path);
+        }
+        catch (thrown) {
+            const failure = CaughtFailureSchema.parse(thrown);
+            // Only a 404 for exactly this record is absence; any other failure propagates.
+            if (CapabilityError.isAbsenceOf(failure, CLOUD_API_RESOURCE_KIND, cloudApiResourceOf(path)))
+                return null;
+            throw failure;
+        }
+        if (response === null)
+            return null;
+        return loadRecordRelations(this.relationOwner, parseRecord(this.descriptor, this.schema, response), options?.include);
+    }
+    async getOrThrow(id, options) {
+        const record = await this.get(id, options);
+        if (record === null) {
+            throw new CapabilityError('Record not found.', 'NOT_FOUND', {
+                reason: 'record-absent',
+                retryable: false,
+                details: { kind: 'storage/record', id, recordId: this.descriptor.id }
+            });
+        }
+        return record;
+    }
+    async getMany(ids, options) {
+        const found = [];
+        for (const item of await Promise.all(ids.map((id) => this.get(id, options)))) {
+            if (item !== null)
+                found.push(item);
+        }
+        return found;
+    }
+    async list(options) {
+        assertSupportedFilters(options?.where);
+        if (this.config.queryMode === 'remote') {
+            const query = parseAdapterInput(CloudRecordQuerySchema, options ?? {}, {
+                message: 'The remote record query is invalid or unsupported.',
+                code: 'INVALID_INPUT', reason: 'record-cloud-query-invalid'
+            });
+            const separator = this.config.apiPath.includes('?') ? '&' : '?';
+            const params = new URLSearchParams({ query: JSON.stringify(query) });
+            const response = await this.client.request(`${this.config.apiPath}${separator}${params}`);
+            const page = parseAdapterInput(CloudRecordQueryPageSchema, response, {
+                message: 'The remote record page is invalid.',
+                code: 'INTERNAL', reason: 'record-cloud-query-page-invalid'
+            });
+            const items = page.items.map((item) => parseRecord(this.descriptor, this.schema, item));
+            return { ...page, items };
+        }
+        const response = await this.client.request(this.listPath());
+        const items = extractList(response, this.descriptor, this.config.listField).map((item) => parseRecord(this.descriptor, this.schema, item));
+        const filtered = applyOptions(items, this.descriptor, options);
+        const loaded = await Promise.all(filtered.map((item) => loadRecordRelations(this.relationOwner, item, options?.include)));
+        return { items: loaded, total: loaded.length, hasMore: false };
+    }
+    findFirst(options) {
+        return this.list({ ...options, limit: 1 }).then((result) => result.items[0] ?? null);
+    }
+    async findFirstOrThrow(options) {
+        const record = await this.findFirst(options);
+        if (record === null) {
+            throw new CapabilityError('No matching record found.', 'NOT_FOUND', {
+                reason: 'record-absent',
+                retryable: false,
+                details: { recordId: this.descriptor.id }
+            });
+        }
+        return record;
+    }
+    exists(id) {
+        return this.get(id).then((record) => record !== null);
+    }
+    count(where) {
+        if (this.config.queryMode !== 'remote')
+            return this.list(where ? { where } : undefined).then((result) => result.items.length);
+        return this.list({ where, limit: 1, includeTotal: true }).then((result) => {
+            if (result.total !== undefined)
+                return result.total;
+            throw new CapabilityError('The remote record endpoint did not return the requested total.', 'INTERNAL', {
+                reason: 'record-cloud-query-total-missing', retryable: false
+            });
+        });
+    }
+    search(_query, _options) {
+        unsupported('search');
+    }
+    getDescendants() {
+        unsupported('hierarchy queries');
+    }
+    getAncestors() {
+        unsupported('hierarchy queries');
+    }
+    getTree() {
+        unsupported('hierarchy queries');
+    }
+    async update(id, data, options) {
+        assertSupportedUpdateOptions(options);
+        return this.updateFields(id, recordFieldsOf(data, this.descriptor));
+    }
+    /** Update from checked changes: merged over the live row, hooked, stamped, and the schema's parse sent. */
+    async updateFields(id, changes) {
+        const validated = await prepareUpdatedRecord(this.descriptor, this.schema, await this.getOrThrow(id), changes);
+        const response = await this.client.request(this.entityPath(id), {
+            method: this.config.updateMethod || 'PATCH',
+            body: JSON.stringify(validated)
+        });
+        return parseRecord(this.descriptor, this.schema, response, validated);
+    }
+    async updateMany(where, data, options) {
+        assertSupportedFilters(where);
+        assertSupportedUpdateOptions(options);
+        const items = await this.allMatches(where);
+        await Promise.all(items.map((item) => this.update(this.requireId(item), data, options)));
+        return { count: items.length, success: items.length > 0 };
+    }
+    async upsert(id, create, update) {
+        if (await this.exists(id))
+            return this.update(id, update);
+        return this.createFields({ ...recordFieldsOf(create, this.descriptor), [this.primaryKey]: id });
+    }
+    async delete(id, options) {
+        assertSupportedDeleteOptions(options);
+        if (this.descriptor.softDelete && !options?.force) {
+            await this.updateFields(id, { [this.softDeleteField()]: new Date().toISOString() });
+            return { count: 1, success: true };
+        }
+        const path = this.entityPath(id);
+        try {
+            await this.client.request(path, { method: 'DELETE' });
+        }
+        catch (thrown) {
+            const failure = CaughtFailureSchema.parse(thrown);
+            // Only a 404 for exactly this record means nothing was deleted; any other failure propagates.
+            if (CapabilityError.isAbsenceOf(failure, CLOUD_API_RESOURCE_KIND, cloudApiResourceOf(path)))
+                return { count: 0, success: false };
+            throw failure;
+        }
+        return { count: 1, success: true };
+    }
+    async deleteMany(where, options) {
+        assertSupportedFilters(where);
+        assertSupportedDeleteOptions(options);
+        const items = await this.allMatches(where);
+        await Promise.all(items.map((item) => this.delete(this.requireId(item), options)));
+        return { count: items.length, success: items.length > 0 };
+    }
+    restore(id) {
+        if (!this.descriptor.softDelete)
+            unsupported('restore');
+        return this.updateFields(id, { [this.softDeleteField()]: null });
+    }
+    aggregate() {
+        unsupported('aggregation');
+    }
+    transaction() {
+        unsupported('transactions');
+    }
+    async *stream(options) {
+        for (const item of (await this.list(options)).items)
+            yield item;
+    }
+    batch(operations) {
+        // The whole batch is validated before the first mutation starts: an
+        // unknown discriminator or a malformed later entry refuses with no
+        // request issued and no record changed. Delete runs only for an
+        // explicitly validated delete operation. This adapter issues no
+        // transactional rollback for remote failures: entries before a remote
+        // failure stay applied.
+        const validated = parseAdapterInput(CloudRecordBatchSchema, operations, {
+            message: 'A cloud record batch must hold create, update, or delete operations.',
+            code: 'INVALID_INPUT',
+            reason: 'record-batch-invalid',
+            details: { recordId: this.descriptor.id }
+        });
+        return Promise.all(validated.map((op) => {
+            switch (op.type) {
+                case 'create':
+                    return this.createFields(recordFieldsOf(op.data, this.descriptor));
+                case 'update':
+                    return this.updateFields(op.id, recordFieldsOf(op.data ?? {}, this.descriptor));
+                case 'delete':
+                    return this.delete(op.id);
+            }
+        }));
+    }
+    raw() {
+        unsupported('raw queries');
+    }
+    queryRaw() {
+        unsupported('raw queries');
+    }
+    validate(data) {
+        const result = this.schema.safeParse(data);
+        return Promise.resolve(result.success
+            ? { success: true, data: result.data }
+            : { success: false, errors: result.error });
+    }
+    async initialize() {
+        void this.config;
+    }
+    getAdapterId() {
+        return 'storage.cloud-api';
+    }
+    close() {
+        return Promise.resolve();
+    }
+    async allMatches(where) {
+        if (this.config.queryMode !== 'remote')
+            return (await this.list({ where })).items;
+        const items = [];
+        let hasMore = true;
+        while (hasMore) {
+            const page = await this.list({ where, offset: items.length, limit: 1000 });
+            if (page.hasMore && page.items.length === 0) {
+                throw new CapabilityError('The remote record query did not advance.', 'INTERNAL', {
+                    reason: 'record-cloud-query-page-stalled', retryable: false
+                });
+            }
+            items.push(...page.items);
+            hasMore = page.hasMore === true;
+        }
+        return items;
+    }
+    /** What relation loading reads of this record: its kind, primary key, declared relations and runtime. */
+    get relationOwner() {
+        return { recordKind: this.descriptor.id, primaryKey: this.primaryKey, relations: this.relations, runtime: this.runtime };
+    }
+    get config() {
+        return resolveCloudRecordCrudConfig(this.descriptor);
+    }
+    entityPath(id) {
+        return (this.config.entityPath || `${this.config.apiPath}/:id`).replace(':id', encodeURIComponent(id));
+    }
+    listPath() {
+        const params = new URLSearchParams({ page: '1', perPage: '1000' });
+        return this.config.apiPath.includes('?')
+            ? `${this.config.apiPath}&${params.toString()}`
+            : `${this.config.apiPath}?${params.toString()}`;
+    }
+    softDeleteField() {
+        const field = this.descriptor.softDelete;
+        return field === undefined || field === true || field === false ? 'deletedAt' : field;
+    }
+    requireId(item) {
+        const id = z.string().safeParse(recordFieldsOf(item, this.descriptor)[this.primaryKey]);
+        if (!id.success) {
+            throw new CapabilityError('A cloud record is missing its primary key.', 'INTERNAL', {
+                reason: 'record-cloud-id-missing',
+                retryable: false,
+                details: { recordId: this.descriptor.id, primaryKey: this.primaryKey }
+            });
+        }
+        return id.data;
+    }
+}
+//# sourceMappingURL=cloud-api.record.js.map