@seedprotocol/react 0.4.15

package/dist/item.d.ts

@@ -0,0 +1,42 @@
+import { Item, ModelValues, IItem } from '@seedprotocol/sdk';
+type UseItemReturn<T extends ModelValues<T>> = {
+    item: IItem<T> | undefined;
+    isLoading: boolean;
+    error: Error | null;
+};
+type UseItemProps = {
+    modelName: string;
+    seedLocalId?: string;
+    seedUid?: string;
+};
+type UseItem = <T extends ModelValues<T>>(props: UseItemProps) => UseItemReturn<T>;
+export declare const useItem: UseItem;
+type UseItemsReturn = {
+    items: IItem<any>[];
+    isLoading: boolean;
+    error: Error | null;
+};
+type UseItemsProps = {
+    modelName?: string;
+    deleted?: boolean;
+    includeEas?: boolean;
+    addressFilter?: 'owned' | 'watched' | 'all';
+};
+type UseItems = (props: UseItemsProps) => UseItemsReturn;
+export declare const useItems: UseItems;
+export type UseCreateItemReturn = {
+    createItem: (modelName: string, itemData?: Record<string, any>) => Promise<Item<any> | undefined>;
+    isLoading: boolean;
+    error: Error | null;
+    resetError: () => void;
+};
+export declare const useCreateItem: () => UseCreateItemReturn;
+type UsePublishItemReturn = {
+    publishItem: (item: Item<any> | undefined) => void;
+    isLoading: boolean;
+    error: Error | null;
+    resetError: () => void;
+};
+export declare const usePublishItem: () => UsePublishItemReturn;
+export {};
+//# sourceMappingURL=item.d.ts.map

package/dist/item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item.d.ts","sourceRoot":"","sources":["../src/item.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6C,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAGnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAa9C,KAAK,aAAa,CAAC,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,IAAI;IAC7C,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;IAC1B,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB,CAAA;AAED,KAAK,YAAY,GAAG;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,KAAK,OAAO,GAAG,CAAC,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,KAAK,aAAa,CAAC,CAAC,CAAC,CAAA;AAElF,eAAO,MAAM,OAAO,EAAE,OA6IrB,CAAA;AAED,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,KAAK,CAAA;CAC5C,CAAA;AAED,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,cAAc,CAAA;AASxD,eAAO,MAAM,QAAQ,EAAE,QAqKtB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAA;IACjG,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,UAAU,EAAE,MAAM,IAAI,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,aAAa,QAAO,mBAyChC,CAAA;AAED,KAAK,oBAAoB,GAAG;IAC1B,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,KAAK,IAAI,CAAA;IAClD,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,UAAU,EAAE,MAAM,IAAI,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,cAAc,QAAO,oBAsDjC,CAAA"}

package/dist/itemProperty.d.ts

@@ -0,0 +1,116 @@
+import { IItemProperty } from '@seedprotocol/sdk';
+type UseItemPropertyReturn = {
+    property: IItemProperty | undefined;
+    isLoading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook to get a specific ItemProperty instance
+ * Can be called in multiple ways:
+ * 1. With seedLocalId/seedUid and propertyName: useItemProperty({ seedLocalId, propertyName }) or useItemProperty({ seedUid, propertyName })
+ * 2. With itemId and propertyName: useItemProperty(itemId, propertyName) or useItemProperty({ itemId, propertyName })
+ *
+ * @overload
+ * @param props - Object with seedLocalId or seedUid, and propertyName
+ * @returns Object with property, isLoading, and error
+ *
+ * @overload
+ * @param props - Object with itemId and propertyName
+ * @returns Object with property, isLoading, and error
+ *
+ * @overload
+ * @param itemId - The item ID (seedLocalId or seedUid)
+ * @param propertyName - The name of the property
+ * @returns Object with property, isLoading, and error
+ */
+export declare function useItemProperty(props: {
+    seedLocalId?: string;
+    seedUid?: string;
+    propertyName: string;
+}): UseItemPropertyReturn;
+export declare function useItemProperty(props: {
+    itemId?: string;
+    propertyName: string;
+}): UseItemPropertyReturn;
+export declare function useItemProperty(itemId: string, propertyName: string): UseItemPropertyReturn;
+type UseDebouncedItemPropertyParams = {
+    seedLocalId?: string;
+    seedUid?: string;
+    propertyName: string;
+} | {
+    itemId: string;
+    propertyName: string;
+};
+type UseDebouncedItemPropertyReturn = {
+    property: IItemProperty | undefined;
+    setValue: (value: string) => void;
+    isLoading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook for real-time ItemProperty updates with debounced persistence.
+ * Updates the display immediately on each change while debouncing writes to the database.
+ * Use this for text inputs and other high-frequency updates.
+ *
+ * @param params - Same as useItemProperty: { seedLocalId, propertyName }, { seedUid, propertyName }, or { itemId, propertyName }
+ * @param debounceMs - Debounce delay for persistence (default: 300)
+ */
+export declare function useDebouncedItemProperty(params: UseDebouncedItemPropertyParams, debounceMs?: number): UseDebouncedItemPropertyReturn;
+type UseItemPropertiesReturn = {
+    properties: IItemProperty[];
+    isLoading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook to get all ItemProperty instances for a specific item
+ * Can be called in multiple ways:
+ * 1. With seedLocalId: useItemProperties({ seedLocalId })
+ * 2. With seedUid: useItemProperties({ seedUid })
+ * 3. With itemId: useItemProperties(itemId)
+ *
+ * Uses useLiveQuery to watch for changes in the metadata table and automatically
+ * updates the returned ItemProperty instances when changes occur.
+ *
+ * @overload
+ * @param props - Object with seedLocalId or seedUid
+ * @returns Object with properties array, isLoading, and error
+ *
+ * @overload
+ * @param itemId - The item ID (seedLocalId or seedUid)
+ * @returns Object with properties array, isLoading, and error
+ */
+export declare function useItemProperties(props: {
+    seedLocalId?: string;
+    seedUid?: string;
+}): UseItemPropertiesReturn;
+export declare function useItemProperties(itemId: string): UseItemPropertiesReturn;
+export type UseCreateItemPropertyProps = {
+    seedLocalId?: string;
+    seedUid?: string;
+    propertyName: string;
+    modelName: string;
+    propertyValue?: any;
+    versionLocalId?: string;
+    versionUid?: string;
+    [key: string]: any;
+};
+export type UseCreateItemPropertyReturn = {
+    create: (props: UseCreateItemPropertyProps) => IItemProperty | undefined;
+    isLoading: boolean;
+    error: Error | null;
+    resetError: () => void;
+};
+/**
+ * Hook to create an ItemProperty with loading and error state.
+ * create(props) creates a new property instance for an item; provide seedLocalId or seedUid, propertyName, and modelName.
+ */
+export declare const useCreateItemProperty: () => UseCreateItemPropertyReturn;
+export type UseDestroyItemPropertyReturn = {
+    destroy: (itemProperty: IItemProperty) => Promise<void>;
+    isLoading: boolean;
+    error: Error | null;
+    resetError: () => void;
+};
+export declare const useDestroyItemProperty: () => UseDestroyItemPropertyReturn;
+export {};
+//# sourceMappingURL=itemProperty.d.ts.map

package/dist/itemProperty.d.ts.map

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

package/dist/liveQuery.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Hook to execute a reactive query that emits new results whenever the underlying data changes.
+ *
+ * Supports two usage patterns:
+ * 1. SQL tag function: useLiveQuery((sql) => sql`SELECT * FROM models`)
+ * 2. Drizzle query builder: useLiveQuery(db.select().from(models))
+ *
+ * @param query - SQL query function or Drizzle query builder, or null/undefined to disable the query
+ * @returns Array of query results, or undefined if not yet loaded
+ *
+ * @example
+ * ```typescript
+ * // Using SQL tag function
+ * const models = useLiveQuery<ModelRow>(
+ *   (sql) => sql`SELECT * FROM models WHERE schema_file_id = ${schemaId}`
+ * )
+ *
+ * // Using Drizzle query builder
+ * import { models } from '@seedprotocol/sdk'
+ * import { eq } from 'drizzle-orm'
+ *
+ * const appDb = BaseDb.getAppDb()
+ * const models = useLiveQuery<ModelRow>(
+ *   appDb.select().from(models).where(eq(models.schemaFileId, schemaId))
+ * )
+ * ```
+ */
+export declare function useLiveQuery<T>(query: ((sql: any) => any) | any | null | undefined): T[] | undefined;
+//# sourceMappingURL=liveQuery.d.ts.map

package/dist/liveQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveQuery.d.ts","sourceRoot":"","sources":["../src/liveQuery.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,CAAC,GAAG,GAAG,GAAG,IAAI,GAAG,SAAS,GAClD,CAAC,EAAE,GAAG,SAAS,CAoEjB"}

package/dist/model.d.ts

@@ -0,0 +1,48 @@
+import { Model } from '@seedprotocol/sdk';
+type UseModelsResult = {
+    models: Model[];
+    isLoading: boolean;
+    error: Error | null;
+};
+type UseModelsParams = string | null | undefined;
+type UseModels = (schemaId: UseModelsParams) => UseModelsResult;
+export declare const useModels: UseModels;
+type UseModelResult = {
+    model: Model | undefined;
+    isLoading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook to get a specific Model instance
+ * Can be called in two ways:
+ * 1. With schemaId and modelName: useModel(schemaId, modelName)
+ * 2. With modelId: useModel(modelId)
+ *
+ * @param schemaIdOrModelId - The schema ID (schema file ID) OR the model ID (modelFileId)
+ * @param modelName - The name of the model to retrieve (required if first param is schemaId)
+ * @returns Object with model, isLoading, and error
+ */
+export declare const useModel: (schemaIdOrModelId: string | null | undefined, modelName?: string | null | undefined) => UseModelResult;
+export type UseCreateModelOptions = {
+    modelFileId?: string;
+    properties?: {
+        [propertyName: string]: any;
+    };
+    registerWithSchema?: boolean;
+};
+export type UseCreateModelReturn = {
+    create: (schemaName: string, modelName: string, options?: UseCreateModelOptions) => Model;
+    isLoading: boolean;
+    error: Error | null;
+    resetError: () => void;
+};
+export declare const useCreateModel: () => UseCreateModelReturn;
+export type UseDestroyModelReturn = {
+    destroy: (model: Model) => Promise<void>;
+    isLoading: boolean;
+    error: Error | null;
+    resetError: () => void;
+};
+export declare const useDestroyModel: () => UseDestroyModelReturn;
+export {};
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AASzC,KAAK,eAAe,GAAG;IACrB,MAAM,EAAE,KAAK,EAAE,CAAA;IACf,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB,CAAA;AAED,KAAK,eAAe,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;AAEhD,KAAK,SAAS,GAAG,CAAC,QAAQ,EAAE,eAAe,KAAK,eAAe,CAAA;AAc/D,eAAO,MAAM,SAAS,EAAE,SAqJvB,CAAA;AAED,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,KAAK,GAAG,SAAS,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,GACnB,mBAAmB,MAAM,GAAG,IAAI,GAAG,SAAS,EAC5C,YAAY,MAAM,GAAG,IAAI,GAAG,SAAS,KACpC,cAmIF,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE;QAAE,CAAC,YAAY,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAA;IAC5C,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,CACN,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,qBAAqB,KAC5B,KAAK,CAAA;IACV,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,UAAU,EAAE,MAAM,IAAI,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,cAAc,QAAO,oBAiDjC,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,UAAU,EAAE,MAAM,IAAI,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,eAAe,QAAO,qBA4ClC,CAAA"}

package/dist/modelProperty.d.ts

@@ -0,0 +1,82 @@
+import { ModelProperty } from '@seedprotocol/sdk';
+type UseModelPropertiesResult = {
+    modelProperties: ModelProperty[];
+    isLoading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook to get all ModelProperty instances for a specific model
+ * Can be called in two ways:
+ * 1. With schemaId and modelName: useModelProperties(schemaId, modelName)
+ * 2. With modelId: useModelProperties(modelId)
+ *
+ * Uses useLiveQuery to watch for changes in the properties table and automatically
+ * updates the returned ModelProperty instances when changes occur.
+ *
+ * @param schemaIdOrModelId - The schema ID (schema file ID) OR the model ID (modelFileId)
+ * @param modelName - The name of the model to get properties from (required if first param is schemaId)
+ * @returns Object with modelProperties array, isLoading, and error
+ */
+export declare const useModelProperties: (schemaIdOrModelId: string | null | undefined, modelName?: string | null | undefined) => UseModelPropertiesResult;
+/**
+ * Hook to get a specific ModelProperty instance
+ * Can be called in three ways:
+ * 1. With propertyFileId: useModelProperty(propertyFileId)
+ * 2. With modelFileId and propertyName: useModelProperty(modelFileId, propertyName)
+ * 3. With schemaId, modelName, and propertyName: useModelProperty(schemaId, modelName, propertyName)
+ *
+ * @overload
+ * @param propertyFileId - The property file ID (schemaFileId)
+ * @returns Object with modelProperty, isLoading, and error
+ *
+ * @overload
+ * @param modelFileId - The model file ID (modelFileId)
+ * @param propertyName - The name of the property
+ * @returns Object with modelProperty, isLoading, and error
+ *
+ * @overload
+ * @param schemaId - The schema ID (schema file ID)
+ * @param modelName - The name of the model
+ * @param propertyName - The name of the property
+ * @returns Object with modelProperty, isLoading, and error
+ */
+export declare function useModelProperty(propertyFileId: string): {
+    modelProperty: ModelProperty | undefined;
+    isLoading: boolean;
+    error: Error | null;
+};
+export declare function useModelProperty(modelFileId: string, propertyName: string): {
+    modelProperty: ModelProperty | undefined;
+    isLoading: boolean;
+    error: Error | null;
+};
+export declare function useModelProperty(schemaId: string, modelName: string, propertyName: string): {
+    modelProperty: ModelProperty | undefined;
+    isLoading: boolean;
+    error: Error | null;
+};
+export type UseCreateModelPropertyOptions = {
+    name: string;
+    dataType: string;
+    [key: string]: any;
+};
+export type UseCreateModelPropertyReturn = {
+    create: (schemaId: string, modelName: string, property: UseCreateModelPropertyOptions) => ModelProperty;
+    isLoading: boolean;
+    error: Error | null;
+    resetError: () => void;
+};
+/**
+ * Hook to create a ModelProperty with loading and error state.
+ * create(schemaId, modelName, property) creates a new property on the model.
+ */
+export declare const useCreateModelProperty: () => UseCreateModelPropertyReturn;
+export type UseDestroyModelPropertyReturn = {
+    destroy: (modelProperty: ModelProperty) => Promise<void>;
+    isLoading: boolean;
+    error: Error | null;
+    resetError: () => void;
+};
+export declare const useDestroyModelProperty: () => UseDestroyModelPropertyReturn;
+export {};
+//# sourceMappingURL=modelProperty.d.ts.map

package/dist/modelProperty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelProperty.d.ts","sourceRoot":"","sources":["../src/modelProperty.ts"],"names":[],"mappings":"AAIA,OAAO,EAAqB,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAcpE,KAAK,wBAAwB,GAAG;IAC9B,eAAe,EAAE,aAAa,EAAE,CAAA;IAChC,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,GAC7B,mBAAmB,MAAM,GAAG,IAAI,GAAG,SAAS,EAC5C,YAAY,MAAM,GAAG,IAAI,GAAG,SAAS,KACpC,wBAsHF,CAAA;AAyBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG;IACxD,aAAa,EAAE,aAAa,GAAG,SAAS,CAAA;IACxC,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB,CAAA;AACD,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB;IACD,aAAa,EAAE,aAAa,GAAG,SAAS,CAAA;IACxC,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB,CAAA;AACD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB;IACD,aAAa,EAAE,aAAa,GAAG,SAAS,CAAA;IACxC,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB,CAAA;AA4LD,MAAM,MAAM,6BAA6B,GAAG;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,CACN,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,6BAA6B,KACpC,aAAa,CAAA;IAClB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,UAAU,EAAE,MAAM,IAAI,CAAA;CACvB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAO,4BA8DzC,CAAA;AAED,MAAM,MAAM,6BAA6B,GAAG;IAC1C,OAAO,EAAE,CAAC,aAAa,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxD,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,UAAU,EAAE,MAAM,IAAI,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,uBAAuB,QAAO,6BA4C1C,CAAA"}

package/dist/queryClient.d.ts

@@ -0,0 +1,28 @@
+import { QueryClient, DefaultOptions, QueryClientConfig } from '@tanstack/react-query';
+/**
+ * Returns the default options used by Seed for list-query caching.
+ * Use this when building your own QueryClient so Seed hooks get consistent behavior.
+ */
+export declare function getSeedQueryDefaultOptions(): DefaultOptions;
+/**
+ * Merges Seed's default query options with your existing default options.
+ * Your options take precedence over Seed's. Use when constructing your own QueryClient:
+ *
+ * @example
+ * ```ts
+ * const client = new QueryClient({
+ *   defaultOptions: mergeSeedQueryDefaults({
+ *     queries: { gcTime: 1000 * 60 * 60 },
+ *   }),
+ * })
+ * ```
+ */
+export declare function mergeSeedQueryDefaults(userOptions?: Partial<DefaultOptions> | null): DefaultOptions;
+/**
+ * Creates a QueryClient configured with Seed's default options.
+ * Use this when you want to provide your own QueryClientProvider but still use Seed's defaults.
+ *
+ * @param overrides - Optional config to merge with Seed defaults (e.g. defaultOptions, logger).
+ */
+export declare function createSeedQueryClient(overrides?: Partial<QueryClientConfig>): QueryClient;
+//# sourceMappingURL=queryClient.d.ts.map

package/dist/queryClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryClient.d.ts","sourceRoot":"","sources":["../src/queryClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,cAAc,EAEnB,KAAK,iBAAiB,EAEvB,MAAM,uBAAuB,CAAA;AAU9B;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,cAAc,CAE3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,GAC3C,cAAc,CAahB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,WAAW,CASzF"}

package/dist/schema.d.ts

@@ -0,0 +1,45 @@
+import { Schema } from '@seedprotocol/sdk';
+/**
+ * Hook to get a Schema class instance (with setters) that is reactive
+ * This allows you to edit schema properties directly like: schema.name = 'New name'
+ * The schema instance uses a Proxy to ensure React re-renders when properties change
+ * @param schemaIdentifier - The name of the schema or the schema file ID
+ *   - If a name is provided, retrieves the latest version with that name
+ *   - If an ID is provided, retrieves the specific schema by ID
+ * @returns Object with schema instance
+ */
+export declare const useSchema: (schemaIdentifier: string | null | undefined) => {
+    schema: Schema | null;
+    isLoading: boolean;
+    error: Error | null;
+};
+export declare const useSchemas: () => {
+    schemas: Schema[];
+    isLoading: boolean;
+    error: Error | null;
+};
+export declare const useCreateSchema: () => {
+    createSchema: (schemaName: string) => Schema;
+    isLoading: boolean;
+    error: Error | null;
+    resetError: () => void;
+};
+export type UseDestroySchemaReturn = {
+    destroy: (schema: Schema) => Promise<void>;
+    isLoading: boolean;
+    error: Error | null;
+    resetError: () => void;
+};
+export declare const useDestroySchema: () => UseDestroySchemaReturn;
+export declare const useAllSchemaVersions: () => Schema[] | null | undefined;
+/**
+ * Hook to get the internal Seed Protocol schema (SDK-only schema)
+ * This schema is managed by the SDK and should not be edited by app developers
+ * @returns Object with schema instance and schemaData (version, metadata, etc.)
+ */
+export declare const useSeedProtocolSchema: () => {
+    schema: Schema | null;
+    isLoading: boolean;
+    error: Error | null;
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAW1C;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,GAAI,kBAAkB,MAAM,GAAG,IAAI,GAAG,SAAS;;;;CAsFpE,CAAA;AAID,eAAO,MAAM,UAAU;;;WAmGE,KAAK,GAAG,IAAI;CAEpC,CAAA;AAED,eAAO,MAAM,eAAe;+BAOoB,MAAM;;;;CAoCrD,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1C,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,UAAU,EAAE,MAAM,IAAI,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,gBAAgB,QAAO,sBA4CnC,CAAA;AAED,eAAO,MAAM,oBAAoB,mCA2EhC,CAAA;AAKD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;CAEjC,CAAA"}

package/dist/services.d.ts

@@ -0,0 +1,24 @@
+import { ActorRef } from 'xstate';
+import { ClientManagerState } from '@seedprotocol/sdk';
+export declare const getServiceName: (service: ActorRef<any, any>) => string;
+export declare const getServiceValue: (service: ActorRef<any, any>) => string | undefined;
+export declare const getServiceUniqueKey: (service: ActorRef<any, any>) => any;
+export declare const useService: (service: ActorRef<any, any>) => {
+    name: string;
+    timeElapsed: number;
+    value: string | undefined;
+    percentComplete: number;
+    uniqueKey: any;
+};
+export declare const useIsDbReady: () => boolean;
+export declare const usePersistedSnapshots: () => void;
+export declare const useHasSavedSnapshots: () => boolean;
+export declare const useServices: () => {
+    services: ActorRef<any, any, import('xstate').EventObject>[];
+    percentComplete: number;
+};
+export declare const useGlobalServiceStatus: () => {
+    status: ClientManagerState;
+    internalStatus: string;
+};
+//# sourceMappingURL=services.d.ts.map

package/dist/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../src/services.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAuB,MAAM,QAAQ,CAAA;AAStD,OAAO,EAAsB,kBAAkB,EAAa,MAAM,mBAAmB,CAAA;AAMrF,eAAO,MAAM,cAAc,GAAI,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,WAUzD,CAAA;AAED,eAAO,MAAM,eAAe,GAC1B,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,KAC1B,MAAM,GAAG,SAmBX,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,QAiC9D,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;;;;;;CAoErD,CAAA;AAED,eAAO,MAAM,YAAY,eAmBxB,CAAA;AAED,eAAO,MAAM,qBAAqB,YAqDjC,CAAA;AAED,eAAO,MAAM,oBAAoB,eAyBhC,CAAA;AAED,eAAO,MAAM,WAAW;;;CAiDvB,CAAA;AAED,eAAO,MAAM,sBAAsB;;;CA2BlC,CAAA"}

package/dist/trash.d.ts

@@ -0,0 +1,9 @@
+import { Item } from '@seedprotocol/sdk';
+export type UseDeleteItemReturn = {
+    deleteItem: (item: Item<any>) => Promise<void>;
+    isLoading: boolean;
+    error: Error | null;
+    resetError: () => void;
+};
+export declare const useDeleteItem: () => UseDeleteItemReturn;
+//# sourceMappingURL=trash.d.ts.map

package/dist/trash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trash.d.ts","sourceRoot":"","sources":["../src/trash.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAExC,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,UAAU,EAAE,MAAM,IAAI,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,aAAa,QAAO,mBA4ChC,CAAA"}

package/dist/useFiles.d.ts

@@ -0,0 +1,22 @@
+export declare const FILES_QUERY_KEY_PREFIX: readonly ["seed", "files"];
+/**
+ * Returns an up-to-date list of filenames stored in the given directory.
+ * Automatically refetches when files are saved (file-saved) or after bulk downloads (fs.downloadAll.success).
+ *
+ * Must be used within SeedProvider and after client.init().
+ *
+ * @param dir - Directory name under the files root (e.g. 'files', 'images'). Default: 'files'.
+ *
+ * @example
+ * ```tsx
+ * const { files, isLoading, error, refetch } = useFiles('files')
+ * // files: ['document.pdf', 'contract.docx']
+ * ```
+ */
+export declare function useFiles(dir?: string): {
+    files: string[];
+    isLoading: boolean;
+    error: Error | null;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<string[], Error>>;
+};
+//# sourceMappingURL=useFiles.d.ts.map

package/dist/useFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFiles.d.ts","sourceRoot":"","sources":["../src/useFiles.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,sBAAsB,4BAA6B,CAAA;AAEhE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,GAAG,GAAE,MAAgB;;;;;EAwC7C"}

package/dist/useImageFiles.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Returns an up-to-date list of image filenames stored in the file system (OPFS in browser).
+ * Automatically refetches when images are saved (file-saved) or after bulk downloads (fs.downloadAll.success).
+ *
+ * Must be used within SeedProvider and after client.init().
+ *
+ * @example
+ * ```tsx
+ * const { imageFiles, isLoading, error, refetch } = useImageFiles()
+ * // imageFiles: ['photo.jpg', 'cover.png']
+ * ```
+ */
+export declare function useImageFiles(): {
+    imageFiles: string[];
+    isLoading: boolean;
+    error: Error | null;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<string[], Error>>;
+};
+//# sourceMappingURL=useImageFiles.d.ts.map

package/dist/useImageFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImageFiles.d.ts","sourceRoot":"","sources":["../src/useImageFiles.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa;;;;;EAsC5B"}

package/dist/useOPFSFiles.d.ts

@@ -0,0 +1,27 @@
+export interface OPFSFile {
+    name: string;
+    path: string;
+    size: number;
+    type: string;
+    lastModified: number;
+}
+export interface UseOPFSFilesOptions {
+    /** Optional subdirectory to scan (e.g. 'app-files'). Default: root. */
+    rootPath?: string;
+}
+/**
+ * Hook to scan and list all files in OPFS (Origin Private File System).
+ * Uses navigator.storage.getDirectory() - works in browsers that support OPFS.
+ *
+ * @example
+ * ```tsx
+ * const { files, isLoading, error, refetch } = useOPFSFiles()
+ * ```
+ */
+export declare function useOPFSFiles(options?: UseOPFSFilesOptions): {
+    files: OPFSFile[];
+    isLoading: boolean;
+    error: string | null;
+    refetch: () => Promise<void>;
+};
+//# sourceMappingURL=useOPFSFiles.d.ts.map

package/dist/useOPFSFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOPFSFiles.d.ts","sourceRoot":"","sources":["../src/useOPFSFiles.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;CACrB;AAqCD,MAAM,WAAW,mBAAmB;IAClC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB;;;;;EAsC7D"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@seedprotocol/react",
+  "version": "0.4.15",
+  "description": "React hooks and components for Seed Protocol",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rimraf dist && vite build",
+    "test": "cd ../.. && vitest run --reporter=default --config vite.config.js --project=browser-react",
+    "test:watch": "cd ../.. && vitest --config vite.config.js --project=browser-react",
+    "test:browser": "cd ../.. && vitest --config vite.config.js --project=browser"
+  },
+  "peerDependencies": {
+    "@seedprotocol/sdk": "^0.4.0",
+    "react": "^18 || ^19",
+    "@tanstack/react-query": "^5"
+  },
+  "dependencies": {
+    "@xstate/react": "^6.1.0",
+    "debug": "^4.4.1",
+    "drizzle-orm": "^0.44.3",
+    "immer": "^11.0.1",
+    "lodash-es": "^4.17.22",
+    "pluralize": "^8.0.0",
+    "rxjs": "^7.8.1",
+    "xstate": "^5.28.0"
+  },
+  "devDependencies": {
+    "@seedprotocol/sdk": "workspace:*",
+    "vite-plugin-dts": "^4.5.4",
+    "@tanstack/react-query": "^5.90.15",
+    "@testing-library/react": "^16.3.1",
+    "@types/react": "^19.0.2",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "rimraf": "^6.0.1",
+    "typescript": "~5.9.3",
+    "vite": "^7.3.0"
+  },
+  "author": "Keith Axline <keith@journodao.xyz>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}