silosdk 0.0.8 → 0.0.9

package/README.md

@@ -223,6 +223,18 @@ const { data: uri } = useQuery(media.queryOptions(post.coverImage))
 `media.queryOptions()` returns `string | null`. It returns `null` when the ref is
 empty, invalid, unknown, or missing on disk.
 
+Delete a media ref when your app no longer stores it:
+
+```tsx
+const deleteMedia = useMutation(media.deleteMutationOptions({ queryClient }))
+
+await deleteMedia.mutateAsync(coverImage)
+```
+
+Deletion removes Silo's copied file and media mapping only. Remove the ref from
+your own source rows or settings separately. Invalid or unknown refs are safe and
+return `false`.
+
 ## API Shape
 
 Silo exposes definition objects and option factories:
@@ -234,6 +246,7 @@ useQuery(theme.queryOptions())
 useMutation(theme.mutationOptions({ queryClient }))
 useQuery(media.queryOptions(ref))
 useMutation(media.mutationOptions({ queryClient }))
+useMutation(media.deleteMutationOptions({ queryClient }))
 ```
 
 There is no Silo provider and no Silo hook wrapper API.

package/dist/media.cjs

@@ -25,6 +25,23 @@ const media = {
 				return imported.ref;
 			}
 		});
+	},
+	delete(ref) {
+		return deleteMedia(ref);
+	},
+	deleteMutationOptions(options = {}) {
+		return (0, __tanstack_react_query.mutationOptions)({
+			mutationKey: [
+				"silo",
+				"media",
+				"delete"
+			],
+			mutationFn: async (ref) => {
+				const deleted = await deleteMedia(ref);
+				if (isMediaRef(ref)) options.queryClient?.setQueryData(mediaQueryKey(ref), null);
+				return deleted;
+			}
+		});
 	}
 };
 function isMediaRef(value) {
@@ -71,10 +88,22 @@ async function importMedia(input) {
 }
 function resolveMediaUri(ref) {
 	if (!isMediaRef(ref)) return null;
-	const row = getDatabase().getFirstSync(`SELECT ref, uri FROM media_files WHERE ref = ?`, [ref]);
+	const row = getMediaFile(ref);
 	if (!row) return null;
 	return new expo_file_system.File(row.uri).exists ? row.uri : null;
 }
+async function deleteMedia(ref) {
+	if (!isMediaRef(ref)) return false;
+	const row = getMediaFile(ref);
+	if (!row) return false;
+	const file = new expo_file_system.File(row.uri);
+	if (file.exists) await file.delete();
+	deleteMediaFileRow(ref);
+	return true;
+}
+function getMediaFile(ref) {
+	return getDatabase().getFirstSync(`SELECT ref, uri FROM media_files WHERE ref = ?`, [ref]);
+}
 function createMediaRef(kind, id) {
 	return `media://silo/${kindDirectoryName(kind)}/${id}`;
 }
@@ -129,6 +158,9 @@ function insertMediaFile(file) {
 		JSON.stringify(file.data)
 	]);
 }
+function deleteMediaFileRow(ref) {
+	getDatabase().runSync(`DELETE FROM media_files WHERE ref = ?`, [ref]);
+}
 
 //#endregion
 exports.isMediaRef = isMediaRef;

package/dist/media.d.cts

@@ -16,6 +16,7 @@ type MediaImportInput = {
   mimeType?: string | null;
   data?: MediaData;
 };
+type MediaDeleteInput = MediaRef | string | null | undefined;
 type MediaQueryKey = readonly ['silo', 'media', MediaRef | string | null];
 type MediaMutationOptions = {
   queryClient?: QueryClient;
@@ -23,7 +24,9 @@ type MediaMutationOptions = {
 declare const media: {
   queryOptions(ref: MediaRef | string | null | undefined): UseQueryOptions<string | null, Error, string | null, MediaQueryKey>;
   mutationOptions(options?: MediaMutationOptions): UseMutationOptions<MediaRef, Error, MediaImportInput>;
+  delete(ref: MediaDeleteInput): Promise<boolean>;
+  deleteMutationOptions(options?: MediaMutationOptions): UseMutationOptions<boolean, Error, MediaDeleteInput>;
 };
 declare function isMediaRef(value: unknown): value is MediaRef;
 //#endregion
-export { MediaData, MediaImportInput, MediaJson, MediaKind, MediaMutationOptions, MediaQueryKey, MediaRef, isMediaRef, media };
+export { MediaData, MediaDeleteInput, MediaImportInput, MediaJson, MediaKind, MediaMutationOptions, MediaQueryKey, MediaRef, isMediaRef, media };

package/dist/media.d.mts

@@ -16,6 +16,7 @@ type MediaImportInput = {
   mimeType?: string | null;
   data?: MediaData;
 };
+type MediaDeleteInput = MediaRef | string | null | undefined;
 type MediaQueryKey = readonly ['silo', 'media', MediaRef | string | null];
 type MediaMutationOptions = {
   queryClient?: QueryClient;
@@ -23,7 +24,9 @@ type MediaMutationOptions = {
 declare const media: {
   queryOptions(ref: MediaRef | string | null | undefined): UseQueryOptions<string | null, Error, string | null, MediaQueryKey>;
   mutationOptions(options?: MediaMutationOptions): UseMutationOptions<MediaRef, Error, MediaImportInput>;
+  delete(ref: MediaDeleteInput): Promise<boolean>;
+  deleteMutationOptions(options?: MediaMutationOptions): UseMutationOptions<boolean, Error, MediaDeleteInput>;
 };
 declare function isMediaRef(value: unknown): value is MediaRef;
 //#endregion
-export { MediaData, MediaImportInput, MediaJson, MediaKind, MediaMutationOptions, MediaQueryKey, MediaRef, isMediaRef, media };
+export { MediaData, MediaDeleteInput, MediaImportInput, MediaJson, MediaKind, MediaMutationOptions, MediaQueryKey, MediaRef, isMediaRef, media };

package/dist/media.mjs

@@ -24,6 +24,23 @@ const media = {
 				return imported.ref;
 			}
 		});
+	},
+	delete(ref) {
+		return deleteMedia(ref);
+	},
+	deleteMutationOptions(options = {}) {
+		return mutationOptions({
+			mutationKey: [
+				"silo",
+				"media",
+				"delete"
+			],
+			mutationFn: async (ref) => {
+				const deleted = await deleteMedia(ref);
+				if (isMediaRef(ref)) options.queryClient?.setQueryData(mediaQueryKey(ref), null);
+				return deleted;
+			}
+		});
 	}
 };
 function isMediaRef(value) {
@@ -70,10 +87,22 @@ async function importMedia(input) {
 }
 function resolveMediaUri(ref) {
 	if (!isMediaRef(ref)) return null;
-	const row = getDatabase().getFirstSync(`SELECT ref, uri FROM media_files WHERE ref = ?`, [ref]);
+	const row = getMediaFile(ref);
 	if (!row) return null;
 	return new File(row.uri).exists ? row.uri : null;
 }
+async function deleteMedia(ref) {
+	if (!isMediaRef(ref)) return false;
+	const row = getMediaFile(ref);
+	if (!row) return false;
+	const file = new File(row.uri);
+	if (file.exists) await file.delete();
+	deleteMediaFileRow(ref);
+	return true;
+}
+function getMediaFile(ref) {
+	return getDatabase().getFirstSync(`SELECT ref, uri FROM media_files WHERE ref = ?`, [ref]);
+}
 function createMediaRef(kind, id) {
 	return `media://silo/${kindDirectoryName(kind)}/${id}`;
 }
@@ -128,6 +157,9 @@ function insertMediaFile(file) {
 		JSON.stringify(file.data)
 	]);
 }
+function deleteMediaFileRow(ref) {
+	getDatabase().runSync(`DELETE FROM media_files WHERE ref = ?`, [ref]);
+}
 
 //#endregion
 export { isMediaRef, media };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "silosdk",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "type": "module",
   "scripts": {
     "build": "tsdown",