@procedures/ios-backup 0.0.0-stage → 0.4.0

package/dist/backup.js

@@ -0,0 +1,296 @@
+/**
+ * The reader of an iPhone backup in the MobileSync format, without a native dependency.
+ *
+ * A backup folder holds `Manifest.db` and the files of the phone. The name of each file is its
+ * `fileID`, in a subfolder with the first two characters of that name. `Manifest.db` gives the
+ * `fileID` of each domain and relative path. The module reads SQLite with `node:sqlite`.
+ */
+import { existsSync } from "node:fs";
+import { copyFile, mkdtemp, readdir, rm, stat } from "node:fs/promises";
+import { homedir, tmpdir } from "node:os";
+import { join } from "node:path";
+/** The start of the Apple epoch (`2001-01-01T00:00:00Z`), in milliseconds after the Unix epoch. */
+export const APPLE_EPOCH_MS = 978_307_200_000;
+/** The domain of the messages database in `Manifest.db`. */
+export const SMS_DOMAIN = "HomeDomain";
+/** The relative path of the messages database in `Manifest.db`. */
+export const SMS_RELATIVE_PATH = "Library/SMS/sms.db";
+/** An Apple time above this value is in nanoseconds. A time below it is in seconds. */
+const NANOSECOND_THRESHOLD = 1_000_000_000_000;
+/**
+ * The error of a backup that the module cannot read. The `code` tells the cause:
+ * `no-backup` (no backup folder), `encrypted` (`Manifest.db` is not a readable database),
+ * `no-file` (`Manifest.db` does not list the file) or `missing-file` (the folder does not hold the file).
+ */
+export class IosBackupError extends Error {
+    /** The cause of the error. */
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = "IosBackupError";
+        this.code = code;
+    }
+}
+/**
+ * This function gives the default backup folders: the Apple Devices app and iTunes on Windows,
+ * and Finder on macOS. A folder that does not exist gives no backups.
+ */
+export function defaultBackupRoots(home = homedir()) {
+    return [
+        join(home, "Apple", "MobileSync", "Backup"),
+        join(home, "AppData", "Roaming", "Apple Computer", "MobileSync", "Backup"),
+        join(home, "Library", "Application Support", "MobileSync", "Backup"),
+    ];
+}
+/**
+ * This function lists the backup folders in the roots, the newest first. A backup folder is a
+ * subfolder with a `Manifest.db`. The time of `Manifest.db` gives the order.
+ */
+export async function listBackups(roots = defaultBackupRoots()) {
+    const found = [];
+    for (const root of roots) {
+        let entries;
+        try {
+            entries = await readdir(root, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        entries.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+        for (const entry of entries) {
+            if (!entry.isDirectory() && !entry.isSymbolicLink())
+                continue;
+            const path = join(root, entry.name);
+            const info = await stat(join(path, "Manifest.db")).catch(() => undefined);
+            if (info === undefined || !info.isFile())
+                continue;
+            found.push({ path, modifiedAt: info.mtime.toISOString(), mtime: info.mtimeMs });
+        }
+    }
+    // The sort is stable: of two folders with the same time, the first found stays first
+    found.sort((a, b) => b.mtime - a.mtime);
+    return found.map(({ path, modifiedAt }) => ({ path, modifiedAt }));
+}
+/** This function gives the newest backup folder in the roots, or `undefined` when there is none. */
+export async function findLatestBackup(roots) {
+    return (await listBackups(roots))[0]?.path;
+}
+/**
+ * This function changes an Apple time to an ISO 8601 string in UTC, to the second. The value is
+ * in nanoseconds after 2001-01-01 (iOS 11 and later), or in seconds (older databases).
+ */
+export function appleDateToIso(raw) {
+    let ms;
+    if (typeof raw === "bigint") {
+        ms = raw > BigInt(NANOSECOND_THRESHOLD) ? Number(raw / 1000000n) : Number(raw) * 1000;
+    }
+    else {
+        ms = raw > NANOSECOND_THRESHOLD ? raw / 1e6 : raw * 1000;
+    }
+    return new Date(ms + APPLE_EPOCH_MS).toISOString().replace(/\.\d{3}Z$/, "Z");
+}
+/** This function changes an ISO 8601 time to an Apple time in nanoseconds. */
+export function isoToAppleDate(iso) {
+    const ms = Date.parse(iso);
+    if (Number.isNaN(ms))
+        throw new RangeError(`Not a time: ${JSON.stringify(iso)}`);
+    return BigInt(ms - APPLE_EPOCH_MS) * 1000000n;
+}
+/** The class names of the string object in a typedstream. */
+const STRING_CLASSES = ["NSString", "NSMutableString"];
+/** The byte after the text of a string object in a typedstream. */
+const END_OF_OBJECT = 0x86;
+/**
+ * This function gets the plain text from the `attributedBody` column of a message: an
+ * `NSAttributedString` in the typedstream format. It gives `undefined` when the value has no text.
+ */
+export function extractTypedstreamText(body) {
+    const bytes = Buffer.from(body.buffer, body.byteOffset, body.byteLength);
+    let marker = -1;
+    for (const name of STRING_CLASSES) {
+        const at = bytes.indexOf(name, 0, "latin1");
+        if (at !== -1 && (marker === -1 || at < marker))
+            marker = at;
+    }
+    if (marker === -1)
+        return undefined;
+    const plus = bytes.indexOf(0x2b, marker); // "+": the start of the bytes of the string
+    if (plus === -1 || plus + 1 >= bytes.length)
+        return undefined;
+    let start = plus + 1;
+    const first = bytes[start];
+    let length;
+    // A typedstream integer: one byte below 0x80, or 0x81 and 2 bytes, or 0x82 and 4 bytes (little-endian)
+    if (first === 0x81) {
+        length = start + 3 <= bytes.length ? bytes.readUInt16LE(start + 1) : undefined;
+        start += 3;
+    }
+    else if (first === 0x82) {
+        length = start + 5 <= bytes.length ? bytes.readUInt32LE(start + 1) : undefined;
+        start += 5;
+    }
+    else {
+        length = first < 0x80 ? first : undefined;
+        start += 1;
+    }
+    if (start > bytes.length)
+        return undefined;
+    let end;
+    if (length !== undefined && start + length <= bytes.length) {
+        end = start + length;
+    }
+    else {
+        // No length that agrees with the value: the text stops at the end of the object
+        const stop = bytes.indexOf(END_OF_OBJECT, start);
+        end = stop === -1 ? bytes.length : stop;
+    }
+    const text = bytes.subarray(start, end).toString("utf8").trim();
+    return text.length > 0 ? text : undefined;
+}
+/**
+ * This function loads `node:sqlite` at the first read. Thus an import of the package does not
+ * show the experimental warning of `node:sqlite`, and does not fail on an older Node.
+ */
+async function loadSqlite() {
+    try {
+        return await import("node:sqlite");
+    }
+    catch (error) {
+        throw new Error("@procedures/ios-backup needs node:sqlite: use Node 22.13 or later", { cause: error });
+    }
+}
+/** This function gives a new temporary folder to `use`, and deletes the folder after it. */
+async function withScratch(use) {
+    const dir = await mkdtemp(join(tmpdir(), "ios-backup-"));
+    try {
+        return await use(dir);
+    }
+    finally {
+        // On Windows, a file can stay locked for some milliseconds after it closes
+        await rm(dir, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 }).catch(() => undefined);
+    }
+}
+/**
+ * This function finds a file of a backup by its domain and its relative path in `Manifest.db`.
+ * It gives `undefined` when `Manifest.db` does not list the file. It reads a copy of
+ * `Manifest.db` in a temporary folder, and changes nothing in the backup.
+ */
+export async function findBackupFile(backup, domain, relativePath) {
+    const manifest = join(backup, "Manifest.db");
+    if (!existsSync(manifest))
+        throw new IosBackupError("no-backup", `The folder has no Manifest.db: ${backup}`);
+    const { DatabaseSync } = await loadSqlite();
+    const fileId = await withScratch(async (scratch) => {
+        const copy = join(scratch, "Manifest.db");
+        await copyFile(manifest, copy);
+        let db;
+        try {
+            db = new DatabaseSync(copy, { readOnly: true });
+            const row = db.prepare("SELECT fileID FROM Files WHERE domain = ? AND relativePath = ?").get(domain, relativePath);
+            const id = row?.["fileID"];
+            return typeof id === "string" ? id : undefined;
+        }
+        catch (error) {
+            throw new IosBackupError("encrypted", "Cannot read Manifest.db. An encrypted backup gives this error: make a backup without encryption.", { cause: error });
+        }
+        finally {
+            db?.close();
+        }
+    });
+    if (fileId === undefined)
+        return undefined;
+    for (const path of [join(backup, fileId.slice(0, 2), fileId), join(backup, fileId)]) {
+        if (existsSync(path))
+            return { fileId, path };
+    }
+    throw new IosBackupError("missing-file", `Manifest.db lists ${domain}:${relativePath}, but the backup has no file ${fileId}`);
+}
+/** The time of a message in nanoseconds, for the two units of `message.date`. */
+const MESSAGE_NS = `(CASE WHEN m.date > ${NANOSECOND_THRESHOLD} THEN m.date ELSE m.date * 1000000000 END)`;
+/** This function gives the value when it is a string that is not empty. */
+const present = (value) => (value === null || value.length === 0 ? undefined : value);
+/**
+ * This function reads the messages of a messages database (`sms.db` of a backup, or `chat.db` of
+ * macOS), in time order. It opens the file read only. A message without text is not in the result.
+ */
+export async function readSmsDatabase(file, query = {}) {
+    const where = ["m.guid IS NOT NULL", "((m.text IS NOT NULL AND m.text != '') OR m.attributedBody IS NOT NULL)"];
+    const parameters = [];
+    if (query.since !== undefined) {
+        where.push(`${MESSAGE_NS} >= ?`);
+        parameters.push(isoToAppleDate(query.since));
+    }
+    if (query.until !== undefined) {
+        where.push(`${MESSAGE_NS} < ?`);
+        parameters.push(isoToAppleDate(query.until));
+    }
+    const limited = query.limit !== undefined;
+    if (limited)
+        parameters.push(Math.max(0, Math.floor(query.limit)));
+    const sql = `SELECT m.guid AS guid, m.text AS text, m.attributedBody AS body, m.date AS date,
+      m.is_from_me AS is_from_me, m.service AS service, h.id AS handle,
+      c.chat_identifier AS chat_id, c.display_name AS chat_name
+    FROM message m
+    LEFT JOIN handle h ON h.ROWID = m.handle_id
+    LEFT JOIN chat c ON c.ROWID = (
+      SELECT cmj.chat_id FROM chat_message_join cmj WHERE cmj.message_id = m.ROWID ORDER BY cmj.chat_id LIMIT 1
+    )
+    WHERE ${where.join(" AND ")}
+    ORDER BY ${MESSAGE_NS} ${limited ? "DESC" : "ASC"}, m.ROWID ${limited ? "DESC" : "ASC"}
+    ${limited ? "LIMIT ?" : ""}`;
+    const { DatabaseSync } = await loadSqlite();
+    const db = new DatabaseSync(file, { readOnly: true });
+    let rows;
+    try {
+        const statement = db.prepare(sql);
+        statement.setReadBigInts(true);
+        rows = statement.all(...parameters);
+    }
+    finally {
+        db.close();
+    }
+    if (limited)
+        rows.reverse();
+    const messages = [];
+    for (const row of rows) {
+        let text = present(row.text);
+        let fromBody = false;
+        if (text === undefined && row.body !== null) {
+            text = extractTypedstreamText(row.body);
+            fromBody = text !== undefined;
+        }
+        if (text === undefined)
+            continue;
+        const handle = present(row.handle);
+        const service = present(row.service);
+        const chatId = present(row.chat_id);
+        const chatName = present(row.chat_name);
+        messages.push({
+            guid: row.guid,
+            date: appleDateToIso(row.date),
+            text,
+            is_from_me: Number(row.is_from_me ?? 0) === 1,
+            ...(handle === undefined ? {} : { handle }),
+            ...(service === undefined ? {} : { service }),
+            ...(chatId === undefined ? {} : { chat_id: chatId }),
+            ...(chatName === undefined ? {} : { chat_name: chatName }),
+            ...(fromBody ? { from_attributed_body: true } : {}),
+        });
+    }
+    return messages;
+}
+/**
+ * This function reads the messages of a backup folder, in time order. It copies `sms.db` to a
+ * temporary folder, reads the copy and deletes it. It changes nothing in the backup.
+ */
+export async function readMessages(backup, query = {}) {
+    const file = await findBackupFile(backup, SMS_DOMAIN, SMS_RELATIVE_PATH);
+    if (file === undefined)
+        throw new IosBackupError("no-file", `The backup has no messages database (${SMS_RELATIVE_PATH})`);
+    return withScratch(async (scratch) => {
+        const copy = join(scratch, "sms.db");
+        await copyFile(file.path, copy);
+        return readSmsDatabase(copy, query);
+    });
+}
+//# sourceMappingURL=backup.js.map

package/dist/backup.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./module.js";
+export * from "./procedures.js";
+export * from "./backup.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// The root registers nothing: import "<package>/register", or give the module to createRegistry()
+export * from "./module.js";
+export * from "./procedures.js";
+export * from "./backup.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}

package/dist/module.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The procedures of @procedures/ios-backup as data. Importing this file registers nothing.
+ */
+import { type ProcedureModule, type ProcedureRegistry } from "@procedures/client";
+export declare const iosBackupModule: ProcedureModule;
+export default iosBackupModule;
+/**
+ * This function registers the procedures of @procedures/ios-backup in a registry. The default is the
+ * global registry.
+ */
+export declare function registerIosBackupProcedures(registry?: ProcedureRegistry): void;
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAqD,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGrI,eAAO,MAAM,eAAe,EAAE,eAA6E,CAAC;eAE7F,eAAe;AAE9B;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,GAAE,iBAAsC,GAAG,IAAI,CAElG"}

package/dist/module.js

@@ -0,0 +1,15 @@
+/**
+ * The procedures of @procedures/ios-backup as data. Importing this file registers nothing.
+ */
+import { defineModule, registerModules, PROCEDURE_REGISTRY } from "@procedures/client";
+import { iosBackupProcedures } from "./procedures.js";
+export const iosBackupModule = defineModule("@procedures/ios-backup", iosBackupProcedures);
+export default iosBackupModule;
+/**
+ * This function registers the procedures of @procedures/ios-backup in a registry. The default is the
+ * global registry.
+ */
+export function registerIosBackupProcedures(registry = PROCEDURE_REGISTRY) {
+    registerModules(registry, [iosBackupModule]);
+}
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAgD,MAAM,oBAAoB,CAAC;AACrI,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,CAAC,MAAM,eAAe,GAAoB,YAAY,CAAC,wBAAwB,EAAE,mBAAmB,CAAC,CAAC;AAE5G,eAAe,eAAe,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,QAAQ,GAAsB,kBAAkB;IAC1F,eAAe,CAAC,QAAQ,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/procedures.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The procedures of `@procedures/ios-backup`: `iosBackup.find`, `iosBackup.file` and
+ * `iosBackup.messages`. Each one reads files and changes nothing.
+ */
+import { type AnyProcedure } from "@procedures/client";
+export declare const iosBackupFindProcedure: AnyProcedure;
+export declare const iosBackupFileProcedure: AnyProcedure;
+export declare const iosBackupMessagesProcedure: AnyProcedure;
+export declare const iosBackupProcedures: AnyProcedure[];
+//# sourceMappingURL=procedures.d.ts.map

package/dist/procedures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedures.d.ts","sourceRoot":"","sources":["../src/procedures.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAuDpF,eAAO,MAAM,sBAAsB,EAAE,YAgBX,CAAC;AA6B3B,eAAO,MAAM,sBAAsB,EAAE,YAeX,CAAC;AAgC3B,eAAO,MAAM,0BAA0B,EAAE,YAef,CAAC;AAE3B,eAAO,MAAM,mBAAmB,EAAE,YAAY,EAAiF,CAAC"}

package/dist/procedures.js

@@ -0,0 +1,118 @@
+/**
+ * The procedures of `@procedures/ios-backup`: `iosBackup.find`, `iosBackup.file` and
+ * `iosBackup.messages`. Each one reads files and changes nothing.
+ */
+import { createProcedure, zodAdapter } from "@procedures/client";
+import { z } from "zod";
+import { IosBackupError, defaultBackupRoots, findBackupFile, findLatestBackup, listBackups, readMessages, } from "./backup.js";
+/** The procedures read files and change nothing. A copy in a temporary folder is deleted after the read. */
+const READS_FILES = { reads: ["fs"], writes: [] };
+const rootsField = z
+    .array(z.string().min(1))
+    .optional()
+    .describe("The folders that hold the backup folders (default: the MobileSync folders of Windows and macOS)");
+const backupField = z.string().min(1).optional().describe("The backup folder (default: the newest backup in the roots)");
+const timeField = z.string().refine((value) => !Number.isNaN(Date.parse(value)), { message: "Use an ISO 8601 time" });
+const BackupFolderSchema = z.object({ path: z.string(), modifiedAt: z.string() });
+/** This function gives the backup folder of the input, or the newest backup in the roots. */
+async function resolveBackup(input) {
+    if (input.backup !== undefined)
+        return input.backup;
+    const roots = input.roots ?? defaultBackupRoots();
+    const latest = await findLatestBackup(roots);
+    if (latest === undefined) {
+        throw new IosBackupError("no-backup", `No iPhone backup in ${roots.join(", ")}. Make a backup without encryption first.`);
+    }
+    return latest;
+}
+// iosBackup.find
+const FindInputSchema = z.object({ roots: rootsField });
+const FindOutputSchema = z.object({
+    latest: BackupFolderSchema.optional(),
+    backups: z.array(BackupFolderSchema),
+    roots: z.array(z.string()),
+});
+export const iosBackupFindProcedure = createProcedure()
+    .path(["iosBackup", "find"])
+    .input(zodAdapter(FindInputSchema))
+    .output(zodAdapter(FindOutputSchema))
+    .meta({
+    description: "Find the iPhone backups (MobileSync) on this computer, the newest first",
+    args: [],
+    output: "json",
+    effects: READS_FILES,
+})
+    .handler(async (input) => {
+    const roots = input.roots ?? defaultBackupRoots();
+    const backups = await listBackups(roots);
+    const latest = backups[0];
+    return { ...(latest === undefined ? {} : { latest }), backups, roots };
+})
+    .build();
+// iosBackup.file
+const FileInputSchema = z.object({
+    domain: z.string().min(1).describe("The domain of the file in Manifest.db, for example HomeDomain"),
+    relativePath: z.string().min(1).describe("The relative path of the file in its domain, for example Library/SMS/sms.db"),
+    backup: backupField,
+    roots: rootsField,
+});
+const FileOutputSchema = z.object({
+    backup: z.string(),
+    found: z.boolean(),
+    fileId: z.string().optional(),
+    path: z.string().optional(),
+});
+export const iosBackupFileProcedure = createProcedure()
+    .path(["iosBackup", "file"])
+    .input(zodAdapter(FileInputSchema))
+    .output(zodAdapter(FileOutputSchema))
+    .meta({
+    description: "Find a file of an iPhone backup by its domain and relative path in Manifest.db",
+    args: ["domain", "relativePath"],
+    output: "json",
+    effects: READS_FILES,
+})
+    .handler(async (input) => {
+    const backup = await resolveBackup(input);
+    const file = await findBackupFile(backup, input.domain, input.relativePath);
+    return file === undefined ? { backup, found: false } : { backup, found: true, ...file };
+})
+    .build();
+// iosBackup.messages
+const MessagesInputSchema = z.object({
+    backup: backupField,
+    roots: rootsField,
+    since: timeField.optional().describe("Only the messages at this time or after it (ISO 8601)"),
+    until: timeField.optional().describe("Only the messages before this time (ISO 8601)"),
+    limit: z.number().int().positive().optional().describe("Only the newest messages, at most this number"),
+});
+const MessageSchema = z.object({
+    guid: z.string(),
+    date: z.string(),
+    text: z.string(),
+    is_from_me: z.boolean(),
+    handle: z.string().optional(),
+    service: z.string().optional(),
+    chat_id: z.string().optional(),
+    chat_name: z.string().optional(),
+    from_attributed_body: z.boolean().optional(),
+});
+const MessagesOutputSchema = z.object({ backup: z.string(), messages: z.array(MessageSchema) });
+export const iosBackupMessagesProcedure = createProcedure()
+    .path(["iosBackup", "messages"])
+    .input(zodAdapter(MessagesInputSchema))
+    .output(zodAdapter(MessagesOutputSchema))
+    .meta({
+    description: "Read the messages (iMessage and SMS) of an iPhone backup, in time order",
+    args: [],
+    output: "json",
+    effects: READS_FILES,
+})
+    .handler(async (input) => {
+    const backup = await resolveBackup(input);
+    const messages = await readMessages(backup, { since: input.since, until: input.until, limit: input.limit });
+    return { backup, messages };
+})
+    .build();
+export const iosBackupProcedures = [iosBackupFindProcedure, iosBackupFileProcedure, iosBackupMessagesProcedure];
+//# sourceMappingURL=procedures.js.map

package/dist/procedures.js.map

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

package/dist/register.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Importing this file registers the procedures of @procedures/ios-backup in the global registry:
+ * `import "@procedures/ios-backup/register"`. The package root registers nothing.
+ */
+export * from "./module.js";
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,cAAc,aAAa,CAAC"}

package/dist/register.js

@@ -0,0 +1,8 @@
+/**
+ * Importing this file registers the procedures of @procedures/ios-backup in the global registry:
+ * `import "@procedures/ios-backup/register"`. The package root registers nothing.
+ */
+import { registerIosBackupProcedures } from "./module.js";
+export * from "./module.js";
+registerIosBackupProcedures();
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D,cAAc,aAAa,CAAC;AAE5B,2BAA2B,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,81 @@
 {
+  "$schema": "https://json.schemastore.org/package",
   "name": "@procedures/ios-backup",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.4.0",
+  "description": "Read an iPhone backup (MobileSync): find the newest backup, find a file in Manifest.db, read the messages of sms.db. No native dependency.",
+  "keywords": [
+    "iphone",
+    "ios",
+    "backup",
+    "mobilesync",
+    "imessage",
+    "sms",
+    "procedures"
+  ],
+  "homepage": "https://mark1russell7.github.io/client/",
+  "bugs": {
+    "url": "https://github.com/mark1russell7/client/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mark1russell7/client.git",
+    "directory": "packages/ios-backup"
+  },
+  "license": "MIT",
+  "author": "Mark Russell (https://github.com/mark1russell7)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./module": {
+      "types": "./dist/module.d.ts",
+      "import": "./dist/module.js"
+    },
+    "./register": {
+      "types": "./dist/register.d.ts",
+      "import": "./dist/register.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": [
+    "./dist/register.js"
+  ],
+  "engines": {
+    "node": ">=22.13"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@procedures/client": "0.4.0",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "@types/node": "^22.0.0",
+    "@mark1russell7/cue": "^1.0.0",
+    "vitest": "^5.0.3"
+  },
+  "client": {
+    "procedures": "./dist/register.js"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .tsbuildinfo",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
 }