@researchdatabox/redbox-core 5.0.3 → 5.0.4-beta.12498

package/dist/RecordHttpConcurrency.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECORD_HTTP_HEADERS = void 0;
+exports.parsePublicRecordConcurrencyRequest = parsePublicRecordConcurrencyRequest;
+exports.recordConcurrencyRequestFailureResponse = recordConcurrencyRequestFailureResponse;
+exports.recordRepresentationRevision = recordRepresentationRevision;
+exports.recordRepresentationConcurrency = recordRepresentationConcurrency;
+exports.recordSaveResultHeaders = recordSaveResultHeaders;
+exports.recordSaveResultHeaderOption = recordSaveResultHeaderOption;
+const sails_ng_common_1 = require("@researchdatabox/sails-ng-common");
+const RecordEntityTag_1 = require("./RecordEntityTag");
+const RecordStorageConcurrency_1 = require("./RecordStorageConcurrency");
+exports.RECORD_HTTP_HEADERS = Object.freeze({
+    ifMatch: 'If-Match',
+    entityTag: 'ETag',
+    formFingerprint: 'X-ReDBox-Form-Fingerprint',
+    resolution: 'X-ReDBox-Concurrency-Resolution',
+    resolutionOfRequestId: 'X-ReDBox-Resolution-Of-Request-Id',
+    saveRequestId: 'X-ReDBox-Save-Request-Id',
+});
+const PUBLIC_MUTATION_RESOLUTIONS = new Set([
+    'direct',
+    'client-auto-merged',
+    'client-manually-resolved',
+]);
+/** Node normalizes incoming request-header names to lowercase. */
+function readHeader(headers, name) {
+    if (!headers || typeof headers !== 'object' || Array.isArray(headers))
+        return undefined;
+    return headers[name.toLowerCase()];
+}
+/** `null` marks a present but unusable value, including a duplicate-value array. */
+function singleStringHeader(value) {
+    if (value === undefined)
+        return undefined;
+    return typeof value === 'string' ? value : null;
+}
+/** `null` for a present but unusable value is deliberately preserved, not trimmed away. */
+function trimmedHeader(value) {
+    const header = singleStringHeader(value);
+    return typeof header === 'string' ? header.trim() : header;
+}
+/** Clients may only claim resolutions a client can actually perform. */
+function isPublicMutationResolution(value) {
+    return (0, sails_ng_common_1.isRecordConcurrencyResolution)(value) && PUBLIC_MUTATION_RESOLUTIONS.has(value);
+}
+/** Create routes accept no precondition: absent is fine, anything else is not. */
+function createRouteEntityTagResult(value) {
+    const absent = value === undefined;
+    return { valid: false, reason: absent ? 'missing' : 'malformed' };
+}
+/**
+ * Normalize public optimistic-concurrency headers once at the HTTP boundary.
+ * Staleness and policy remain RecordsService/storage decisions; malformed
+ * request contracts are rejected before candidate work begins.
+ */
+function parsePublicRecordConcurrencyRequest(headers, recordOid, options = {}) {
+    const ifMatchValue = readHeader(headers, exports.RECORD_HTTP_HEADERS.ifMatch);
+    // Create has no prior representation, so any supplied precondition is a
+    // request-contract error rather than something to compare.
+    let parsedTag;
+    try {
+        parsedTag =
+            recordOid === undefined
+                ? createRouteEntityTagResult(ifMatchValue)
+                : (0, RecordEntityTag_1.parseRecordEntityTag)(ifMatchValue, recordOid);
+    }
+    catch {
+        return { valid: false, code: 'record-if-match-invalid', header: exports.RECORD_HTTP_HEADERS.ifMatch };
+    }
+    if (!parsedTag.valid && parsedTag.reason !== 'missing') {
+        return { valid: false, code: 'record-if-match-invalid', header: exports.RECORD_HTTP_HEADERS.ifMatch };
+    }
+    // Only a generated browser form binds to a form definition; other routes
+    // ignore the header rather than validating a value they never compare.
+    const suppliedFingerprint = options.formBacked
+        ? singleStringHeader(readHeader(headers, exports.RECORD_HTTP_HEADERS.formFingerprint))
+        : undefined;
+    const formFingerprint = (0, sails_ng_common_1.isRecordFormFingerprint)(suppliedFingerprint) ? suppliedFingerprint : undefined;
+    if (suppliedFingerprint !== undefined && formFingerprint === undefined) {
+        return { valid: false, code: 'record-form-fingerprint-invalid', header: exports.RECORD_HTTP_HEADERS.formFingerprint };
+    }
+    // Once an update caller adopts the exact entity-tag protocol it must also
+    // bind the generated form contract. A truly old update with neither header
+    // is allowed through so strict policy can produce the specified review-only
+    // 428 response. Create has no prior representation; a missing fingerprint
+    // is therefore left to the record-type policy in RecordsService so default
+    // last-write-wins/observe callers remain compatible.
+    if (options.formBacked && !formFingerprint && parsedTag.valid) {
+        return { valid: false, code: 'record-form-fingerprint-invalid', header: exports.RECORD_HTTP_HEADERS.formFingerprint };
+    }
+    const suppliedResolution = trimmedHeader(readHeader(headers, exports.RECORD_HTTP_HEADERS.resolution));
+    const resolution = isPublicMutationResolution(suppliedResolution) ? suppliedResolution : undefined;
+    if (suppliedResolution !== undefined && resolution === undefined) {
+        return { valid: false, code: 'record-concurrency-resolution-invalid', header: exports.RECORD_HTTP_HEADERS.resolution };
+    }
+    // Linkage is required by, and only by, a client-resolved retry, and it names
+    // the earlier attempt rather than this one.
+    const suppliedLinkage = singleStringHeader(readHeader(headers, exports.RECORD_HTTP_HEADERS.resolutionOfRequestId));
+    const saveRequestId = singleStringHeader(readHeader(headers, exports.RECORD_HTTP_HEADERS.saveRequestId));
+    const linkageRequired = resolution === 'client-auto-merged' || resolution === 'client-manually-resolved';
+    const linkageAcceptable = suppliedLinkage === undefined
+        ? !linkageRequired
+        : linkageRequired &&
+            (0, sails_ng_common_1.isRecordSaveRequestId)(saveRequestId) &&
+            (0, sails_ng_common_1.isRecordSaveRequestId)(suppliedLinkage) &&
+            suppliedLinkage !== saveRequestId;
+    if (!linkageAcceptable) {
+        return {
+            valid: false,
+            code: 'record-concurrency-request-linkage-invalid',
+            header: linkageRequired && !(0, sails_ng_common_1.isRecordSaveRequestId)(saveRequestId)
+                ? exports.RECORD_HTTP_HEADERS.saveRequestId
+                : exports.RECORD_HTTP_HEADERS.resolutionOfRequestId,
+        };
+    }
+    return {
+        valid: true,
+        context: {
+            entityTagSupplied: parsedTag.valid,
+            ...(parsedTag.valid ? { expectedRevision: parsedTag.value.expectedRevision } : {}),
+            ...(formFingerprint ? { formFingerprint } : {}),
+            ...(resolution ? { resolution } : {}),
+            ...(suppliedLinkage ? { resolutionOfRequestId: suppliedLinkage } : {}),
+        },
+    };
+}
+function recordConcurrencyRequestFailureResponse(apiVersion, failure) {
+    return apiVersion === '1.0'
+        ? { status: 400, v1: { message: 'Invalid record concurrency request.' } }
+        : { status: 400, displayErrors: [{ code: failure.code, source: { header: failure.header } }] };
+}
+/**
+ * Revision of one stored active or tombstone representation. A record written
+ * before the revision migration reads as the initial revision; anything else
+ * non-conforming is a storage fault rather than a value to guess at.
+ */
+function recordRepresentationRevision(record) {
+    if (!record || typeof record !== 'object' || Array.isArray(record)) {
+        throw new TypeError('A record representation is required.');
+    }
+    const revision = record.revision;
+    if (revision === undefined)
+        return RecordStorageConcurrency_1.INITIAL_RECORD_REVISION;
+    if (!(0, sails_ng_common_1.isRecordRevision)(revision)) {
+        throw new TypeError('The record representation has no valid revision.');
+    }
+    return revision;
+}
+/**
+ * Build read-side revision metadata and the `ETag` header from server-owned
+ * record fields only. Collection rows carry the numeric revision alone: a row
+ * is not an individual representation, so it gets no entity tag.
+ */
+function recordRepresentationConcurrency(record) {
+    const revision = recordRepresentationRevision(record);
+    const oid = String(record.redboxOid ?? '').trim();
+    if (!oid) {
+        throw new TypeError('The record representation has no valid concurrency identity.');
+    }
+    const entityTag = (0, RecordEntityTag_1.formatRecordEntityTag)(oid, revision);
+    return {
+        headers: { [exports.RECORD_HTTP_HEADERS.entityTag]: entityTag },
+        metadata: { revision, entityTag },
+    };
+}
+/** Emit only the authoritative entity tag carried by a typed save result. */
+function recordSaveResultHeaders(result) {
+    const entityTag = result?.concurrency?.entityTag;
+    return (0, sails_ng_common_1.isRecordEntityTag)(entityTag) ? { [exports.RECORD_HTTP_HEADERS.entityTag]: entityTag } : {};
+}
+/**
+ * Spreadable response fragment. The `headers` key is omitted entirely when a
+ * result carries no authoritative tag, so responses that never had one keep
+ * their existing shape.
+ */
+function recordSaveResultHeaderOption(result) {
+    const headers = recordSaveResultHeaders(result);
+    return Object.keys(headers).length > 0 ? { headers } : {};
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUmVjb3JkSHR0cENvbmN1cnJlbmN5LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL1JlY29yZEh0dHBDb25jdXJyZW5jeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFrRkEsa0ZBK0VDO0FBRUQsMEZBT0M7QUFZRCxvRUFVQztBQU9ELDBFQVdDO0FBR0QsMERBS0M7QUFPRCxvRUFLQztBQXRPRCxzRUFTMEM7QUFDMUMsdURBQWlIO0FBRWpILHlFQUFxRTtBQUV4RCxRQUFBLG1CQUFtQixHQUFHLE1BQU0sQ0FBQyxNQUFNLENBQUM7SUFDL0MsT0FBTyxFQUFFLFVBQVU7SUFDbkIsU0FBUyxFQUFFLE1BQU07SUFDakIsZUFBZSxFQUFFLDJCQUEyQjtJQUM1QyxVQUFVLEVBQUUsaUNBQWlDO0lBQzdDLHFCQUFxQixFQUFFLG1DQUFtQztJQUMxRCxhQUFhLEVBQUUsMEJBQTBCO0NBQzFDLENBQUMsQ0FBQztBQXFCSCxNQUFNLDJCQUEyQixHQUE2QyxJQUFJLEdBQUcsQ0FBQztJQUNwRixRQUFRO0lBQ1Isb0JBQW9CO0lBQ3BCLDBCQUEwQjtDQUMzQixDQUFDLENBQUM7QUFFSCxrRUFBa0U7QUFDbEUsU0FBUyxVQUFVLENBQUMsT0FBc0QsRUFBRSxJQUFZO0lBQ3RGLElBQUksQ0FBQyxPQUFPLElBQUksT0FBTyxPQUFPLEtBQUssUUFBUSxJQUFJLEtBQUssQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDO1FBQUUsT0FBTyxTQUFTLENBQUM7SUFDeEYsT0FBTyxPQUFPLENBQUMsSUFBSSxDQUFDLFdBQVcsRUFBRSxDQUFDLENBQUM7QUFDckMsQ0FBQztBQUVELG9GQUFvRjtBQUNwRixTQUFTLGtCQUFrQixDQUFDLEtBQWM7SUFDeEMsSUFBSSxLQUFLLEtBQUssU0FBUztRQUFFLE9BQU8sU0FBUyxDQUFDO0lBQzFDLE9BQU8sT0FBTyxLQUFLLEtBQUssUUFBUSxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FB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

package/dist/RecordSaveResponse.d.ts

@@ -0,0 +1,219 @@
+import { isRecordSaveRequestId, RecordAttachmentCompletionItem, RecordConcurrencyMetadata, RecordConcurrencyResolution, RecordSaveIssue, RecordSaveLifecyclePhase, RecordSaveProblem, RecordSaveProblemKind, RecordSaveResult, RecordSaveOutcome, StorageMutationApplicationState } from '@researchdatabox/sails-ng-common';
+import type { RecordContractCompleteness, RecordContractEnforcement } from './record-contract/types';
+import { StorageMutationResponse, StorageServiceResponse } from './StorageServiceResponse';
+export type RecordSaveRouteFamily = 'browser' | 'api' | 'internal';
+export type RecordSaveOperation = 'create' | 'update' | 'transition' | 'delete' | 'restore' | 'purge';
+export type NormalizedRecordSchemaOperation = string;
+export type RecordValidationContextJSONValue = string | number | boolean | null | readonly RecordValidationContextJSONValue[] | {
+    readonly [key: string]: RecordValidationContextJSONValue;
+};
+/** Reasons approved for the narrowly scoped internal validation bypass. */
+export declare const RECORD_VALIDATION_BYPASS_REASONS: readonly ["historical-record-repair", "trusted-data-migration", "configuration-recovery"];
+export type RecordValidationBypassReason = (typeof RECORD_VALIDATION_BYPASS_REASONS)[number];
+export declare function isRecordValidationBypassReason(value: unknown): value is RecordValidationBypassReason;
+/**
+ * Deliberately awkward internal-only capability.  A string flag is not a
+ * bypass: callers must identify the responsible service and use an approved
+ * reason so the decision can be durably audited.
+ */
+export interface InternalRecordValidationBypass {
+    readonly mode: 'bypass';
+    readonly reason: RecordValidationBypassReason;
+    readonly actor: {
+        readonly kind: 'service';
+        readonly id: string;
+    };
+}
+/** Runtime guard for JavaScript callers crossing the internal capability boundary. */
+export declare function isInternalRecordValidationBypass(value: unknown): value is InternalRecordValidationBypass;
+export interface RecordSaveSchemaOutcomeInput {
+    readonly digest: string;
+    readonly immutableUrl: string;
+    readonly completeness: RecordContractCompleteness;
+    readonly enforcement: RecordContractEnforcement;
+}
+export type RecordSaveSchemaOutcomeMetadata = Readonly<RecordSaveSchemaOutcomeInput>;
+export interface RecordSaveContext {
+    readonly requestId: string;
+    readonly routeFamily?: RecordSaveRouteFamily;
+    readonly operation?: RecordSaveOperation;
+    /** Factory-normalized portal copied from the server-owned matched request context. */
+    readonly portal?: string;
+    /** Server-owned workflow target copied from the matched route, not inferred from a resolved step object. */
+    readonly targetStep?: string;
+    /** Server-owned business intent; never conflated with the CRUD operation. */
+    readonly validationOperation?: string;
+    /** Factory-normalized operation shared by schema resolution and the existing validator phase. */
+    readonly schemaOperation?: NormalizedRecordSchemaOperation;
+    /** Raw schema ETag precondition copied only from a trusted transport header. */
+    readonly ifMatch?: string;
+    /** Explicit, JSON-only request facts; the validation config allowlist narrows these again. */
+    readonly validationRequestParameters?: Readonly<Record<string, RecordValidationContextJSONValue>>;
+    /** Server-owned, JSON-only execution facts. Never place sessions, headers, or tokens here. */
+    readonly validationRuntimeContext?: Readonly<Record<string, RecordValidationContextJSONValue>>;
+    /** Accepted only when routeFamily is explicitly `internal`. */
+    readonly validationBypass?: InternalRecordValidationBypass;
+    /** Trusted transport-neutral optimistic-concurrency facts. */
+    readonly concurrency?: RecordConcurrencyContext;
+}
+/** Trusted values accepted by the save-context factory. */
+export interface RecordSaveContextOptions {
+    readonly requestId?: string;
+    readonly routeFamily?: RecordSaveRouteFamily;
+    readonly operation?: RecordSaveOperation;
+    /** Server-owned portal selected by the trusted transport adapter. */
+    readonly portal?: string;
+    readonly targetStep?: string;
+    readonly validationOperation?: string;
+    readonly validationRequestParameters?: Readonly<Record<string, RecordValidationContextJSONValue>>;
+    readonly validationRuntimeContext?: Readonly<Record<string, RecordValidationContextJSONValue>>;
+    readonly validationBypass?: InternalRecordValidationBypass;
+    /** Trusted transport-neutral optimistic-concurrency facts. */
+    readonly concurrency?: unknown;
+    /** Trusted transport adaptation for the raw If-Match header. */
+    readonly recordSchemaIfMatch?: string;
+}
+/** Runtime counterpart to the nominal context type for JavaScript/service boundaries. */
+export declare function isRecordSaveContext(value: unknown): value is RecordSaveContext;
+/** Validate and brand the schema identity exposed by a completed save. */
+export declare function createRecordSaveSchemaOutcomeMetadata(metadata: unknown): RecordSaveSchemaOutcomeMetadata;
+/**
+ * Normalized concurrency facts supplied by a controller or trusted internal
+ * helper. Raw requests, headers, users, and record candidates must not cross
+ * this boundary.
+ */
+export interface RecordConcurrencyContext {
+    readonly expectedRevision?: number;
+    readonly entityTagSupplied: boolean;
+    readonly formFingerprint?: string;
+    readonly resolution?: RecordConcurrencyResolution;
+    /** Diagnostic linkage only; this is not an idempotency key. */
+    readonly resolutionOfRequestId?: string;
+}
+export declare const RECORD_VALIDATION_REQUEST_FACT_NAMES: readonly ["recordType", "targetStep", "merge", "datastreams"];
+/**
+ * Project the same bounded request facts for browser and API transports.
+ * Sources are checked in order and accessors are never invoked.
+ */
+export declare function normalizeRecordValidationRequestFacts(...sources: readonly unknown[]): Readonly<Record<string, RecordValidationContextJSONValue>>;
+/** Shared transport-neutral runtime facts; public callers cannot add objects. */
+export declare function recordValidationRuntimeFacts(context: Pick<RecordSaveContext, 'routeFamily' | 'operation' | 'validationRuntimeContext'>, writeKind: RecordSaveOperation): Readonly<Record<string, RecordValidationContextJSONValue>>;
+export type PublicValidationOperationParseResult = {
+    readonly valid: true;
+    readonly value?: string;
+} | {
+    readonly valid: false;
+};
+/** Narrow and trim the public operation field before it enters save context. */
+export declare function parsePublicValidationOperation(value: unknown): PublicValidationOperationParseResult;
+/** A typed response for record metadata save operations. */
+export declare class RecordSaveResponse extends StorageServiceResponse implements RecordSaveResult {
+    #private;
+    outcome: RecordSaveOutcome;
+    problems: RecordSaveProblem[];
+    completion: import("@researchdatabox/sails-ng-common").RecordSaveCompletion;
+    requestId: string;
+    readonly context: RecordSaveContext;
+    concurrency?: RecordConcurrencyMetadata;
+    /** Safe schema identity/result facts; never part of the stored record payload. */
+    readonly schemaOutcome?: RecordSaveSchemaOutcomeMetadata;
+    /** Legacy API v1 fields populated by the RDMP workspace post-save hook. */
+    workspaceOid?: string;
+    workspaceData?: unknown;
+    constructor(context?: RecordSaveContext | string);
+    /** True when the primary metadata mutation is known to have been applied. */
+    wasPersisted(): boolean;
+    /** True only when all required awaited save phases completed. */
+    isComplete(): boolean;
+    addProblem(problem: RecordSaveProblem): void;
+    setAttachmentItems(items: readonly RecordAttachmentCompletionItem[]): void;
+    setProjectedMetadata(metadata: Record<string, unknown> | null): void;
+    /** Retain only bounded server-owned concurrency diagnostics. */
+    setConcurrencyMetadata(metadata: unknown): void;
+    /** Compatibility view used by save-pipeline code while the response owns its state directly. */
+    get result(): RecordSaveResponse;
+    confirmPrimaryPersistence(oid: string, source?: StorageServiceResponse): void;
+    recordPrimaryNotApplied(problem?: RecordSaveProblem): void;
+    recordPrimaryUnknown(problem?: RecordSaveProblem): void;
+    recordPostPersistenceProblem(problem: RecordSaveProblem): void;
+    recordWarning(problem: RecordSaveProblem): void;
+    mergeLegacyHookFields(source: unknown): void;
+    toResponse(): RecordSaveResponse;
+    setSchemaOutcome(metadata: RecordSaveSchemaOutcomeInput): void;
+    /**
+     * A persisted save can only ever move from `saved` to `saved-with-warnings`.
+     * Non-persisted outcomes are left untouched so a later warning cannot
+     * manufacture a commit that never happened.
+     */
+    private downgradeCompleteSave;
+    private recordPrimaryFailure;
+}
+/**
+ * Small state owner used by RecordsService.  Callers cannot accidentally
+ * downgrade a confirmed commit while handling a later warning.
+ */
+export declare class RecordSaveTracker {
+    readonly context: RecordSaveContext;
+    private readonly response;
+    constructor(context: RecordSaveContext);
+    get result(): RecordSaveResponse;
+    confirmPrimaryPersistence(oid: string, source?: StorageServiceResponse): void;
+    recordPrimaryNotApplied(problem?: RecordSaveProblem): void;
+    recordPrimaryUnknown(problem?: RecordSaveProblem): void;
+    recordPostPersistenceProblem(problem: RecordSaveProblem): void;
+    /** Track a nonblocking warning before or after the primary commit. */
+    recordWarning(problem: RecordSaveProblem): void;
+    setAttachmentItems(items: readonly RecordAttachmentCompletionItem[]): void;
+    setProjectedMetadata(metadata: Record<string, unknown> | null): void;
+    setConcurrencyMetadata(metadata: unknown): void;
+    setSchemaOutcome(metadata: RecordSaveSchemaOutcomeInput): void;
+    /** Preserve the narrowly scoped legacy fields without exposing tracked save state to hooks. */
+    mergeLegacyHookFields(source: unknown): void;
+    /** A detached copy, so callers cannot mutate tracked state after the fact. */
+    toResponse(): RecordSaveResponse;
+    private recordPrimaryFailure;
+}
+/**
+ * One canonical save request-correlation UUID. The format lives in the shared
+ * package so browser, controller, and concurrency diagnostics agree.
+ */
+export declare const isCanonicalSaveRequestId: typeof isRecordSaveRequestId;
+/** Drop every field outside the bounded server-owned concurrency allowlist. */
+export declare function normalizeRecordConcurrencyContext(value: unknown): RecordConcurrencyContext | undefined;
+export declare function createRecordSaveContext(context?: RecordSaveContextOptions): RecordSaveContext;
+/**
+ * Read the client-supplied save request ID from request headers.  Node
+ * lower-cases incoming header names, and anything that is not a single
+ * canonical UUID is replaced by a server-generated value.
+ */
+export declare function readSaveRequestId(headers: Record<string, unknown> | undefined): string | undefined;
+export declare function isRecordConflictStatus(status: number): boolean;
+/**
+ * HTTP status for a save that did not persist.  Persisted outcomes never
+ * reach here: once primary metadata is applied the route family decides the
+ * success status and the warnings travel in the typed result.
+ */
+export declare function recordSaveFailureStatus(result: Pick<RecordSaveResult, 'outcome' | 'problems'> | null | undefined): number;
+export interface RecordSaveDisplayError {
+    readonly code?: string;
+    readonly title?: string;
+    readonly detail?: string;
+    readonly source?: {
+        readonly pointer?: string;
+    };
+}
+/**
+ * Project only the safe issue contract into the v2 JSON:API error array. The
+ * complete typed result remains in `meta`; raw exceptions and candidates are
+ * never used to infer a conflict.
+ */
+export declare function recordSaveDisplayErrors(result: Pick<RecordSaveResult, 'problems'> | null | undefined, fallbackDetail: string): RecordSaveDisplayError[];
+export type StorageMutationLogger = (message: string, details?: Record<string, unknown>) => void;
+/**
+ * Normalize old and new adapter responses at one boundary.  Legacy success
+ * is trusted temporarily for compatibility; legacy false is ambiguous
+ * because a failed call is not proof that nothing was written.
+ */
+export declare function resolveStorageMutationState(response: StorageServiceResponse | StorageMutationResponse | null | undefined, logDeprecation?: StorageMutationLogger): StorageMutationApplicationState;
+export declare function recordSaveProblem(kind: RecordSaveProblemKind, phase: RecordSaveLifecyclePhase, message: string, code?: string, issue?: Partial<RecordSaveIssue>): RecordSaveProblem;
+//# sourceMappingURL=RecordSaveResponse.d.ts.map

package/dist/RecordSaveResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecordSaveResponse.d.ts","sourceRoot":"","sources":["../src/RecordSaveResponse.ts"],"names":[],"mappings":"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"}