@noormdev/sdk 1.0.0-alpha.23 → 1.0.0-alpha.24

package/dist/index.d.ts

@@ -3696,7 +3696,7 @@ export declare class NoormOps {
  * the impersonated principal. Mirrors Context's query surface without
  * lifecycle or noorm ops.
  */
-export interface ImpersonatedScope<DB = unknown, Procs = object, Funcs = object> {
+export interface ImpersonatedScope<DB = unknown, Procs = object, Funcs = object, Tvfs = object> {
 	kysely: Kysely<DB>;
 	proc: <T = unknown, N extends keyof Procs & string = keyof Procs & string>(name: N, ...args: Procs[N] extends void ? [
 	] : [
@@ -3708,6 +3708,10 @@ export interface ImpersonatedScope<DB = unknown, Procs = object, Funcs = object>
 		params: Funcs[N],
 		column: string
 	]) => Promise<T>;
+	tvf: <T = unknown, N extends keyof Tvfs & string = keyof Tvfs & string>(name: N, ...args: Tvfs[N] extends void ? [
+	] : [
+		params: Tvfs[N]
+	]) => Promise<T[]>;
 	transaction: <T>(fn: (trx: Transaction<DB>) => Promise<T>) => Promise<T>;
 	revert: () => Promise<void>;
 }
@@ -3743,7 +3747,7 @@ export declare class ImpersonationError extends Error {
  * await ctx.disconnect()
  * ```
  */
-export declare class Context<DB = unknown, Procs = object, Funcs = object> {
+export declare class Context<DB = unknown, Procs = object, Funcs = object, Tvfs = object> {
 	#private;
 	constructor(config: Config, settings: Settings, identity: Identity, options: CreateContextOptions, projectRoot: string);
 	get dialect(): Dialect;
@@ -3835,6 +3839,29 @@ export declare class Context<DB = unknown, Procs = object, Funcs = object> {
 		params: Funcs[N],
 		column: string
 	]): Promise<T>;
+	/**
+	 * Call a table-valued function and return the result set.
+	 *
+	 * Generates SELECT * FROM name(...) with dialect-specific parameter
+	 * syntax. Returns multiple rows, unlike func() which returns a scalar.
+	 * Only supported on MSSQL and PostgreSQL — MySQL and SQLite throw.
+	 *
+	 * @example
+	 * ```typescript
+	 * // Named params
+	 * const sessions = await ctx.tvf<Session>('validate_session', { session_key: key });
+	 *
+	 * // Positional params
+	 * const results = await ctx.tvf<Result>('search_products', ['widget', 100]);
+	 *
+	 * // No params
+	 * const items = await ctx.tvf<Item>('get_active_items');
+	 * ```
+	 */
+	tvf<T = unknown, N extends keyof Tvfs & string = keyof Tvfs & string>(name: N, ...args: Tvfs[N] extends void ? [
+	] : [
+		params: Tvfs[N]
+	]): Promise<T[]>;
 	/**
 	 * Execute queries as a specific database principal.
 	 *
@@ -3855,8 +3882,8 @@ export declare class Context<DB = unknown, Procs = object, Funcs = object> {
 	 * await scope.revert();
 	 * ```
 	 */
-	impersonate<T>(username: string, fn: (scope: ImpersonatedScope<DB, Procs, Funcs>) => Promise<T>): Promise<T>;
-	impersonate(username: string): Promise<ImpersonatedScope<DB, Procs, Funcs>>;
+	impersonate<T>(username: string, fn: (scope: ImpersonatedScope<DB, Procs, Funcs, Tvfs>) => Promise<T>): Promise<T>;
+	impersonate(username: string): Promise<ImpersonatedScope<DB, Procs, Funcs, Tvfs>>;
 }
 /**
  * Error thrown when requireTest is enabled but config.isTest is false.
@@ -3925,7 +3952,7 @@ export declare class ProtectedConfigError extends Error {
  * const ctx = await createContext()
  * ```
  */
-export declare function createContext<DB = unknown, Procs = object, Funcs = object>(options?: CreateContextOptions): Promise<Context<DB, Procs, Funcs>>;
+export declare function createContext<DB = unknown, Procs = object, Funcs = object, Tvfs = object>(options?: CreateContextOptions): Promise<Context<DB, Procs, Funcs, Tvfs>>;
 
 export {
 	Lock$1 as Lock,

package/dist/index.js

@@ -16828,6 +16828,27 @@ function buildFuncCall(dialect, name, column, params) {
   const joined = sql.join(values.map((v) => sql`${v}`));
   return sql`SELECT ${rawName}(${joined}) AS ${rawCol}`;
 }
+function buildTvfCall(dialect, name, params) {
+  if (dialect === "sqlite") {
+    throw new Error("SQLite does not support table-valued functions.");
+  }
+  if (dialect === "mysql") {
+    throw new Error("MySQL does not support table-valued functions.");
+  }
+  const rawName = sql.raw(name);
+  if (!params || Array.isArray(params) && params.length === 0 || !Array.isArray(params) && Object.keys(params).length === 0) {
+    return sql`SELECT * FROM ${rawName}()`;
+  }
+  if (dialect === "postgres" && !Array.isArray(params)) {
+    const parts = Object.entries(params).map(
+      ([key, val]) => sql`${sql.raw(key)} => ${val}`
+    );
+    return sql`SELECT * FROM ${rawName}(${sql.join(parts)})`;
+  }
+  const values = Array.isArray(params) ? params : Object.values(params);
+  const joined = sql.join(values.map((v) => sql`${v}`));
+  return sql`SELECT * FROM ${rawName}(${joined})`;
+}
 function buildMssqlProc(rawName, params) {
   if (Array.isArray(params)) {
     const joined = sql.join(params.map((v) => sql`${v}`));
@@ -27218,6 +27239,12 @@ function buildScope(db, revertFn, dialect) {
       const result = await query.execute(db);
       return result.rows?.[0] ?? null;
     },
+    async tvf(name, ...args) {
+      const params = args[0];
+      const query = buildTvfCall(dialect, name, params);
+      const result = await query.execute(db);
+      return result.rows ?? [];
+    },
     async transaction(fn) {
       return db.transaction().execute(fn);
     },
@@ -27385,6 +27412,40 @@ var Context = class {
     const result = await query.execute(this.kysely);
     return result.rows?.[0] ?? null;
   }
+  // ─────────────────────────────────────────────────────────
+  // Table-Valued Functions
+  // ─────────────────────────────────────────────────────────
+  /**
+   * Call a table-valued function and return the result set.
+   *
+   * Generates SELECT * FROM name(...) with dialect-specific parameter
+   * syntax. Returns multiple rows, unlike func() which returns a scalar.
+   * Only supported on MSSQL and PostgreSQL — MySQL and SQLite throw.
+   *
+   * @example
+   * ```typescript
+   * // Named params
+   * const sessions = await ctx.tvf<Session>('validate_session', { session_key: key });
+   *
+   * // Positional params
+   * const results = await ctx.tvf<Result>('search_products', ['widget', 100]);
+   *
+   * // No params
+   * const items = await ctx.tvf<Item>('get_active_items');
+   * ```
+   */
+  async tvf(name, ...args) {
+    if (this.dialect === "sqlite") {
+      throw new Error("SQLite does not support table-valued functions.");
+    }
+    if (this.dialect === "mysql") {
+      throw new Error("MySQL does not support table-valued functions.");
+    }
+    const params = args[0];
+    const query = buildTvfCall(this.dialect, name, params);
+    const result = await query.execute(this.kysely);
+    return result.rows ?? [];
+  }
   async impersonate(username, fn) {
     const strategy = dialectStrategy[this.dialect];
     if (!strategy) {