@marktiderman/genesis-core 1.0.0

package/dist/hooks/use-resource-form.d.ts

@@ -0,0 +1,38 @@
+import { UseFormReturn } from 'react-hook-form';
+import { ResourceFormFieldDef } from '../form-types.js';
+
+interface UseResourceFormOptions {
+    resource: string;
+    action: "create" | "edit";
+    id?: string;
+    initialData?: Record<string, unknown>;
+    fields?: ResourceFormFieldDef[];
+    /** Full dataset used to auto-detect select fields from unique values. */
+    listData?: Record<string, unknown>[];
+    onSuccess?: (data: Record<string, unknown>) => void;
+    onError?: (error: Error) => void;
+    /** Pre-fill create form defaults from URL query params. Default true. */
+    prefillFromUrl?: boolean;
+    /** Validation trigger mode. Default "onBlur". */
+    validationMode?: "onBlur" | "onChange" | "onSubmit";
+    /** Enable autosave drafts to localStorage for create mode. */
+    autosave?: boolean | {
+        debounceMs?: number;
+    };
+}
+interface UseResourceFormReturn {
+    form: UseFormReturn<Record<string, unknown>>;
+    resolvedFields: ResourceFormFieldDef[];
+    onSubmit: (e?: {
+        preventDefault?: () => void;
+    }) => Promise<void>;
+    /** Raw save handler — use with form.handleSubmit(handleSave, onInvalid). */
+    handleSave: (data: Record<string, unknown>) => Promise<void>;
+    isSaving: boolean;
+    isLoading: boolean;
+}
+/** Build default values for a single array item from its sub-field definitions */
+declare function buildArrayItemDefaults(arrayFields: ResourceFormFieldDef[]): Record<string, unknown>;
+declare function useResourceForm(options: UseResourceFormOptions): UseResourceFormReturn;
+
+export { type UseResourceFormOptions, type UseResourceFormReturn, buildArrayItemDefaults, useResourceForm };

package/dist/hooks/use-resource-form.js

@@ -0,0 +1,7 @@
+export { buildArrayItemDefaults, useResourceForm } from '../chunk-F4FOTIJI.js';
+import '../chunk-RYEXWQFD.js';
+import '../chunk-PVT6FHAO.js';
+import '../chunk-6V2TIN3G.js';
+import '../chunk-ZYJUEJ4Z.js';
+//# sourceMappingURL=use-resource-form.js.map
+//# sourceMappingURL=use-resource-form.js.map

package/dist/hooks/use-resource-form.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"use-resource-form.js"}

package/dist/hooks/use-resource.d.ts

@@ -0,0 +1,46 @@
+import { UseQueryResult, UseMutationResult } from '@tanstack/react-query';
+import { h as SortParam, F as FilterParam, g as ListResult, L as ListParams, I as Identifier, B as BaseRecord } from '../types-BzcZrTjl.js';
+
+interface UseResourceOptions<T> {
+    defaultSort?: SortParam;
+    defaultFilters?: FilterParam[];
+    defaultPerPage?: number;
+    /** Supabase select/join syntax, e.g. "*, author:profiles(name)". */
+    select?: string;
+    /** Fields to search across when setSearch is called. Required for server-side search. */
+    searchFields?: string[];
+    /** Disable auto-fetching. */
+    enabled?: boolean;
+    onCreateSuccess?: (data: T) => void;
+    onUpdateSuccess?: (data: T) => void;
+    onDeleteSuccess?: () => void;
+    onError?: (error: Error) => void;
+}
+interface UseResourceReturn<T> {
+    /** TanStack Query result for the list query. */
+    list: UseQueryResult<ListResult<T>>;
+    /** Current list params (pagination, sort, filters, search). */
+    params: ListParams;
+    setSort: (sort: SortParam | undefined) => void;
+    setFilters: (filters: FilterParam[]) => void;
+    setPage: (page: number) => void;
+    setPerPage: (perPage: number) => void;
+    setSearch: (query: string) => void;
+    /** Create a new record. Returns the created item. */
+    create: (data: Partial<T>) => Promise<T>;
+    /** Update an existing record by id. Returns the updated item. */
+    update: (id: Identifier, data: Partial<T>) => Promise<T>;
+    /** Delete a record by id. */
+    remove: (id: Identifier) => Promise<void>;
+    /** True when any mutation is in-flight. */
+    isMutating: boolean;
+    createMutation: UseMutationResult<T, Error, Partial<T>>;
+    updateMutation: UseMutationResult<T, Error, {
+        id: Identifier;
+        data: Partial<T>;
+    }>;
+    deleteMutation: UseMutationResult<void, Error, Identifier>;
+}
+declare function useResource<T extends BaseRecord = BaseRecord>(resource: string, options?: UseResourceOptions<T>): UseResourceReturn<T>;
+
+export { type UseResourceOptions, type UseResourceReturn, useResource };

package/dist/hooks/use-resource.js

@@ -0,0 +1,5 @@
+export { useResource } from '../chunk-ZU72FMDR.js';
+import '../chunk-6V2TIN3G.js';
+import '../chunk-ZYJUEJ4Z.js';
+//# sourceMappingURL=use-resource.js.map
+//# sourceMappingURL=use-resource.js.map

package/dist/hooks/use-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"use-resource.js"}

package/dist/hooks/use-wizard.d.ts

@@ -0,0 +1,25 @@
+import { UseFormReturn } from 'react-hook-form';
+
+interface WizardStep {
+    id: string;
+    title: string;
+    description?: string;
+    /** Field keys belonging to this step. */
+    fields: string[];
+}
+interface UseWizardReturn {
+    currentStep: number;
+    currentStepDef: WizardStep;
+    totalSteps: number;
+    /** Progress from 0 to 1. */
+    progress: number;
+    isFirst: boolean;
+    isLast: boolean;
+    /** Validate current step fields, advance if valid. Returns true if valid. */
+    next: () => Promise<boolean>;
+    back: () => void;
+    goTo: (step: number) => void;
+}
+declare function useWizard(steps: WizardStep[], form: UseFormReturn<Record<string, unknown>>): UseWizardReturn;
+
+export { type UseWizardReturn, type WizardStep, useWizard };

package/dist/hooks/use-wizard.js

@@ -0,0 +1,3 @@
+export { useWizard } from '../chunk-7KOLYF27.js';
+//# sourceMappingURL=use-wizard.js.map
+//# sourceMappingURL=use-wizard.js.map

package/dist/hooks/use-wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"use-wizard.js"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { A as ArrayFilter, B as BaseRecord, C as CreateParams, a as CreateResult, D as DataProvider, b as DeleteParams, c as DeleteResult, F as FilterParam, G as GetManyParams, d as GetManyResult, e as GetOneParams, f as GetOneResult, I as Identifier, L as ListParams, g as ListResult, N as NullFilter, P as PaginationParam, R as RangeFilter, S as ScalarFilter, h as SortParam, U as UpdateParams, i as UpdateResult } from './types-BzcZrTjl.js';
+export { DataProviderRoot, DataProviderRootProps, GenesisProvider, GenesisProviderProps, MockProviderOptions, SupabaseClient, createMockProvider, createSupabaseProvider, useDataProvider, useStorage } from './provider/index.js';
+export { S as StorageAdapter } from './types-DKcxHXxq.js';
+export { createLocalStorageAdapter, createMemoryStorageAdapter, createNoopStorageAdapter } from './storage/index.js';
+export { UseResourceOptions, UseResourceReturn, useResource } from './hooks/use-resource.js';
+export { UseOneOptions, useOne } from './hooks/use-one.js';
+export { UseResourceFormOptions, UseResourceFormReturn, buildArrayItemDefaults, useResourceForm } from './hooks/use-resource-form.js';
+export { UseWizardReturn, WizardStep, useWizard } from './hooks/use-wizard.js';
+export { FieldType, ResourceFormFieldDef, SelectOption } from './form-types.js';
+export { titleCase } from './utils.js';
+import 'react/jsx-runtime';
+import 'react';
+import '@tanstack/react-query';
+import 'react-hook-form';

package/dist/index.js

@@ -0,0 +1,13 @@
+export { createSupabaseProvider } from './chunk-LQEICXJS.js';
+import './chunk-XCX2TRBL.js';
+import './chunk-65SXNHWE.js';
+import './chunk-EL7YGOTY.js';
+export { buildArrayItemDefaults, useResourceForm } from './chunk-F4FOTIJI.js';
+export { titleCase } from './chunk-RYEXWQFD.js';
+export { useOne } from './chunk-PVT6FHAO.js';
+export { useResource } from './chunk-ZU72FMDR.js';
+export { DataProviderRoot, GenesisProvider, createMockProvider, useDataProvider, useStorage } from './chunk-6V2TIN3G.js';
+export { createLocalStorageAdapter, createMemoryStorageAdapter, createNoopStorageAdapter } from './chunk-ZYJUEJ4Z.js';
+export { useWizard } from './chunk-7KOLYF27.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/provider/index.d.ts

@@ -0,0 +1,78 @@
+import { D as DataProvider } from '../types-BzcZrTjl.js';
+export { A as ArrayFilter, B as BaseRecord, C as CreateParams, a as CreateResult, b as DeleteParams, c as DeleteResult, F as FilterParam, G as GetManyParams, d as GetManyResult, e as GetOneParams, f as GetOneResult, I as Identifier, L as ListParams, g as ListResult, N as NullFilter, P as PaginationParam, R as RangeFilter, S as ScalarFilter, h as SortParam, U as UpdateParams, i as UpdateResult } from '../types-BzcZrTjl.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { S as StorageAdapter } from '../types-DKcxHXxq.js';
+
+interface MockProviderOptions {
+    /** Simulated latency in ms (default 0). */
+    delay?: number;
+}
+type Row$1 = Record<string, unknown>;
+declare function createMockProvider(datasets: Record<string, Row$1[]>, options?: MockProviderOptions): DataProvider;
+
+/** A chainable query builder returned by `client.from(table)`. */
+interface SupabaseQueryBuilder {
+    select(columns?: string, options?: {
+        count?: "exact" | "planned" | "estimated";
+    }): SupabaseQueryBuilder;
+    insert(data: Record<string, unknown> | Record<string, unknown>[]): SupabaseQueryBuilder;
+    update(data: Record<string, unknown>): SupabaseQueryBuilder;
+    delete(): SupabaseQueryBuilder;
+    eq(column: string, value: unknown): SupabaseQueryBuilder;
+    neq(column: string, value: unknown): SupabaseQueryBuilder;
+    gt(column: string, value: unknown): SupabaseQueryBuilder;
+    lt(column: string, value: unknown): SupabaseQueryBuilder;
+    gte(column: string, value: unknown): SupabaseQueryBuilder;
+    lte(column: string, value: unknown): SupabaseQueryBuilder;
+    ilike(column: string, value: string): SupabaseQueryBuilder;
+    in(column: string, values: unknown[]): SupabaseQueryBuilder;
+    is(column: string, value: null): SupabaseQueryBuilder;
+    not(column: string, operator: string, value: unknown): SupabaseQueryBuilder;
+    or(filters: string): SupabaseQueryBuilder;
+    order(column: string, options?: {
+        ascending?: boolean;
+    }): SupabaseQueryBuilder;
+    range(from: number, to: number): SupabaseQueryBuilder;
+    single(): SupabaseQueryBuilder;
+    then: Promise<{
+        data: unknown;
+        error: unknown;
+        count?: number | null;
+    }>["then"];
+}
+/** Minimal Supabase client interface accepted by the provider. */
+interface SupabaseClient {
+    from(table: string): SupabaseQueryBuilder;
+}
+declare function createSupabaseProvider(client: SupabaseClient): DataProvider;
+
+interface DataProviderRootProps {
+    provider: DataProvider;
+    children: ReactNode;
+}
+declare function DataProviderRoot({ provider, children }: DataProviderRootProps): react_jsx_runtime.JSX.Element;
+declare function useDataProvider(): DataProvider;
+declare function useStorage(): StorageAdapter;
+type Row = Record<string, unknown>;
+type GenesisProviderProps = {
+    children: ReactNode;
+    /** Pass a ready-made DataProvider. Mutually exclusive with `mock`. */
+    provider: DataProvider;
+    mock?: never;
+    /** Platform-specific storage adapter. Defaults to localStorage (SSR-safe). */
+    storage?: StorageAdapter;
+} | {
+    children: ReactNode;
+    provider?: never;
+    /** Pass mock datasets. Mutually exclusive with `provider`. */
+    mock: {
+        datasets: Record<string, Row[]>;
+        options?: MockProviderOptions;
+    };
+    /** Platform-specific storage adapter. Defaults to localStorage (SSR-safe). */
+    storage?: StorageAdapter;
+};
+declare function GenesisProvider({ children, provider, mock, storage, }: GenesisProviderProps): react_jsx_runtime.JSX.Element;
+
+export { DataProvider, DataProviderRoot, type DataProviderRootProps, GenesisProvider, type GenesisProviderProps, type MockProviderOptions, type SupabaseClient, createMockProvider, createSupabaseProvider, useDataProvider, useStorage };

package/dist/provider/index.js

@@ -0,0 +1,5 @@
+export { createSupabaseProvider } from '../chunk-LQEICXJS.js';
+export { DataProviderRoot, GenesisProvider, createMockProvider, useDataProvider, useStorage } from '../chunk-6V2TIN3G.js';
+import '../chunk-ZYJUEJ4Z.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/provider/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/storage/index.d.ts

@@ -0,0 +1,10 @@
+import { S as StorageAdapter } from '../types-DKcxHXxq.js';
+
+/** localStorage adapter with SSR safety. */
+declare function createLocalStorageAdapter(): StorageAdapter;
+/** In-memory adapter for testing and SSR. */
+declare function createMemoryStorageAdapter(): StorageAdapter;
+/** No-op adapter — all operations silently do nothing. */
+declare function createNoopStorageAdapter(): StorageAdapter;
+
+export { StorageAdapter, createLocalStorageAdapter, createMemoryStorageAdapter, createNoopStorageAdapter };

package/dist/storage/index.js

@@ -0,0 +1,4 @@
+import '../chunk-XCX2TRBL.js';
+export { createLocalStorageAdapter, createMemoryStorageAdapter, createNoopStorageAdapter } from '../chunk-ZYJUEJ4Z.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/types-BzcZrTjl.d.ts

@@ -0,0 +1,119 @@
+/** Record identifier — supports both string UUIDs and numeric auto-increment IDs. */
+type Identifier = string | number;
+/** Base record type — all resources must have an id. */
+type BaseRecord = {
+    id: Identifier;
+    [key: string]: unknown;
+};
+/** Pagination parameters (offset-based, with optional cursor for future use). */
+interface PaginationParam {
+    page: number;
+    perPage: number;
+    cursor?: string;
+}
+/** Sort direction for a single field. */
+interface SortParam {
+    field: string;
+    order: "asc" | "desc";
+}
+/**
+ * Filter expressions — discriminated union by operator.
+ * Filters are AND-ed together in queries.
+ */
+/** Operators that compare a field against a single scalar value. */
+interface ScalarFilter {
+    field: string;
+    operator: "eq" | "neq" | "gt" | "lt" | "gte" | "lte" | "contains";
+    value: string | number | boolean;
+}
+/** Operator that checks field membership in a list. */
+interface ArrayFilter {
+    field: string;
+    operator: "in";
+    value: (string | number | boolean)[];
+}
+/** Operator that checks field is within a range. */
+interface RangeFilter {
+    field: string;
+    operator: "between";
+    value: [string | number, string | number];
+}
+/** Operators that check for null/non-null — no value needed. */
+interface NullFilter {
+    field: string;
+    operator: "is_null" | "is_not_null";
+}
+type FilterParam = ScalarFilter | ArrayFilter | RangeFilter | NullFilter;
+/** Parameters for `getList`. */
+interface ListParams {
+    pagination?: PaginationParam;
+    sort?: SortParam;
+    filters?: FilterParam[];
+    /** Supabase select syntax, e.g. "*, author:profiles(name)". Mock provider ignores this. */
+    select?: string;
+    /** Multi-field text search (case-insensitive). */
+    search?: {
+        query: string;
+        fields: string[];
+    };
+}
+/** Result of `getList`. */
+interface ListResult<T> {
+    data: T[];
+    total: number;
+}
+/** Parameters for `getOne`. */
+interface GetOneParams {
+    id: Identifier;
+    /** Supabase select syntax, e.g. "*, author:profiles(name)". Defaults to "*". */
+    select?: string;
+}
+/** Result of `getOne`. */
+interface GetOneResult<T> {
+    data: T;
+}
+/** Parameters for `getMany`. */
+interface GetManyParams {
+    ids: Identifier[];
+}
+/** Result of `getMany`. */
+interface GetManyResult<T> {
+    data: T[];
+}
+/** Parameters for `create`. */
+interface CreateParams<T> {
+    data: Partial<T>;
+}
+/** Result of `create`. */
+interface CreateResult<T> {
+    data: T;
+}
+/** Parameters for `update`. */
+interface UpdateParams<T> {
+    id: Identifier;
+    data: Partial<T>;
+}
+/** Result of `update`. */
+interface UpdateResult<T> {
+    data: T;
+}
+/** Parameters for `deleteOne`. */
+interface DeleteParams {
+    id: Identifier;
+}
+/** Result of `deleteOne`. */
+interface DeleteResult {
+    data: {
+        id: Identifier;
+    };
+}
+interface DataProvider {
+    getList<T extends BaseRecord = BaseRecord>(resource: string, params: ListParams): Promise<ListResult<T>>;
+    getOne<T extends BaseRecord = BaseRecord>(resource: string, params: GetOneParams): Promise<GetOneResult<T>>;
+    getMany<T extends BaseRecord = BaseRecord>(resource: string, params: GetManyParams): Promise<GetManyResult<T>>;
+    create<T extends BaseRecord = BaseRecord>(resource: string, params: CreateParams<T>): Promise<CreateResult<T>>;
+    update<T extends BaseRecord = BaseRecord>(resource: string, params: UpdateParams<T>): Promise<UpdateResult<T>>;
+    deleteOne(resource: string, params: DeleteParams): Promise<DeleteResult>;
+}
+
+export type { ArrayFilter as A, BaseRecord as B, CreateParams as C, DataProvider as D, FilterParam as F, GetManyParams as G, Identifier as I, ListParams as L, NullFilter as N, PaginationParam as P, RangeFilter as R, ScalarFilter as S, UpdateParams as U, CreateResult as a, DeleteParams as b, DeleteResult as c, GetManyResult as d, GetOneParams as e, GetOneResult as f, ListResult as g, SortParam as h, UpdateResult as i };

package/dist/types-DKcxHXxq.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Platform-agnostic storage adapter interface.
+ *
+ * Web: backed by localStorage
+ * Native: backed by MMKV or AsyncStorage
+ * Test/SSR: backed by in-memory map
+ *
+ * All methods are synchronous — async storage backends (AsyncStorage)
+ * should pre-hydrate and provide sync access.
+ */
+interface StorageAdapter {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+
+export type { StorageAdapter as S };

package/dist/utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Convert a key string to title case.
+ *   "created_at" -> "Created At"
+ *   "firstName"  -> "First Name"
+ */
+declare function titleCase(str: string): string;
+
+export { titleCase };

package/dist/utils.js

@@ -0,0 +1,3 @@
+export { titleCase } from './chunk-RYEXWQFD.js';
+//# sourceMappingURL=utils.js.map
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"utils.js"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@marktiderman/genesis-core",
+  "version": "1.0.0",
+  "private": false,
+  "type": "module",
+  "sideEffects": false,
+  "description": "Genesis platform-agnostic providers, hooks, and data layer. Part of the Genesis framework.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/marktiderman/genesis.git",
+    "directory": "packages/core"
+  },
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./provider": {
+      "types": "./dist/provider/index.d.ts",
+      "import": "./dist/provider/index.js"
+    },
+    "./hooks": {
+      "types": "./dist/hooks/index.d.ts",
+      "import": "./dist/hooks/index.js"
+    },
+    "./hooks/*": {
+      "types": "./dist/hooks/*.d.ts",
+      "import": "./dist/hooks/*.js"
+    },
+    "./storage": {
+      "types": "./dist/storage/index.d.ts",
+      "import": "./dist/storage/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "@tanstack/react-query": "^5.0.0",
+    "react-hook-form": "^7.0.0",
+    "zod": "^3.0.0 || ^4.0.0",
+    "@hookform/resolvers": "^3.0.0 || ^4.0.0 || ^5.0.0"
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.75.0",
+    "@types/react": "^19.2.14",
+    "react-hook-form": "^7.56.4",
+    "zod": "^3.25.67",
+    "@hookform/resolvers": "^5.0.1",
+    "tsup": "^8.3.0",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist"
+  }
+}