interface MergeStorage {
getItem(key: string): string | null;
setItem(key: string, value: string): void;
}
const PROMPT_STASH_KEY = "t3code:prompt-stash:v2";
const COMPOSER_DRAFTS_KEY = "t3code:composer-drafts:v1";
const NOT_IMPORTED_KEYS = new Set([
// Identifies one running install to the server; two apps must not share it.
"t3.backgroundActivity.clientId",
"t3code:snap-shot-setup-resume:v1",
]);
/** Matches MAX_STASH_ENTRIES in apps/web/src/promptStashStore.ts. */
const MAX_STASH_ENTRIES = 20;
const DRAFT_RECORD_FIELDS = [
"draftsByThreadKey",
"draftThreadsByThreadKey",
"logicalProjectDraftThreadKeyByLogicalProjectKey",
] as const;
type JsonObject = Record<string, unknown>;
const isObject = (value: unknown): value is JsonObject =>
typeof value === "object" && value !== null && !Array.isArray(value);
function parseObject(raw: string): JsonObject | null {
try {
const parsed: unknown = JSON.parse(raw);
return isObject(parsed) ? parsed : null;
} catch {
return null;
}
}
function mergePromptStash(current: JsonObject, legacy: JsonObject): JsonObject | null {
const currentEntries = isObject(current.state) ? current.state.entries : null;
const legacyEntries = isObject(legacy.state) ? legacy.state.entries : null;
if (!Array.isArray(currentEntries) || !Array.isArray(legacyEntries)) return null;
if (current.version !== legacy.version) return null;
const ids = new Set(currentEntries.map((entry) => (isObject(entry) ? entry.id : undefined)));
const added = legacyEntries.filter((entry) => isObject(entry) && !ids.has(entry.id));
const state = isObject(current.state) ? current.state : {};
return {
...current,
state: { ...state, entries: [...currentEntries, ...added].slice(0, MAX_STASH_ENTRIES) },
};
}
function mergeComposerDrafts(current: JsonObject, legacy: JsonObject): JsonObject | null {
if (current.version !== legacy.version) return null;
if (!isObject(current.state) || !isObject(legacy.state)) return null;
const state: JsonObject = { ...current.state };
for (const field of DRAFT_RECORD_FIELDS) {
const currentRecord = state[field];
const legacyRecord = legacy.state[field];
if (!isObject(currentRecord) || !isObject(legacyRecord)) return null;
state[field] = { ...legacyRecord, ...currentRecord };
}
return { ...current, state };
}
const isMergedKey = (key: string) => key === PROMPT_STASH_KEY || key === COMPOSER_DRAFTS_KEY;
function mergeValue(key: string, current: string, legacy: string): string | null {
const merge =
key === PROMPT_STASH_KEY
? mergePromptStash
: key === COMPOSER_DRAFTS_KEY
? mergeComposerDrafts
: null;
if (merge === null) return null;
const currentObject = parseObject(current);
const legacyObject = parseObject(legacy);
if (currentObject === null || legacyObject === null) return null;
const merged = merge(currentObject, legacyObject);
return merged === null ? null : JSON.stringify(merged);
}
export function mergeLegacyLocalStorage(
storage: MergeStorage,
legacyItems: Readonly<Record<string, string>>,
): boolean {
let complete = true;
// Stash and drafts first, so a full quota costs layout state rather than prompts.
const keys = Object.keys(legacyItems).sort(
(left, right) => Number(isMergedKey(right)) - Number(isMergedKey(left)),
);
for (const key of keys) {
if (NOT_IMPORTED_KEYS.has(key)) continue;
const legacy = legacyItems[key]!;
const current = storage.getItem(key);
const next = current === null ? legacy : mergeValue(key, current, legacy);
if (next === null || next === current) continue;
try {
storage.setItem(key, next);
} catch {
complete = false;
}
}
return complete;
}