supabase-typed-query 0.13.0 → 1.1.0

package/dist/index.js

@@ -47,9 +47,6 @@ const log = {
   info: (msg) => process.env.NODE_ENV !== "test" && console.info(`[supabase-typed-query] ${msg}`)
 };
 const TABLES_WITHOUT_DELETED = /* @__PURE__ */ new Set([]);
-const wrapAsync$2 = (fn) => {
-  return fn();
-};
 const QueryBuilder = (client, config) => {
   const buildSupabaseQuery = () => {
     const { table, conditions, order, limit, offset, schema } = config;
@@ -444,81 +441,52 @@ const QueryBuilder = (client, config) => {
      * Execute query expecting exactly one result
      */
     one: () => {
-      return wrapAsync$2(async () => {
-        try {
-          const query2 = buildSupabaseQuery();
-          const { data, error } = await query2.single();
-          if (error) {
-            log.error(`Error getting ${config.table} item: ${toError(error).toString()}`);
-            return functype.Err(toError(error));
-          }
-          const result = data;
-          const filteredResult = config.filterFn ? config.filterFn(result) : true;
-          if (!filteredResult) {
-            return functype.Ok(functype.Option.none());
-          }
-          return functype.Ok(functype.Option(result));
-        } catch (error) {
-          log.error(`Error executing single query on ${config.table}: ${toError(error).toString()}`);
-          return functype.Err(toError(error));
-        }
-      });
+      return functype.IO.tryAsync(async () => {
+        const query2 = buildSupabaseQuery();
+        const { data, error } = await query2.single();
+        if (error) throw toError(error);
+        const result = data;
+        const passes = config.filterFn ? config.filterFn(result) : true;
+        return passes ? functype.Option(result) : functype.Option.none();
+      }, toError).tapError((err) => log.error(`Error getting ${config.table} item: ${err}`));
     },
     /**
      * Execute query expecting zero or more results
      */
     many: () => {
-      return wrapAsync$2(async () => {
-        try {
-          const query2 = buildSupabaseQuery();
-          const { data, error } = await query2;
-          if (error) {
-            log.error(`Error getting ${config.table} items: ${toError(error).toString()}`);
-            return functype.Err(toError(error));
-          }
-          const rawResults = data;
-          const results = config.filterFn ? rawResults.filter(config.filterFn) : rawResults;
-          return functype.Ok(functype.List(results));
-        } catch (error) {
-          log.error(`Error executing multi query on ${config.table}: ${toError(error).toString()}`);
-          return functype.Err(toError(error));
-        }
-      });
+      return functype.IO.tryAsync(async () => {
+        const query2 = buildSupabaseQuery();
+        const { data, error } = await query2;
+        if (error) throw toError(error);
+        const rawResults = data;
+        const results = config.filterFn ? rawResults.filter(config.filterFn) : rawResults;
+        return functype.List(results);
+      }, toError).tapError((err) => log.error(`Error getting ${config.table} items: ${err}`));
     },
     /**
      * Execute query expecting first result from potentially multiple
      */
     first: () => {
-      return wrapAsync$2(async () => {
-        const manyResult = await QueryBuilder(client, config).many();
-        const list = manyResult.orThrow();
-        if (list.isEmpty) {
-          return functype.Ok(functype.Option.none());
-        }
-        return functype.Ok(functype.Option(list.head));
-      });
+      return QueryBuilder(client, config).many().map((list) => list.isEmpty ? functype.Option.none() : functype.Option(list.head));
     },
     /**
      * Execute query expecting exactly one result, throw if error or not found
      */
     oneOrThrow: async () => {
-      const result = await QueryBuilder(client, config).one();
-      const option = result.orThrow();
+      const option = await QueryBuilder(client, config).one().runOrThrow();
       return option.orThrow(new Error(`No record found in ${config.table}`));
     },
     /**
      * Execute query expecting zero or more results, throw if error
      */
     manyOrThrow: async () => {
-      const result = await QueryBuilder(client, config).many();
-      return result.orThrow();
+      return QueryBuilder(client, config).many().runOrThrow();
     },
     /**
      * Execute query expecting first result, throw if error or empty
      */
     firstOrThrow: async () => {
-      const result = await QueryBuilder(client, config).first();
-      const option = result.orThrow();
+      const option = await QueryBuilder(client, config).first().runOrThrow();
       return option.orThrow(new Error(`No records found in ${config.table}`));
     }
   };
@@ -533,53 +501,42 @@ const createMappedQuery = (sourceQuery, mapFn) => {
       return createMappedQuery(filteredQuery, mapFn);
     },
     one: () => {
-      return wrapAsync$2(async () => {
-        const maybeItemResult = await sourceQuery.one();
-        const maybeItem = maybeItemResult.orThrow();
-        return maybeItem.fold(
-          () => functype.Ok(functype.Option.none()),
-          (item) => functype.Ok(functype.Option(mapFn(item)))
-        );
-      });
+      return sourceQuery.one().map(
+        (maybeItem) => maybeItem.fold(
+          () => functype.Option.none(),
+          (item) => functype.Option(mapFn(item))
+        )
+      );
     },
     many: () => {
-      return wrapAsync$2(async () => {
-        const itemsResult = await sourceQuery.many();
-        const items = itemsResult.orThrow();
-        return functype.Ok(items.map(mapFn));
-      });
+      return sourceQuery.many().map((items) => items.map(mapFn));
     },
     first: () => {
-      return wrapAsync$2(async () => {
-        const maybeItemResult = await sourceQuery.first();
-        const maybeItem = maybeItemResult.orThrow();
-        return maybeItem.fold(
-          () => functype.Ok(functype.Option.none()),
-          (item) => functype.Ok(functype.Option(mapFn(item)))
-        );
-      });
+      return sourceQuery.first().map(
+        (maybeItem) => maybeItem.fold(
+          () => functype.Option.none(),
+          (item) => functype.Option(mapFn(item))
+        )
+      );
     },
     /**
      * Execute mapped query expecting exactly one result, throw if error or not found
      */
     oneOrThrow: async () => {
-      const result = await createMappedQuery(sourceQuery, mapFn).one();
-      const option = result.orThrow();
+      const option = await createMappedQuery(sourceQuery, mapFn).one().runOrThrow();
       return option.orThrow(new Error(`No record found`));
     },
     /**
      * Execute mapped query expecting zero or more results, throw if error
      */
     manyOrThrow: async () => {
-      const result = await createMappedQuery(sourceQuery, mapFn).many();
-      return result.orThrow();
+      return createMappedQuery(sourceQuery, mapFn).many().runOrThrow();
     },
     /**
      * Execute mapped query expecting first result, throw if error or empty
      */
     firstOrThrow: async () => {
-      const result = await createMappedQuery(sourceQuery, mapFn).first();
-      const option = result.orThrow();
+      const option = await createMappedQuery(sourceQuery, mapFn).first().runOrThrow();
       return option.orThrow(new Error(`No records found`));
     }
   };
@@ -601,38 +558,28 @@ const isQuery = (obj) => {
 const isMappedQuery = (obj) => {
   return typeof obj === "object" && obj !== null && "one" in obj && "many" in obj && "first" in obj && "map" in obj && "filter" in obj;
 };
-const wrapAsync$1 = (fn) => {
-  return fn();
-};
 const rpc = (client, functionName, args, options) => {
   const executeRpc = () => {
     return client.rpc(functionName, args ?? {}, {
       count: options?.count
     });
   };
-  const one = () => wrapAsync$1(async () => {
-    try {
-      const { data, error } = await executeRpc();
-      if (error) {
-        return functype.Err(toError(error));
-      }
-      if (data === null || data === void 0) {
-        return functype.Ok(functype.Option.none());
-      }
-      if (Array.isArray(data)) {
-        if (data.length === 0) {
-          return functype.Ok(functype.Option.none());
-        }
-        return functype.Ok(functype.Option(data[0]));
+  const one = () => functype.IO.tryAsync(async () => {
+    const { data, error } = await executeRpc();
+    if (error) throw toError(error);
+    if (data === null || data === void 0) {
+      return functype.Option.none();
+    }
+    if (Array.isArray(data)) {
+      if (data.length === 0) {
+        return functype.Option.none();
       }
-      return functype.Ok(functype.Option(data));
-    } catch (error) {
-      return functype.Err(toError(error));
+      return functype.Option(data[0]);
     }
-  });
+    return functype.Option(data);
+  }, toError);
   const oneOrThrow = async () => {
-    const result = await one();
-    const option = result.orThrow();
+    const option = await one().runOrThrow();
     return option.fold(
       () => {
         throw new Error("RPC call returned no result");
@@ -640,26 +587,19 @@ const rpc = (client, functionName, args, options) => {
       (value) => value
     );
   };
-  const many = () => wrapAsync$1(async () => {
-    try {
-      const { data, error } = await executeRpc();
-      if (error) {
-        return functype.Err(toError(error));
-      }
-      if (data === null || data === void 0) {
-        return functype.Ok(functype.List([]));
-      }
-      if (Array.isArray(data)) {
-        return functype.Ok(functype.List(data));
-      }
-      return functype.Ok(functype.List([data]));
-    } catch (error) {
-      return functype.Err(toError(error));
+  const many = () => functype.IO.tryAsync(async () => {
+    const { data, error } = await executeRpc();
+    if (error) throw toError(error);
+    if (data === null || data === void 0) {
+      return functype.List([]);
+    }
+    if (Array.isArray(data)) {
+      return functype.List(data);
     }
-  });
+    return functype.List([data]);
+  }, toError);
   const manyOrThrow = async () => {
-    const result = await many();
-    return result.orThrow();
+    return many().runOrThrow();
   };
   return {
     one,
@@ -668,208 +608,145 @@ const rpc = (client, functionName, args, options) => {
     manyOrThrow
   };
 };
-const wrapAsync = (fn) => {
-  return fn();
-};
-const getEntity = (client, table, where, is, schema) => wrapAsync(async () => {
-  try {
-    const tableQuery = schema ? client.schema(schema).from(table) : client.from(table);
-    const baseQuery = tableQuery.select("*").match(where);
-    const queryWithIs = is ? functype.List(Object.entries(is)).foldLeft(baseQuery)(
-      (query2, [column, value]) => query2.is(column, value)
-    ) : baseQuery;
-    const { data, error } = await queryWithIs.single();
-    if (error) {
-      return functype.Err(toError(error));
-    }
-    return functype.Ok(data);
-  } catch (error) {
-    return functype.Err(toError(error));
-  }
-});
+const getEntity = (client, table, where, is, schema) => functype.IO.tryAsync(async () => {
+  const tableQuery = schema ? client.schema(schema).from(table) : client.from(table);
+  const baseQuery = tableQuery.select("*").match(where);
+  const queryWithIs = is ? functype.List(Object.entries(is)).foldLeft(baseQuery)(
+    (query2, [column, value]) => query2.is(column, value)
+  ) : baseQuery;
+  const { data, error } = await queryWithIs.single();
+  if (error) throw toError(error);
+  return data;
+}, toError);
 const getEntities = (client, table, where = {}, is, wherein, order = [
   "id",
   { ascending: true }
-], schema) => wrapAsync(async () => {
-  try {
-    const tableQuery = schema ? client.schema(schema).from(table) : client.from(table);
-    const baseQuery = tableQuery.select("*").match(where);
-    const queryWithIn = wherein ? functype.List(Object.entries(wherein)).foldLeft(baseQuery)(
-      (query2, [column, values]) => query2.in(column, values)
-    ) : baseQuery;
-    const queryWithIs = is ? functype.List(Object.entries(is)).foldLeft(queryWithIn)(
-      (query2, [column, value]) => query2.is(column, value)
-    ) : queryWithIn;
-    const queryOrderBy = queryWithIs.order(order[0], order[1]);
-    const { data, error } = await queryOrderBy;
-    if (error) {
-      return functype.Err(toError(error));
-    }
-    return functype.Ok(functype.List(data));
-  } catch (error) {
-    return functype.Err(toError(error));
-  }
-});
-const addEntities = (client, table, entities, schema) => wrapAsync(async () => {
-  try {
-    const tableQuery = schema ? client.schema(schema).from(table) : client.from(table);
-    const { data, error } = await tableQuery.insert(entities).select();
-    if (error) {
-      return functype.Err(toError(error));
-    }
-    return functype.Ok(functype.List(data));
-  } catch (error) {
-    return functype.Err(toError(error));
-  }
-});
-const updateEntity = (client, table, entities, where, is, wherein, schema) => wrapAsync(async () => {
-  try {
-    const tableQuery = schema ? client.schema(schema).from(table) : client.from(table);
-    const baseQuery = tableQuery.update(entities).match(where);
-    const queryWithIn = wherein ? functype.List(Object.entries(wherein)).foldLeft(baseQuery)(
-      (query2, [column, values]) => query2.in(column, values)
-    ) : baseQuery;
-    const queryWithIs = is ? functype.List(Object.entries(is)).foldLeft(queryWithIn)(
-      (query2, [column, value]) => query2.is(column, value)
-    ) : queryWithIn;
-    const { data, error } = await queryWithIs.select().single();
-    if (error) {
-      return functype.Err(toError(error));
-    }
-    return functype.Ok(data);
-  } catch (error) {
-    return functype.Err(toError(error));
-  }
-});
-const upsertEntities = (client, table, entities, identity = "id", where, is, wherein, schema) => wrapAsync(async () => {
-  try {
-    const onConflict = Array.isArray(identity) ? identity.join(",") : identity;
-    const tableQuery = schema ? client.schema(schema).from(table) : client.from(table);
-    const baseQuery = tableQuery.upsert(entities, { onConflict }).match(where ?? {});
-    const queryWithIn = wherein ? functype.List(Object.entries(wherein)).foldLeft(baseQuery)(
-      (query2, [column, values]) => query2.in(column, values)
-    ) : baseQuery;
-    const queryWithIs = is ? functype.List(Object.entries(is)).foldLeft(queryWithIn)(
-      (query2, [column, value]) => query2.is(column, value)
-    ) : queryWithIn;
-    const { data, error } = await queryWithIs.select();
-    if (error) {
-      return functype.Err(toError(error));
-    }
-    return functype.Ok(functype.List(data));
-  } catch (error) {
-    return functype.Err(toError(error));
-  }
-});
-const deleteEntity = (client, table, where, is, wherein, schema) => wrapAsync(async () => {
-  try {
-    const tableQuery = schema ? client.schema(schema).from(table) : client.from(table);
-    const baseQuery = tableQuery.delete().match(where);
-    const queryWithIn = wherein ? functype.List(Object.entries(wherein)).foldLeft(baseQuery)(
-      (query2, [column, values]) => query2.in(column, values)
-    ) : baseQuery;
-    const queryWithIs = is ? functype.List(Object.entries(is)).foldLeft(queryWithIn)(
-      (query2, [column, value]) => query2.is(column, value)
-    ) : queryWithIn;
-    const { data, error } = await queryWithIs.select().single();
-    if (error) {
-      return functype.Err(toError(error));
-    }
-    return functype.Ok(data);
-  } catch (error) {
-    return functype.Err(toError(error));
-  }
-});
-const deleteEntities = (client, table, where, is, wherein, schema) => wrapAsync(async () => {
-  try {
-    const tableQuery = schema ? client.schema(schema).from(table) : client.from(table);
-    const baseQuery = tableQuery.delete().match(where);
-    const queryWithIn = wherein ? functype.List(Object.entries(wherein)).foldLeft(baseQuery)(
-      (query2, [column, values]) => query2.in(column, values)
-    ) : baseQuery;
-    const queryWithIs = is ? functype.List(Object.entries(is)).foldLeft(queryWithIn)(
-      (query2, [column, value]) => query2.is(column, value)
-    ) : queryWithIn;
-    const { data, error } = await queryWithIs.select();
-    if (error) {
-      return functype.Err(toError(error));
-    }
-    return functype.Ok(functype.List(data));
-  } catch (error) {
-    return functype.Err(toError(error));
-  }
-});
-const softDeleteEntity = (client, table, where, is, wherein, schema) => wrapAsync(async () => {
-  try {
-    const tableQuery = schema ? client.schema(schema).from(table) : client.from(table);
-    const baseQuery = tableQuery.update({ deleted: (/* @__PURE__ */ new Date()).toISOString() }).match(where);
-    const queryWithIn = wherein ? functype.List(Object.entries(wherein)).foldLeft(baseQuery)(
-      (query2, [column, values]) => query2.in(column, values)
-    ) : baseQuery;
-    const queryWithIs = is ? functype.List(Object.entries(is)).foldLeft(queryWithIn)(
-      (query2, [column, value]) => query2.is(column, value)
-    ) : queryWithIn;
-    const { data, error } = await queryWithIs.select().single();
-    if (error) {
-      return functype.Err(toError(error));
-    }
-    return functype.Ok(data);
-  } catch (error) {
-    return functype.Err(toError(error));
-  }
-});
-const softDeleteEntities = (client, table, where, is, wherein, schema) => wrapAsync(async () => {
-  try {
-    const tableQuery = schema ? client.schema(schema).from(table) : client.from(table);
-    const baseQuery = tableQuery.update({ deleted: (/* @__PURE__ */ new Date()).toISOString() }).match(where);
-    const queryWithIn = wherein ? functype.List(Object.entries(wherein)).foldLeft(baseQuery)(
-      (query2, [column, values]) => query2.in(column, values)
-    ) : baseQuery;
-    const queryWithIs = is ? functype.List(Object.entries(is)).foldLeft(queryWithIn)(
-      (query2, [column, value]) => query2.is(column, value)
-    ) : queryWithIn;
-    const { data, error } = await queryWithIs.select();
-    if (error) {
-      return functype.Err(toError(error));
-    }
-    return functype.Ok(functype.List(data));
-  } catch (error) {
-    return functype.Err(toError(error));
-  }
-});
+], schema) => functype.IO.tryAsync(async () => {
+  const tableQuery = schema ? client.schema(schema).from(table) : client.from(table);
+  const baseQuery = tableQuery.select("*").match(where);
+  const queryWithIn = wherein ? functype.List(Object.entries(wherein)).foldLeft(baseQuery)(
+    (query2, [column, values]) => query2.in(column, values)
+  ) : baseQuery;
+  const queryWithIs = is ? functype.List(Object.entries(is)).foldLeft(queryWithIn)(
+    (query2, [column, value]) => query2.is(column, value)
+  ) : queryWithIn;
+  const queryOrderBy = queryWithIs.order(order[0], order[1]);
+  const { data, error } = await queryOrderBy;
+  if (error) throw toError(error);
+  return functype.List(data);
+}, toError);
+const addEntities = (client, table, entities, schema) => functype.IO.tryAsync(async () => {
+  const tableQuery = schema ? client.schema(schema).from(table) : client.from(table);
+  const { data, error } = await tableQuery.insert(entities).select();
+  if (error) throw toError(error);
+  return functype.List(data);
+}, toError);
+const updateEntity = (client, table, entities, where, is, wherein, schema) => functype.IO.tryAsync(async () => {
+  const tableQuery = schema ? client.schema(schema).from(table) : client.from(table);
+  const baseQuery = tableQuery.update(entities).match(where);
+  const queryWithIn = wherein ? functype.List(Object.entries(wherein)).foldLeft(baseQuery)(
+    (query2, [column, values]) => query2.in(column, values)
+  ) : baseQuery;
+  const queryWithIs = is ? functype.List(Object.entries(is)).foldLeft(queryWithIn)(
+    (query2, [column, value]) => query2.is(column, value)
+  ) : queryWithIn;
+  const { data, error } = await queryWithIs.select().single();
+  if (error) throw toError(error);
+  return data;
+}, toError);
+const upsertEntities = (client, table, entities, identity = "id", where, is, wherein, schema) => functype.IO.tryAsync(async () => {
+  const onConflict = Array.isArray(identity) ? identity.join(",") : identity;
+  const tableQuery = schema ? client.schema(schema).from(table) : client.from(table);
+  const baseQuery = tableQuery.upsert(entities, { onConflict }).match(where ?? {});
+  const queryWithIn = wherein ? functype.List(Object.entries(wherein)).foldLeft(baseQuery)(
+    (query2, [column, values]) => query2.in(column, values)
+  ) : baseQuery;
+  const queryWithIs = is ? functype.List(Object.entries(is)).foldLeft(queryWithIn)(
+    (query2, [column, value]) => query2.is(column, value)
+  ) : queryWithIn;
+  const { data, error } = await queryWithIs.select();
+  if (error) throw toError(error);
+  return functype.List(data);
+}, toError);
+const deleteEntity = (client, table, where, is, wherein, schema) => functype.IO.tryAsync(async () => {
+  const tableQuery = schema ? client.schema(schema).from(table) : client.from(table);
+  const baseQuery = tableQuery.delete().match(where);
+  const queryWithIn = wherein ? functype.List(Object.entries(wherein)).foldLeft(baseQuery)(
+    (query2, [column, values]) => query2.in(column, values)
+  ) : baseQuery;
+  const queryWithIs = is ? functype.List(Object.entries(is)).foldLeft(queryWithIn)(
+    (query2, [column, value]) => query2.is(column, value)
+  ) : queryWithIn;
+  const { data, error } = await queryWithIs.select().single();
+  if (error) throw toError(error);
+  return data;
+}, toError);
+const deleteEntities = (client, table, where, is, wherein, schema) => functype.IO.tryAsync(async () => {
+  const tableQuery = schema ? client.schema(schema).from(table) : client.from(table);
+  const baseQuery = tableQuery.delete().match(where);
+  const queryWithIn = wherein ? functype.List(Object.entries(wherein)).foldLeft(baseQuery)(
+    (query2, [column, values]) => query2.in(column, values)
+  ) : baseQuery;
+  const queryWithIs = is ? functype.List(Object.entries(is)).foldLeft(queryWithIn)(
+    (query2, [column, value]) => query2.is(column, value)
+  ) : queryWithIn;
+  const { data, error } = await queryWithIs.select();
+  if (error) throw toError(error);
+  return functype.List(data);
+}, toError);
+const softDeleteEntity = (client, table, where, is, wherein, schema) => functype.IO.tryAsync(async () => {
+  const tableQuery = schema ? client.schema(schema).from(table) : client.from(table);
+  const baseQuery = tableQuery.update({ deleted: (/* @__PURE__ */ new Date()).toISOString() }).match(where);
+  const queryWithIn = wherein ? functype.List(Object.entries(wherein)).foldLeft(baseQuery)(
+    (query2, [column, values]) => query2.in(column, values)
+  ) : baseQuery;
+  const queryWithIs = is ? functype.List(Object.entries(is)).foldLeft(queryWithIn)(
+    (query2, [column, value]) => query2.is(column, value)
+  ) : queryWithIn;
+  const { data, error } = await queryWithIs.select().single();
+  if (error) throw toError(error);
+  return data;
+}, toError);
+const softDeleteEntities = (client, table, where, is, wherein, schema) => functype.IO.tryAsync(async () => {
+  const tableQuery = schema ? client.schema(schema).from(table) : client.from(table);
+  const baseQuery = tableQuery.update({ deleted: (/* @__PURE__ */ new Date()).toISOString() }).match(where);
+  const queryWithIn = wherein ? functype.List(Object.entries(wherein)).foldLeft(baseQuery)(
+    (query2, [column, values]) => query2.in(column, values)
+  ) : baseQuery;
+  const queryWithIs = is ? functype.List(Object.entries(is)).foldLeft(queryWithIn)(
+    (query2, [column, value]) => query2.is(column, value)
+  ) : queryWithIn;
+  const { data, error } = await queryWithIs.select();
+  if (error) throw toError(error);
+  return functype.List(data);
+}, toError);
 const query = (client, table, where = {}, is, wherein, order, schema) => {
   return createQuery(client, table, where, is, wherein, order, void 0, schema);
 };
-function MultiMutationQuery(promise) {
-  const result = Object.assign(promise, {
-    many: () => promise,
+function MultiMutationQuery(task) {
+  return {
+    many: () => task,
     manyOrThrow: async () => {
-      const taskResult = await promise;
-      return taskResult.orThrow();
+      return task.runOrThrow();
     },
-    execute: () => promise,
+    execute: () => task,
     executeOrThrow: async () => {
-      const taskResult = await promise;
-      return taskResult.orThrow();
+      return task.runOrThrow();
     }
-  });
-  return result;
+  };
 }
-function SingleMutationQuery(promise) {
-  const result = Object.assign(promise, {
-    one: () => promise.then((outcome) => outcome.map((value) => functype.Option(value))),
+function SingleMutationQuery(task) {
+  return {
+    one: () => task.map((value) => functype.Option(value)),
     oneOrThrow: async () => {
-      const taskResult = await promise;
-      return taskResult.orThrow();
+      return task.runOrThrow();
     },
-    execute: () => promise.then((outcome) => outcome.map((value) => functype.Option(value))),
+    execute: () => task.map((value) => functype.Option(value)),
     executeOrThrow: async () => {
-      const taskResult = await promise;
-      const value = taskResult.orThrow();
+      const value = await task.runOrThrow();
       return functype.Option(value);
     }
-  });
-  return result;
+  };
 }
 function getSoftDeleteMode(softDelete) {
   return softDelete ? "exclude" : "include";
@@ -1187,6 +1064,97 @@ function makePartitionedDeleteItems(client, name, partitionField, softDelete, sc
     );
   };
 }
+function makeViewGetItem(client, name, schema) {
+  return function getItem({ id, where, is }) {
+    const whereConditions = { ...where, id };
+    return createViewGetItemQuery(client, name, whereConditions, is, schema);
+  };
+}
+function makeViewGetItems(client, name, schema) {
+  return function getItems({
+    where,
+    is,
+    wherein,
+    order,
+    gte,
+    gt,
+    lte,
+    lt,
+    neq,
+    like,
+    ilike,
+    not
+  } = {}) {
+    return createViewGetItemsQuery(
+      client,
+      name,
+      where,
+      is,
+      wherein,
+      order,
+      schema,
+      { gte, gt, lte, lt, neq, like, ilike },
+      not
+    );
+  };
+}
+function makePartitionedViewGetItem(client, name, partitionField, schema) {
+  return function getItem(partitionKey, { id, where, is }) {
+    const whereConditions = buildWhereWithPartitionAndId(partitionField, partitionKey, id, where);
+    return createViewGetItemQuery(
+      client,
+      name,
+      whereConditions,
+      is,
+      schema
+    );
+  };
+}
+function makePartitionedViewGetItems(client, name, partitionField, schema) {
+  return function getItems(partitionKey, { where, is, wherein, order, gte, gt, lte, lt, neq, like, ilike, not } = {}) {
+    const whereConditions = buildWhereWithPartition(partitionField, partitionKey, where);
+    return createViewGetItemsQuery(
+      client,
+      name,
+      whereConditions,
+      is,
+      wherein,
+      order,
+      schema,
+      { gte, gt, lte, lt, neq, like, ilike },
+      not
+    );
+  };
+}
+function createViewGetItemQuery(client, name, where, is, schema) {
+  const viewAsTable = name;
+  const clientAny = client;
+  const query2 = createQuery(clientAny, viewAsTable, where, is, void 0, void 0, void 0, schema);
+  return query2;
+}
+function createViewGetItemsQuery(client, name, where, is, wherein, order, schema, comparison, not) {
+  const viewAsTable = name;
+  const clientAny = client;
+  const query2 = createQuery(
+    clientAny,
+    viewAsTable,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    where,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    is,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    wherein,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    order,
+    void 0,
+    schema,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    comparison,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    not
+  );
+  return query2;
+}
 const Entity = (client, name, config) => {
   const softDeleteMode = getSoftDeleteMode(config.softDelete);
   const { schema } = config;
@@ -1308,18 +1276,50 @@ const PartitionedEntity = (client, name, config) => {
     deleteItems: makePartitionedDeleteItems(client, name, partitionField, config.softDelete, schema)
   };
 };
-Object.defineProperty(exports, "Err", {
+const ViewEntity = (client, name, config) => {
+  const schema = config?.schema;
+  return {
+    /**
+     * Retrieve a single item from the view by ID.
+     * @param params Query parameters including id, where conditions, and is conditions
+     * @returns A chainable query that can be executed with .one(), .many(), or .first()
+     */
+    getItem: makeViewGetItem(client, name, schema),
+    /**
+     * Get a list of items from the view filtered by conditions.
+     * @param params Optional query parameters including where, is, wherein, and order
+     * @returns A chainable query that can be executed with .one(), .many(), or .first()
+     */
+    getItems: makeViewGetItems(client, name, schema)
+  };
+};
+const PartitionedViewEntity = (client, name, config) => {
+  const { partitionField, schema } = config;
+  return {
+    /**
+     * Retrieve a single item from the view by ID within a partition.
+     * @param partitionKey The partition key value (e.g., tenantId)
+     * @param params Query parameters including id, where conditions, and is conditions
+     * @returns A chainable query that can be executed with .one(), .many(), or .first()
+     */
+    getItem: makePartitionedViewGetItem(client, name, partitionField, schema),
+    /**
+     * Get a list of items from the view within a partition.
+     * @param partitionKey The partition key value (e.g., tenantId)
+     * @param params Optional query parameters including where, is, wherein, and order
+     * @returns A chainable query that can be executed with .one(), .many(), or .first()
+     */
+    getItems: makePartitionedViewGetItems(client, name, partitionField, schema)
+  };
+};
+Object.defineProperty(exports, "IO", {
   enumerable: true,
-  get: () => functype.Err
+  get: () => functype.IO
 });
 Object.defineProperty(exports, "List", {
   enumerable: true,
   get: () => functype.List
 });
-Object.defineProperty(exports, "Ok", {
-  enumerable: true,
-  get: () => functype.Ok
-});
 Object.defineProperty(exports, "Option", {
   enumerable: true,
   get: () => functype.Option
@@ -1327,8 +1327,10 @@ Object.defineProperty(exports, "Option", {
 exports.Entity = Entity;
 exports.MultiMutationQuery = MultiMutationQuery;
 exports.PartitionedEntity = PartitionedEntity;
+exports.PartitionedViewEntity = PartitionedViewEntity;
 exports.SingleMutationQuery = SingleMutationQuery;
 exports.SupabaseError = SupabaseError;
+exports.ViewEntity = ViewEntity;
 exports.addEntities = addEntities;
 exports.deleteEntities = deleteEntities;
 exports.deleteEntity = deleteEntity;