@simplysm/service-client 13.0.0-beta.6

package/dist/orm-common/src/errors/db-transaction-error.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 트랜잭션 관련 에러 코드
+ *
+ * DBMS별 native 에러 코드를 추상화하여 DBMS 독립적인 에러 처리 가능
+ */
+export declare enum DbErrorCode {
+    /** 활성 트랜잭션이 없음 (ROLLBACK 시 트랜잭션 없음) */
+    NO_ACTIVE_TRANSACTION = "NO_ACTIVE_TRANSACTION",
+    /** 트랜잭션이 이미 시작됨 */
+    TRANSACTION_ALREADY_STARTED = "TRANSACTION_ALREADY_STARTED",
+    /** 데드락 발생 */
+    DEADLOCK = "DEADLOCK",
+    /** 락 타임아웃 */
+    LOCK_TIMEOUT = "LOCK_TIMEOUT"
+}
+/**
+ * 데이터베이스 트랜잭션 에러
+ *
+ * DBMS별 native 에러를 표준화된 에러 코드로 래핑하여
+ * DBMS 독립적인 에러 처리 가능
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await db.rollbackTransaction();
+ * } catch (err) {
+ *   if (err instanceof DbTransactionError) {
+ *     if (err.code === DbErrorCode.NO_ACTIVE_TRANSACTION) {
+ *       // 이미 롤백된 경우 무시
+ *       return;
+ *     }
+ *   }
+ *   throw err;
+ * }
+ * ```
+ */
+export declare class DbTransactionError extends Error {
+    /** 표준화된 에러 코드 */
+    readonly code: DbErrorCode;
+    /** 원본 DBMS 에러 (디버깅용) */
+    readonly originalError?: unknown | undefined;
+    readonly name = "DbTransactionError";
+    constructor(
+    /** 표준화된 에러 코드 */
+    code: DbErrorCode, 
+    /** 에러 메시지 */
+    message: string, 
+    /** 원본 DBMS 에러 (디버깅용) */
+    originalError?: unknown | undefined);
+}
+//# sourceMappingURL=db-transaction-error.d.ts.map

package/dist/orm-common/src/errors/db-transaction-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-transaction-error.d.ts","sourceRoot":"","sources":["../../../../../orm-common/src/errors/db-transaction-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,oBAAY,WAAW;IACrB,uCAAuC;IACvC,qBAAqB,0BAA0B;IAE/C,mBAAmB;IACnB,2BAA2B,gCAAgC;IAE3D,aAAa;IACb,QAAQ,aAAa;IAErB,aAAa;IACb,YAAY,iBAAiB;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAIzC,iBAAiB;aACD,IAAI,EAAE,WAAW;IAGjC,wBAAwB;aACR,aAAa,CAAC,EAAE,OAAO;IARzC,SAAkB,IAAI,wBAAwB;;IAG5C,iBAAiB;IACD,IAAI,EAAE,WAAW;IACjC,aAAa;IACb,OAAO,EAAE,MAAM;IACf,wBAAwB;IACR,aAAa,CAAC,EAAE,OAAO,YAAA;CAI1C"}

package/dist/orm-common/src/exec/executable.d.ts

@@ -0,0 +1,79 @@
+import type { ColumnBuilderRecord, InferColumnExprs } from "../schema/factory/column-builder";
+import type { ProcedureBuilder } from "../schema/procedure-builder";
+import type { DbContext } from "../db-context";
+/**
+ * 저장 프로시저 실행 래퍼 클래스
+ *
+ * ProcedureBuilder로 정의된 프로시저를 실행하기 위한 클래스.
+ * DbContext에서 executable() 팩토리 함수를 통해 생성하여 사용한다.
+ *
+ * @template TParams - 프로시저 파라미터 타입
+ * @template TReturns - 프로시저 반환 타입
+ *
+ * @example
+ * ```typescript
+ * // 프로시저 실행
+ * const result = await db.getUserById().execute({ userId: 1n });
+ * ```
+ *
+ * @see {@link executable} 팩토리 함수
+ * @see {@link ProcedureBuilder} 프로시저 정의
+ */
+export declare class Executable<TParams extends ColumnBuilderRecord, TReturns extends ColumnBuilderRecord> {
+    private readonly _db;
+    private readonly _builder;
+    constructor(_db: DbContext, _builder: ProcedureBuilder<TParams, TReturns>);
+    /**
+     * 프로시저 실행 QueryDef 생성
+     */
+    getExecProcQueryDef(params?: InferColumnExprs<TParams>): {
+        type: "execProc";
+        procedure: {
+            database: string | undefined;
+            schema: string | undefined;
+            name: string;
+        };
+        params: {
+            [k: string]: import("..").Expr;
+        } | undefined;
+    };
+    /**
+     * 프로시저 실행
+     */
+    execute(params: InferColumnExprs<TParams>): Promise<InferColumnExprs<TReturns>[][]>;
+}
+/**
+ * Executable 생성 팩토리 함수
+ *
+ * DbContext에서 프로시저를 등록할 때 사용한다.
+ * ProcedureBuilder로 정의된 프로시저를 Executable로 래핑하여 반환한다.
+ *
+ * @template TParams - 프로시저 파라미터 타입
+ * @template TReturns - 프로시저 반환 타입
+ * @param db - DbContext 인스턴스
+ * @param builder - ProcedureBuilder 인스턴스
+ * @returns Executable 생성 함수
+ *
+ * @example
+ * ```typescript
+ * // 프로시저 정의
+ * const GetUserById = Procedure("GetUserById")
+ *   .database("mydb")
+ *   .params((c) => ({ userId: c.bigint() }))
+ *   .returns((c) => ({ id: c.bigint(), name: c.varchar(100) }))
+ *   .body("SELECT id, name FROM User WHERE id = userId");
+ *
+ * // DbContext에서 등록
+ * class MyDb extends DbContext {
+ *   getUserById = executable(this, GetUserById);
+ * }
+ *
+ * // 사용
+ * const result = await db.getUserById().execute({ userId: 1n });
+ * ```
+ *
+ * @see {@link Executable} 실행 클래스
+ * @see {@link ProcedureBuilder} 프로시저 정의
+ */
+export declare function executable<TParams extends ColumnBuilderRecord, TReturns extends ColumnBuilderRecord>(db: DbContext, builder: ProcedureBuilder<TParams, TReturns>): () => Executable<TParams, TReturns>;
+//# sourceMappingURL=executable.d.ts.map

package/dist/orm-common/src/exec/executable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executable.d.ts","sourceRoot":"","sources":["../../../../../orm-common/src/exec/executable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAC9F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI/C;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,UAAU,CAAC,OAAO,SAAS,mBAAmB,EAAE,QAAQ,SAAS,mBAAmB;IAE7F,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC;IAGhE;;OAEG;IACH,mBAAmB,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC;;;;;;;;;;;IA2BtD;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;CAG1F;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,UAAU,CAAC,OAAO,SAAS,mBAAmB,EAAE,QAAQ,SAAS,mBAAmB,EAClG,EAAE,EAAE,SAAS,EACb,OAAO,EAAE,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,GAC3C,MAAM,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAErC"}