@constructive-io/react 0.23.16 → 0.24.0

package/esm/auth/schema-types.d.ts

@@ -183,7 +183,8 @@ export interface UserFilter {
     /**
      * Composite unified search. Provide a search string and it will be dispatched to
      * all text-compatible search algorithms (tsvector, BM25, pg_trgm)
-     * simultaneously. Rows matching ANY algorithm are returned. All matching score
+     * simultaneously. When the LLM plugin is active, pgvector also participates via
+     * auto-embedding. Rows matching ANY algorithm are returned. All matching score
      * fields are populated.
      */
     unifiedSearch?: string;
@@ -1528,6 +1529,14 @@ export interface MetaTable {
     relations: MetaRelations;
     inflection: MetaInflection;
     query: MetaQuery;
+    /** Storage metadata (null if not a storage table) */
+    storage?: MetaStorage | null;
+    /** Search metadata (null if no search configured) */
+    search?: MetaSearch | null;
+    /** i18n metadata (null if no @i18n tag) */
+    i18n?: MetaI18n | null;
+    /** Realtime metadata (null if no @realtime tag) */
+    realtime?: MetaRealtime | null;
 }
 export interface SignInCrossOriginRecord {
     id?: string | null;
@@ -1584,6 +1593,8 @@ export interface MetaField {
     isPrimaryKey: boolean;
     isForeignKey: boolean;
     description?: string | null;
+    /** Enum metadata if this field has an enum type */
+    enumValues?: MetaEnum | null;
 }
 /** Information about a database index */
 export interface MetaIndex {
@@ -1649,6 +1660,36 @@ export interface MetaQuery {
     update?: string | null;
     delete?: string | null;
 }
+/** Storage metadata for a table */
+export interface MetaStorage {
+    /** Whether this table is a storage files table */
+    isFilesTable: boolean;
+    /** Whether this table is a storage buckets table */
+    isBucketsTable: boolean;
+}
+/** Search metadata for a table */
+export interface MetaSearch {
+    /** Active search algorithms on this table */
+    algorithms: string[];
+    /** Searchable columns with their algorithm */
+    columns: MetaSearchColumn[];
+    /** Whether unifiedSearch composite filter is available */
+    hasUnifiedSearch: boolean;
+    /** Per-table search configuration */
+    config?: MetaSearchConfig | null;
+}
+/** i18n metadata for a table with @i18n tag */
+export interface MetaI18n {
+    /** Name of the translation table */
+    translationTable: string;
+    /** Fields that are translatable */
+    translatableFields: MetaI18nField[];
+}
+/** Realtime metadata for a table with @realtime tag */
+export interface MetaRealtime {
+    /** The generated subscription field name (e.g. onPostChanged) */
+    subscriptionFieldName: string;
+}
 /** Information about a PostgreSQL type */
 export interface MetaType {
     pgType: string;
@@ -1658,6 +1699,13 @@ export interface MetaType {
     hasDefault?: boolean | null;
     subtype?: string | null;
 }
+/** Information about a PostgreSQL enum type */
+export interface MetaEnum {
+    /** The PostgreSQL enum type name */
+    name: string;
+    /** Allowed values for this enum */
+    values: string[];
+}
 /** Reference to a related table */
 export interface MetaRefTable {
     name: string;
@@ -1691,3 +1739,28 @@ export interface MetaManyToManyRelation {
     rightKeyAttributes: MetaField[];
     rightTable: MetaRefTable;
 }
+/** A searchable column with its algorithm */
+export interface MetaSearchColumn {
+    /** Column name (camelCase) */
+    name: string;
+    /** Search algorithm: tsvector, bm25, trgm, or vector */
+    algorithm: string;
+}
+/** Per-table search configuration from @searchConfig smart tag */
+export interface MetaSearchConfig {
+    /** JSON-encoded per-adapter score weights */
+    weights?: string | null;
+    /** Whether recency boosting is enabled */
+    boostRecent: boolean;
+    /** Field used for recency decay */
+    boostRecencyField?: string | null;
+    /** Exponential decay factor per day */
+    boostRecencyDecay?: number | null;
+}
+/** A translatable field */
+export interface MetaI18nField {
+    /** GraphQL field name */
+    name: string;
+    /** PostgreSQL column type (text, citext) */
+    type: string;
+}

package/esm/compute/hooks/client.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ORM client wrapper for React Query hooks
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { createClient } from '../orm';
+import type { OrmClientConfig } from '../orm/client';
+export type { OrmClientConfig } from '../orm/client';
+export type { GraphQLAdapter, GraphQLError, QueryResult } from '../orm/client';
+export { GraphQLRequestError } from '../orm/client';
+type OrmClientInstance = ReturnType<typeof createClient>;
+/**
+ * Configure the ORM client for React Query hooks
+ *
+ * @example
+ * ```ts
+ * import { configure } from './generated/hooks';
+ *
+ * configure({
+ *   endpoint: 'https://api.example.com/graphql',
+ *   headers: { Authorization: 'Bearer <token>' },
+ * });
+ * ```
+ */
+export declare function configure(config: OrmClientConfig): void;
+/**
+ * Get the configured ORM client instance
+ * @throws Error if configure() has not been called
+ */
+export declare function getClient(): OrmClientInstance;

package/esm/compute/hooks/client.js

@@ -0,0 +1,34 @@
+/**
+ * ORM client wrapper for React Query hooks
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { createClient } from '../orm';
+export { GraphQLRequestError } from '../orm/client';
+let client = null;
+/**
+ * Configure the ORM client for React Query hooks
+ *
+ * @example
+ * ```ts
+ * import { configure } from './generated/hooks';
+ *
+ * configure({
+ *   endpoint: 'https://api.example.com/graphql',
+ *   headers: { Authorization: 'Bearer <token>' },
+ * });
+ * ```
+ */
+export function configure(config) {
+    client = createClient(config);
+}
+/**
+ * Get the configured ORM client instance
+ * @throws Error if configure() has not been called
+ */
+export function getClient() {
+    if (!client) {
+        throw new Error('ORM client not configured. Call configure() before using hooks.');
+    }
+    return client;
+}

package/esm/compute/hooks/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * GraphQL SDK
+ * @generated by @constructive-io/graphql-codegen
+ *
+ * Tables: GetAllRecord, FunctionApiBinding, FunctionDeployment, FunctionGraphRef, FunctionGraphStore, FunctionGraphObject, FunctionDeploymentEvent, OrgFunctionExecutionLog, FunctionGraphExecutionOutput, FunctionGraphCommit, SecretDefinition, FunctionExecutionLog, FunctionGraphExecutionNodeState, FunctionGraph, OrgFunctionInvocation, FunctionInvocation, FunctionGraphExecution, FunctionDefinition
+ *
+ * Usage:
+ *
+ * 1. Configure the client:
+ * ```ts
+ * import { configure } from './generated';
+ *
+ * configure({
+ *   endpoint: 'https://api.example.com/graphql',
+ *   headers: { Authorization: 'Bearer <token>' },
+ * });
+ * ```
+ *
+ * 2. Use the hooks:
+ * ```tsx
+ * import { useCarsQuery, useCreateCarMutation } from './generated';
+ *
+ * function MyComponent() {
+ *   const { data, isLoading } = useCarsQuery({
+ *     selection: { fields: { id: true }, first: 10 },
+ *   });
+ *   const { mutate } = useCreateCarMutation({
+ *     selection: { fields: { id: true } },
+ *   });
+ *   // ...
+ * }
+ * ```
+ */
+export * from './client';
+export * from './query-keys';
+export * from './mutation-keys';
+export * from './invalidation';
+export * from './queries';
+export * from './mutations';

package/esm/compute/hooks/index.js

@@ -0,0 +1,39 @@
+/**
+ * GraphQL SDK
+ * @generated by @constructive-io/graphql-codegen
+ *
+ * Tables: GetAllRecord, FunctionApiBinding, FunctionDeployment, FunctionGraphRef, FunctionGraphStore, FunctionGraphObject, FunctionDeploymentEvent, OrgFunctionExecutionLog, FunctionGraphExecutionOutput, FunctionGraphCommit, SecretDefinition, FunctionExecutionLog, FunctionGraphExecutionNodeState, FunctionGraph, OrgFunctionInvocation, FunctionInvocation, FunctionGraphExecution, FunctionDefinition
+ *
+ * Usage:
+ *
+ * 1. Configure the client:
+ * ```ts
+ * import { configure } from './generated';
+ *
+ * configure({
+ *   endpoint: 'https://api.example.com/graphql',
+ *   headers: { Authorization: 'Bearer <token>' },
+ * });
+ * ```
+ *
+ * 2. Use the hooks:
+ * ```tsx
+ * import { useCarsQuery, useCreateCarMutation } from './generated';
+ *
+ * function MyComponent() {
+ *   const { data, isLoading } = useCarsQuery({
+ *     selection: { fields: { id: true }, first: 10 },
+ *   });
+ *   const { mutate } = useCreateCarMutation({
+ *     selection: { fields: { id: true } },
+ *   });
+ *   // ...
+ * }
+ * ```
+ */
+export * from './client';
+export * from './query-keys';
+export * from './mutation-keys';
+export * from './invalidation';
+export * from './queries';
+export * from './mutations';

package/esm/compute/hooks/invalidation.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Cache invalidation helpers
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { QueryClient } from '@tanstack/react-query';
+/**
+// ============================================================================
+// Invalidation Helpers
+// ============================================================================
+
+ * Type-safe query invalidation helpers
+ *
+ * @example
+ * ```ts
+ * // Invalidate all user queries
+ * invalidate.user.all(queryClient);
+ *
+ * // Invalidate user lists
+ * invalidate.user.lists(queryClient);
+ *
+ * // Invalidate specific user
+ * invalidate.user.detail(queryClient, userId);
+ * ```
+ */
+export declare const invalidate: {
+    /** Invalidate getAllRecord queries */ readonly getAllRecord: {
+        /** Invalidate all getAllRecord queries */ readonly all: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate getAllRecord list queries */ readonly lists: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate a specific getAllRecord */ readonly detail: (queryClient: QueryClient, id: string | number) => Promise<void>;
+    };
+    /** Invalidate functionApiBinding queries */ readonly functionApiBinding: {
+        /** Invalidate all functionApiBinding queries */ readonly all: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate functionApiBinding list queries */ readonly lists: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate a specific functionApiBinding */ readonly detail: (queryClient: QueryClient, id: string | number) => Promise<void>;
+    };
+    /** Invalidate functionDeployment queries */ readonly functionDeployment: {
+        /** Invalidate all functionDeployment queries */ readonly all: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate functionDeployment list queries */ readonly lists: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate a specific functionDeployment */ readonly detail: (queryClient: QueryClient, id: string | number) => Promise<void>;
+    };
+    /** Invalidate functionGraphRef queries */ readonly functionGraphRef: {
+        /** Invalidate all functionGraphRef queries */ readonly all: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate functionGraphRef list queries */ readonly lists: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate a specific functionGraphRef */ readonly detail: (queryClient: QueryClient, id: string | number) => Promise<void>;
+    };
+    /** Invalidate functionGraphStore queries */ readonly functionGraphStore: {
+        /** Invalidate all functionGraphStore queries */ readonly all: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate functionGraphStore list queries */ readonly lists: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate a specific functionGraphStore */ readonly detail: (queryClient: QueryClient, id: string | number) => Promise<void>;
+    };
+    /** Invalidate functionGraphObject queries */ readonly functionGraphObject: {
+        /** Invalidate all functionGraphObject queries */ readonly all: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate functionGraphObject list queries */ readonly lists: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate a specific functionGraphObject */ readonly detail: (queryClient: QueryClient, id: string | number) => Promise<void>;
+    };
+    /** Invalidate functionDeploymentEvent queries */ readonly functionDeploymentEvent: {
+        /** Invalidate all functionDeploymentEvent queries */ readonly all: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate functionDeploymentEvent list queries */ readonly lists: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate a specific functionDeploymentEvent */ readonly detail: (queryClient: QueryClient, id: string | number) => Promise<void>;
+    };
+    /** Invalidate orgFunctionExecutionLog queries */ readonly orgFunctionExecutionLog: {
+        /** Invalidate all orgFunctionExecutionLog queries */ readonly all: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate orgFunctionExecutionLog list queries */ readonly lists: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate a specific orgFunctionExecutionLog */ readonly detail: (queryClient: QueryClient, id: string | number) => Promise<void>;
+    };
+    /** Invalidate functionGraphExecutionOutput queries */ readonly functionGraphExecutionOutput: {
+        /** Invalidate all functionGraphExecutionOutput queries */ readonly all: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate functionGraphExecutionOutput list queries */ readonly lists: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate a specific functionGraphExecutionOutput */ readonly detail: (queryClient: QueryClient, id: string | number) => Promise<void>;
+    };
+    /** Invalidate functionGraphCommit queries */ readonly functionGraphCommit: {
+        /** Invalidate all functionGraphCommit queries */ readonly all: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate functionGraphCommit list queries */ readonly lists: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate a specific functionGraphCommit */ readonly detail: (queryClient: QueryClient, id: string | number) => Promise<void>;
+    };
+    /** Invalidate secretDefinition queries */ readonly secretDefinition: {
+        /** Invalidate all secretDefinition queries */ readonly all: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate secretDefinition list queries */ readonly lists: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate a specific secretDefinition */ readonly detail: (queryClient: QueryClient, id: string | number) => Promise<void>;
+    };
+    /** Invalidate functionExecutionLog queries */ readonly functionExecutionLog: {
+        /** Invalidate all functionExecutionLog queries */ readonly all: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate functionExecutionLog list queries */ readonly lists: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate a specific functionExecutionLog */ readonly detail: (queryClient: QueryClient, id: string | number) => Promise<void>;
+    };
+    /** Invalidate functionGraphExecutionNodeState queries */ readonly functionGraphExecutionNodeState: {
+        /** Invalidate all functionGraphExecutionNodeState queries */ readonly all: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate functionGraphExecutionNodeState list queries */ readonly lists: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate a specific functionGraphExecutionNodeState */ readonly detail: (queryClient: QueryClient, id: string | number) => Promise<void>;
+    };
+    /** Invalidate functionGraph queries */ readonly functionGraph: {
+        /** Invalidate all functionGraph queries */ readonly all: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate functionGraph list queries */ readonly lists: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate a specific functionGraph */ readonly detail: (queryClient: QueryClient, id: string | number) => Promise<void>;
+    };
+    /** Invalidate orgFunctionInvocation queries */ readonly orgFunctionInvocation: {
+        /** Invalidate all orgFunctionInvocation queries */ readonly all: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate orgFunctionInvocation list queries */ readonly lists: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate a specific orgFunctionInvocation */ readonly detail: (queryClient: QueryClient, id: string | number) => Promise<void>;
+    };
+    /** Invalidate functionInvocation queries */ readonly functionInvocation: {
+        /** Invalidate all functionInvocation queries */ readonly all: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate functionInvocation list queries */ readonly lists: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate a specific functionInvocation */ readonly detail: (queryClient: QueryClient, id: string | number) => Promise<void>;
+    };
+    /** Invalidate functionGraphExecution queries */ readonly functionGraphExecution: {
+        /** Invalidate all functionGraphExecution queries */ readonly all: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate functionGraphExecution list queries */ readonly lists: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate a specific functionGraphExecution */ readonly detail: (queryClient: QueryClient, id: string | number) => Promise<void>;
+    };
+    /** Invalidate functionDefinition queries */ readonly functionDefinition: {
+        /** Invalidate all functionDefinition queries */ readonly all: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate functionDefinition list queries */ readonly lists: (queryClient: QueryClient) => Promise<void>;
+        /** Invalidate a specific functionDefinition */ readonly detail: (queryClient: QueryClient, id: string | number) => Promise<void>;
+    };
+};
+/**
+
+// ============================================================================
+// Remove Helpers (for delete operations)
+// ============================================================================
+
+ * Remove queries from cache (for delete operations)
+ *
+ * Use these when an entity is deleted to remove it from cache
+ * instead of just invalidating (which would trigger a refetch).
+ */
+export declare const remove: {
+    /** Remove getAllRecord from cache */ readonly getAllRecord: (queryClient: QueryClient, id: string | number) => void;
+    /** Remove functionApiBinding from cache */ readonly functionApiBinding: (queryClient: QueryClient, id: string | number) => void;
+    /** Remove functionDeployment from cache */ readonly functionDeployment: (queryClient: QueryClient, id: string | number) => void;
+    /** Remove functionGraphRef from cache */ readonly functionGraphRef: (queryClient: QueryClient, id: string | number) => void;
+    /** Remove functionGraphStore from cache */ readonly functionGraphStore: (queryClient: QueryClient, id: string | number) => void;
+    /** Remove functionGraphObject from cache */ readonly functionGraphObject: (queryClient: QueryClient, id: string | number) => void;
+    /** Remove functionDeploymentEvent from cache */ readonly functionDeploymentEvent: (queryClient: QueryClient, id: string | number) => void;
+    /** Remove orgFunctionExecutionLog from cache */ readonly orgFunctionExecutionLog: (queryClient: QueryClient, id: string | number) => void;
+    /** Remove functionGraphExecutionOutput from cache */ readonly functionGraphExecutionOutput: (queryClient: QueryClient, id: string | number) => void;
+    /** Remove functionGraphCommit from cache */ readonly functionGraphCommit: (queryClient: QueryClient, id: string | number) => void;
+    /** Remove secretDefinition from cache */ readonly secretDefinition: (queryClient: QueryClient, id: string | number) => void;
+    /** Remove functionExecutionLog from cache */ readonly functionExecutionLog: (queryClient: QueryClient, id: string | number) => void;
+    /** Remove functionGraphExecutionNodeState from cache */ readonly functionGraphExecutionNodeState: (queryClient: QueryClient, id: string | number) => void;
+    /** Remove functionGraph from cache */ readonly functionGraph: (queryClient: QueryClient, id: string | number) => void;
+    /** Remove orgFunctionInvocation from cache */ readonly orgFunctionInvocation: (queryClient: QueryClient, id: string | number) => void;
+    /** Remove functionInvocation from cache */ readonly functionInvocation: (queryClient: QueryClient, id: string | number) => void;
+    /** Remove functionGraphExecution from cache */ readonly functionGraphExecution: (queryClient: QueryClient, id: string | number) => void;
+    /** Remove functionDefinition from cache */ readonly functionDefinition: (queryClient: QueryClient, id: string | number) => void;
+};