craft-native 0.0.237 → 0.0.238

package/dist/index.js

@@ -57,7 +57,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.237";
+var version = "0.0.238";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;
@@ -4981,6 +4981,92 @@ var secureStorage = {
     Object.keys(localStorage).filter((k) => k.startsWith("secure_")).forEach((k) => localStorage.removeItem(k));
   }
 };
+function storageHost(method) {
+  const host2 = getCraftRoot()?.storage;
+  if (typeof host2?.[method] !== "function")
+    throw Object.assign(new Error("This host does not provide native storage"), { code: "STORAGE_UNSUPPORTED" });
+  return host2;
+}
+var storage2 = {
+  supportsSetIfAbsent() {
+    const root = getCraftRoot();
+    const caps = root?.capabilities;
+    const supported = Array.isArray(caps) ? caps.includes("storageSetIfAbsent") : caps?.storageSetIfAbsent === true;
+    return supported && typeof root?.storage?.setIfAbsent === "function";
+  },
+  supportsCompareAndSet() {
+    const root = getCraftRoot();
+    const caps = root?.capabilities;
+    const supported = Array.isArray(caps) ? caps.includes("storageCompareAndSet") : caps?.storageCompareAndSet === true;
+    return supported && typeof root?.storage?.compareAndSet === "function";
+  },
+  async get(key) {
+    return storageHost("get").get(key);
+  },
+  async set(key, value) {
+    return storageHost("set").set(key, value);
+  },
+  async remove(key) {
+    return storageHost("remove").remove(key);
+  },
+  async clear() {
+    return storageHost("clear").clear();
+  },
+  async keys() {
+    return storageHost("keys").keys();
+  },
+  async setIfAbsent(key, value) {
+    if (!storage2.supportsSetIfAbsent())
+      throw Object.assign(new Error("This app build cannot atomically register an intent"), { code: "STORAGE_SET_IF_ABSENT_UNSUPPORTED" });
+    if (typeof key !== "string" || !key.trim() || JSON.stringify(value) === undefined)
+      throw Object.assign(new Error("setIfAbsent needs a key and JSON value"), { code: "INVALID_ARGUMENT" });
+    return storageHost("setIfAbsent").setIfAbsent(key, value);
+  },
+  async compareAndSet(key, expectedValue, nextValue) {
+    if (!storage2.supportsCompareAndSet())
+      throw Object.assign(new Error("This app build cannot atomically checkpoint existing storage"), { code: "STORAGE_COMPARE_AND_SET_UNSUPPORTED" });
+    if (typeof key !== "string" || !key.trim() || JSON.stringify(expectedValue) === undefined || JSON.stringify(nextValue) === undefined)
+      throw Object.assign(new Error("compareAndSet needs a key and JSON values"), { code: "INVALID_ARGUMENT" });
+    return storageHost("compareAndSet").compareAndSet(key, expectedValue, nextValue);
+  }
+};
+function recordingOwnershipSupported(namespace) {
+  const root = getCraftRoot();
+  const flag = namespace === "location" ? "locationRecordingOwnership" : "heartRateRecordingOwnership";
+  const caps = root?.capabilities;
+  const advertised = Array.isArray(caps) ? caps.includes(flag) : caps?.[flag] === true;
+  return advertised && ["pauseRecording", "resumeRecording", "stopRecording", "readRecording", "getRecordingState", "acknowledgeRecording"].every((method) => typeof root?.[namespace]?.[method] === "function");
+}
+function recordingIntentSupported(namespace) {
+  const root = getCraftRoot();
+  const flag = namespace === "location" ? "locationRecordingIntentIdentity" : "heartRateRecordingIntentIdentity";
+  const caps = root?.capabilities;
+  const advertised = Array.isArray(caps) ? caps.includes(flag) : caps?.[flag] === true;
+  return advertised && recordingOwnershipSupported(namespace) && typeof root?.[namespace]?.startRecording === "function";
+}
+function validateRecordingStart(namespace, options) {
+  if (!Object.prototype.hasOwnProperty.call(options, "recordingId"))
+    return;
+  if (typeof options.recordingId !== "string" || !options.recordingId.trim())
+    throw Object.assign(new Error("recordingId must be a nonempty recording ID"), { code: "INVALID_ARGUMENT" });
+  if (!recordingIntentSupported(namespace))
+    throw Object.assign(new Error("This app build cannot start the persisted recording intent"), { code: "RECORDING_INTENT_IDENTITY_UNSUPPORTED" });
+}
+function verifyRecordingStart(options, result) {
+  if (options.recordingId !== undefined && result.id !== options.recordingId)
+    throw Object.assign(new Error("The native recording does not match the persisted intent"), { code: "RECORDING_CONFLICT" });
+  return result;
+}
+function validateRecordingOwnership(namespace, options) {
+  if (!options || !Object.prototype.hasOwnProperty.call(options, "expectedId"))
+    return;
+  if (typeof options.expectedId !== "string" || !options.expectedId.trim())
+    throw Object.assign(new Error("expectedId must be a nonempty recording ID"), { code: "INVALID_ARGUMENT" });
+  if ((getCraftRoot() || namespace === "heartRate") && !recordingOwnershipSupported(namespace))
+    throw Object.assign(new Error("This app build cannot enforce recording ownership"), { code: "RECORDING_OWNERSHIP_UNSUPPORTED" });
+  if (namespace === "location" && !getCraftRoot() && options.expectedId !== webLocationRecording.id)
+    throw Object.assign(new Error("The active location recording has changed"), { code: "RECORDING_CONFLICT" });
+}
 var webLocationRecording = {
   id: null,
   active: false,
@@ -4990,6 +5076,8 @@ var webLocationRecording = {
 };
 var webLocationRecordingWatchId = null;
 var location = {
+  supportsRecordingOwnership: () => recordingOwnershipSupported("location"),
+  supportsRecordingIntentIdentity: () => recordingIntentSupported("location"),
   async getCurrentPosition(options = {}) {
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location) {
@@ -5038,9 +5126,12 @@ var location = {
     navigator.geolocation.clearWatch(watchId);
   },
   async startRecording(options = {}) {
+    validateRecordingStart("location", options);
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location?.startRecording)
-      return craft.location.startRecording(options);
+      return verifyRecordingStart(options, await craft.location.startRecording(options));
+    if (webLocationRecording.active)
+      throw Object.assign(new Error("A location recording is already active"), { code: "RECORDING_ALREADY_ACTIVE" });
     if (webLocationRecordingWatchId !== null)
       navigator.geolocation.clearWatch(webLocationRecordingWatchId);
     webLocationRecording = {
@@ -5056,24 +5147,27 @@ var location = {
     }, options);
     return { ...webLocationRecording, sampleCount: 0 };
   },
-  async pauseRecording() {
+  async pauseRecording(options) {
+    validateRecordingOwnership("location", options);
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location?.pauseRecording)
-      return craft.location.pauseRecording();
+      return craft.location.pauseRecording(options);
     webLocationRecording.paused = true;
     return { ...webLocationRecording, sampleCount: webLocationRecording.locations.length };
   },
-  async resumeRecording() {
+  async resumeRecording(options) {
+    validateRecordingOwnership("location", options);
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location?.resumeRecording)
-      return craft.location.resumeRecording();
+      return craft.location.resumeRecording(options);
     webLocationRecording.paused = false;
     return { ...webLocationRecording, sampleCount: webLocationRecording.locations.length };
   },
-  async stopRecording() {
+  async stopRecording(options) {
+    validateRecordingOwnership("location", options);
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location?.stopRecording)
-      return craft.location.stopRecording();
+      return craft.location.stopRecording(options);
     if (webLocationRecordingWatchId !== null) {
       location.clearWatch(webLocationRecordingWatchId);
       webLocationRecordingWatchId = null;
@@ -5082,16 +5176,30 @@ var location = {
     webLocationRecording.paused = false;
     return { ...webLocationRecording, locations: [...webLocationRecording.locations] };
   },
-  async getRecordingState() {
+  async getRecordingState(options) {
+    validateRecordingOwnership("location", options);
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location?.getRecordingState)
-      return craft.location.getRecordingState();
+      return craft.location.getRecordingState(options);
     return { ...webLocationRecording, sampleCount: webLocationRecording.locations.length };
   },
-  async readRecording() {
+  async acknowledgeRecording(options) {
+    if (!options || !Object.prototype.hasOwnProperty.call(options, "expectedId"))
+      throw Object.assign(new Error("Acknowledgement needs expectedId"), { code: "INVALID_ARGUMENT" });
+    validateRecordingOwnership("location", options);
+    const craft = getCraftMobile();
+    if (craft?.location?.acknowledgeRecording)
+      return craft.location.acknowledgeRecording(options);
+    if (webLocationRecording.active)
+      throw Object.assign(new Error("The recording is still active"), { code: "RECORDING_ALREADY_ACTIVE" });
+    webLocationRecording = { id: null, active: false, paused: false, startedAt: null, locations: [] };
+    return true;
+  },
+  async readRecording(options) {
+    validateRecordingOwnership("location", options);
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location?.readRecording)
-      return craft.location.readRecording();
+      return craft.location.readRecording(options);
     return [...webLocationRecording.locations];
   }
 };
@@ -5213,6 +5321,11 @@ function onCraftEvent(eventName, callback) {
   globalThis.addEventListener(eventName, listener);
   return () => globalThis.removeEventListener(eventName, listener);
 }
+function getCraftRoot() {
+  if (typeof window === "undefined")
+    return;
+  return window.craft;
+}
 function detectPlatform2() {
   if (typeof window === "undefined")
     return "linux";
@@ -11296,6 +11409,7 @@ export {
   styles,
   style,
   storeKit,
+  storage2 as storage,
   stat,
   startupTask,
   stageManager,

package/dist/ios/src/index.d.ts

@@ -274,6 +274,11 @@ export interface CraftTab {
     title: string;
     /** An SF Symbol name. */
     symbol?: string;
+    /** Native selected-tab icon overrides; retained pushed screens keep their owning tab's policy. */
+    selectedSymbol?: string;
+    selectedIconTint?: string;
+    /** False suppresses the legacy pulse while selected; omission uses the legacy policy. */
+    selectedIconPulse?: boolean;
 }
 /** `/a//b/?q#h` → `/a/b`, the way the shell and the page compare paths. Null for a relative path. */
 export declare function normalizeNativePath(raw: string): string | null;

package/dist/ios/src/index.js

@@ -133,13 +133,19 @@ function initSimulatorDriver(options) {
     throw new Error("The simulator driver requires iOS 17.0 or newer");
   if (!["http:", "https:"].includes(new URL(control).protocol))
     throw new Error("controlUrl must use HTTP or HTTPS");
+  const tabIdentifiers = Object.entries(options.tabIdentifiers ?? {});
+  for (const [name2, identifier] of tabIdentifiers) {
+    if (!name2.trim() || !identifier.trim())
+      throw new Error("Tab names and native identifiers must be nonempty");
+  }
   const replacements = {
     PROJECT_NAME: name,
     BUNDLE_PREFIX: prefix,
     IOS_VERSION: version,
     BUNDLE_ID: swiftString(bundleId),
     CONTROL_URL: swiftString(control),
-    TABS: `[${(options.tabs ?? []).map(swiftString).join(", ")}]`
+    TABS: `[${(options.tabs ?? []).map(swiftString).join(", ")}]`,
+    TAB_IDENTIFIERS: tabIdentifiers.length ? `[${tabIdentifiers.map(([name2, identifier]) => `${swiftString(name2)}: ${swiftString(identifier)}`).join(", ")}]` : "[:]"
   };
   for (const [source, destination] of [
     ["HostApp.swift", "Host/HostApp.swift"],
@@ -1141,6 +1147,8 @@ function writeShell(output, config) {
   cpSync(join3(TEMPLATES_DIR, "CraftMusic.swift"), join3(output, "Sources", "CraftMusic.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftBluetooth.swift"), join3(output, "Sources", "CraftBluetooth.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftHeartRate.swift"), join3(output, "Sources", "CraftHeartRate.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftRecordingArchive.swift"), join3(output, "Sources", "CraftRecordingArchive.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftPersistentStorage.swift"), join3(output, "Sources", "CraftPersistentStorage.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftScheduledWorkouts.swift"), join3(output, "Sources", "CraftScheduledWorkouts.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftNativeMutation.swift"), join3(output, "Sources", "CraftNativeMutation.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftNativeUI.swift"), join3(output, "Sources", "CraftNativeUI.swift"));

package/dist/ios/src/testing.d.ts

@@ -7,6 +7,8 @@ export interface SimulatorDriverOptions {
     deploymentTarget?: string;
     controlUrl?: string;
     tabs?: readonly string[];
+    /** Stable native accessibility identifiers for tabs whose labels can change. */
+    tabIdentifiers?: Readonly<Record<string, string>>;
     /** Bundle a wire-protocol journey and save native XCTest attachments. No control server is needed on physical devices. */
     script?: string;
 }