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

package/dist/index.d.ts

@@ -1971,6 +1971,38 @@ export interface ImportOptions {
 	/** Truncate target table before import. Default: false. */
 	truncate?: boolean;
 }
+/**
+ * Extract the args type from a proc/func/tvf entry.
+ *
+ * Supports tuple form `[Args, Return]` and plain `void`.
+ * Non-tuple entries pass through as-is for backward compat.
+ *
+ * @example
+ * ```typescript
+ * ExtractArgs<[{ id: number }, User]>  // { id: number }
+ * ExtractArgs<void>                    // void
+ * ```
+ */
+export type ExtractArgs<E> = E extends [
+	infer A,
+	unknown
+] ? A : E;
+/**
+ * Extract the return type from a proc/func/tvf entry.
+ *
+ * Returns the second element of a `[Args, Return]` tuple.
+ * Falls back to `unknown` for `void` or non-tuple entries.
+ *
+ * @example
+ * ```typescript
+ * ExtractReturn<[{ id: number }, User]>  // User
+ * ExtractReturn<void>                    // unknown
+ * ```
+ */
+export type ExtractReturn<E> = E extends [
+	unknown,
+	infer R
+] ? R : unknown;
 export interface ContextState {
 	connection: ConnectionResult | null;
 	config: Config;
@@ -3698,19 +3730,19 @@ export declare class NoormOps {
  */
 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 ? [
+	proc: <N extends keyof Procs & string = keyof Procs & string, T = ExtractReturn<Procs[N]>>(name: N, ...args: ExtractArgs<Procs[N]> extends void ? [
 	] : [
-		params: Procs[N]
+		params: ExtractArgs<Procs[N]>
 	]) => Promise<T[]>;
-	func: <T = unknown, N extends keyof Funcs & string = keyof Funcs & string>(name: N, ...args: Funcs[N] extends void ? [
+	func: <N extends keyof Funcs & string = keyof Funcs & string, T = ExtractReturn<Funcs[N]>>(name: N, ...args: ExtractArgs<Funcs[N]> extends void ? [
 		column: string
 	] : [
-		params: Funcs[N],
+		params: ExtractArgs<Funcs[N]>,
 		column: string
 	]) => Promise<T>;
-	tvf: <T = unknown, N extends keyof Tvfs & string = keyof Tvfs & string>(name: N, ...args: Tvfs[N] extends void ? [
+	tvf: <N extends keyof Tvfs & string = keyof Tvfs & string, T = ExtractReturn<Tvfs[N]>>(name: N, ...args: ExtractArgs<Tvfs[N]> extends void ? [
 	] : [
-		params: Tvfs[N]
+		params: ExtractArgs<Tvfs[N]>
 	]) => Promise<T[]>;
 	transaction: <T>(fn: (trx: Transaction<DB>) => Promise<T>) => Promise<T>;
 	revert: () => Promise<void>;
@@ -3801,8 +3833,11 @@ export declare class Context<DB = unknown, Procs = object, Funcs = object, Tvfs
 	 *
 	 * @example
 	 * ```typescript
-	 * // Named params
-	 * const users = await ctx.proc<User>('get_users', { department_id: 1 });
+	 * // Return type inferred from tuple definition
+	 * const users = await ctx.proc('get_users', { department_id: 1 });
+	 *
+	 * // Explicit return type override
+	 * const users = await ctx.proc<'get_users', SpecialUser>('get_users', { department_id: 1 });
 	 *
 	 * // Positional params
 	 * await ctx.proc('simple_proc', [42, 'hello']);
@@ -3811,9 +3846,9 @@ export declare class Context<DB = unknown, Procs = object, Funcs = object, Tvfs
 	 * await ctx.proc('refresh_cache');
 	 * ```
 	 */
-	proc<T = unknown, N extends keyof Procs & string = keyof Procs & string>(name: N, ...args: Procs[N] extends void ? [
+	proc<N extends keyof Procs & string = keyof Procs & string, T = ExtractReturn<Procs[N]>>(name: N, ...args: ExtractArgs<Procs[N]> extends void ? [
 	] : [
-		params: Procs[N]
+		params: ExtractArgs<Procs[N]>
 	]): Promise<T[]>;
 	/**
 	 * Call a database function and return the scalar result.
@@ -3823,20 +3858,20 @@ export declare class Context<DB = unknown, Procs = object, Funcs = object, Tvfs
 	 *
 	 * @example
 	 * ```typescript
-	 * // Named params + column alias
-	 * const result = await ctx.func<{ total: number }>('calc_total', { order_id: 42 }, 'total');
+	 * // Return type inferred from tuple definition
+	 * const result = await ctx.func('calc_total', { order_id: 42 }, 'total');
 	 *
-	 * // Positional params + column alias
-	 * const sum = await ctx.func<{ result: number }>('add_numbers', [1, 2], 'result');
+	 * // Explicit return type override
+	 * const result = await ctx.func<'calc_total', { total: number }>('calc_total', { order_id: 42 }, 'total');
 	 *
 	 * // No params — just column alias
-	 * const ver = await ctx.func<{ v: string }>('get_version', 'v');
+	 * const ver = await ctx.func('get_version', 'v');
 	 * ```
 	 */
-	func<T = unknown, N extends keyof Funcs & string = keyof Funcs & string>(name: N, ...args: Funcs[N] extends void ? [
+	func<N extends keyof Funcs & string = keyof Funcs & string, T = ExtractReturn<Funcs[N]>>(name: N, ...args: ExtractArgs<Funcs[N]> extends void ? [
 		column: string
 	] : [
-		params: Funcs[N],
+		params: ExtractArgs<Funcs[N]>,
 		column: string
 	]): Promise<T>;
 	/**
@@ -3848,19 +3883,19 @@ export declare class Context<DB = unknown, Procs = object, Funcs = object, Tvfs
 	 *
 	 * @example
 	 * ```typescript
-	 * // Named params
-	 * const sessions = await ctx.tvf<Session>('validate_session', { session_key: key });
+	 * // Return type inferred from tuple definition
+	 * const sessions = await ctx.tvf('validate_session', { session_key: key });
 	 *
-	 * // Positional params
-	 * const results = await ctx.tvf<Result>('search_products', ['widget', 100]);
+	 * // Explicit return type override
+	 * const sessions = await ctx.tvf<'validate_session', SpecialSession>('validate_session', { session_key: key });
 	 *
 	 * // No params
-	 * const items = await ctx.tvf<Item>('get_active_items');
+	 * const items = await ctx.tvf('get_active_items');
 	 * ```
 	 */
-	tvf<T = unknown, N extends keyof Tvfs & string = keyof Tvfs & string>(name: N, ...args: Tvfs[N] extends void ? [
+	tvf<N extends keyof Tvfs & string = keyof Tvfs & string, T = ExtractReturn<Tvfs[N]>>(name: N, ...args: ExtractArgs<Tvfs[N]> extends void ? [
 	] : [
-		params: Tvfs[N]
+		params: ExtractArgs<Tvfs[N]>
 	]): Promise<T[]>;
 	/**
 	 * Execute queries as a specific database principal.

package/dist/index.js

@@ -27364,8 +27364,11 @@ var Context = class {
    *
    * @example
    * ```typescript
-   * // Named params
-   * const users = await ctx.proc<User>('get_users', { department_id: 1 });
+   * // Return type inferred from tuple definition
+   * const users = await ctx.proc('get_users', { department_id: 1 });
+   *
+   * // Explicit return type override
+   * const users = await ctx.proc<'get_users', SpecialUser>('get_users', { department_id: 1 });
    *
    * // Positional params
    * await ctx.proc('simple_proc', [42, 'hello']);
@@ -27391,14 +27394,14 @@ var Context = class {
    *
    * @example
    * ```typescript
-   * // Named params + column alias
-   * const result = await ctx.func<{ total: number }>('calc_total', { order_id: 42 }, 'total');
+   * // Return type inferred from tuple definition
+   * const result = await ctx.func('calc_total', { order_id: 42 }, 'total');
    *
-   * // Positional params + column alias
-   * const sum = await ctx.func<{ result: number }>('add_numbers', [1, 2], 'result');
+   * // Explicit return type override
+   * const result = await ctx.func<'calc_total', { total: number }>('calc_total', { order_id: 42 }, 'total');
    *
    * // No params — just column alias
-   * const ver = await ctx.func<{ v: string }>('get_version', 'v');
+   * const ver = await ctx.func('get_version', 'v');
    * ```
    */
   async func(name, ...args) {
@@ -27424,14 +27427,14 @@ var Context = class {
    *
    * @example
    * ```typescript
-   * // Named params
-   * const sessions = await ctx.tvf<Session>('validate_session', { session_key: key });
+   * // Return type inferred from tuple definition
+   * const sessions = await ctx.tvf('validate_session', { session_key: key });
    *
-   * // Positional params
-   * const results = await ctx.tvf<Result>('search_products', ['widget', 100]);
+   * // Explicit return type override
+   * const sessions = await ctx.tvf<'validate_session', SpecialSession>('validate_session', { session_key: key });
    *
    * // No params
-   * const items = await ctx.tvf<Item>('get_active_items');
+   * const items = await ctx.tvf('get_active_items');
    * ```
    */
   async tvf(name, ...args) {