@pdg/drizzle-mysql 1.0.3 → 1.0.5

package/README.md

@@ -333,6 +333,35 @@ await db.trans(async () => {
 
 `db.current()`는 현재 문맥의 Drizzle 데이터베이스 인스턴스를 반환합니다. 래퍼가 제공하지 않는 Drizzle 기능은 이 API로 직접 사용할 수 있습니다.
 
+### 테이블 수정·삭제 금지
+
+이 패키지의 `mysqlTable`에 `{ updateBlocked: true, deleteBlocked: true }`를 전달하면 등록과 조회는 유지하면서 테이블 전체의 수정·삭제를 금지합니다. 정책은 세 번째 인자에 전달하거나, 인덱스·제약조건 설정 콜백을 사용하는 경우 네 번째 인자에 전달합니다. 각 옵션을 생략하거나 `false`로 지정하면 해당 작업은 기존처럼 허용됩니다. 별도로 선언하는 정책 객체에는 `as const` 또는 `satisfies TablePolicy`를 사용해 `true` 리터럴 타입을 유지하면 타입 검사에서도 차단됩니다.
+
+```ts
+import { mysqlTable, int, varchar, index } from '@pdg/drizzle-mysql';
+
+const logs = mysqlTable(
+  'logs',
+  {
+    id: int().autoincrement().primaryKey(),
+    message: varchar({ length: 100 }).notNull(),
+  },
+  { updateBlocked: true, deleteBlocked: true },
+);
+
+const indexedLogs = mysqlTable(
+  'indexed_logs',
+  {
+    id: int().autoincrement().primaryKey(),
+    message: varchar({ length: 100 }).notNull(),
+  },
+  (t) => [index('indexed_logs_message_idx').on(t.message)],
+  { updateBlocked: true, deleteBlocked: true },
+);
+```
+
+`updateBlocked`는 `MySqlQuery.edit`와 `editByPrimaryKey`, `deleteBlocked`는 `remove`와 `removeByPrimaryKey` 호출을 TypeScript에서 차단합니다. 타입 정보가 사라지거나 JavaScript에서 호출하더라도 조건 콜백과 DB 접근 전에 명시적인 오류가 발생합니다. 테이블 수정 금지는 컬럼의 `updateAllowed()`보다 우선합니다. 정책은 `db.query(table)`과 직접 생성한 `MySqlQuery` 모두에 적용되지만, 원본 Drizzle 쿼리나 직접 실행한 SQL에는 적용되지 않습니다. DB 수준의 제한이 필요하면 별도로 `UPDATE`·`DELETE` 권한을 제한해야 합니다.
+
 ### 생성·수정 시각
 
 컬럼 정책은 이 패키지에서 가져온 `mysqlTable`에 선언합니다. 자동 증가 컬럼은 기본적으로 등록과 수정이 금지되며, 각각 `insertAllowed()`와 `updateAllowed()`로 허용할 수 있습니다. `primaryKey()`로 지정한 컬럼도 기본적으로 수정이 금지되며, `updateAllowed()`를 명시해야 수정할 수 있습니다. 다른 컬럼은 `insertBlocked()`와 `updateBlocked()`로 금지하거나 `updateRequired()`로 수정 시 필수로 지정합니다. 금지된 값을 전달하거나 필수 수정 값을 누락하면 런타임에도 오류가 발생합니다.

package/dist/MySqlQuery.d.cts

@@ -3,6 +3,7 @@ import { MySqlTable, MySqlColumn, type MySqlAsyncSelectBase } from 'drizzle-orm/
 import type { SelectedFields } from 'drizzle-orm/operations';
 import type { GetSelectTableName } from 'drizzle-orm/query-builders/select.types';
 import type { MySqlColumnSelectionName, MySqlSelectedNamedColumnUnion, MySqlSelectedNamedColumns, MySqlSelectedTableColumns, MySqlAliasTable } from './columns.cjs';
+import { type TableMutationPolicy } from './mysqlTable.cjs';
 import type { MySqlInsertValues, MySqlUpdateValues, MySqlCompareValues, MySqlColumnName, MySqlArrayCompareValues, MySqlRangeCompareValues, MySqlPatternCompareValues, MySqlNullConditionInput, MySqlConditions } from './@types/index.cjs';
 import type { MySql2Database } from 'drizzle-orm/mysql2';
 /********************************************************************************************************************
@@ -114,19 +115,28 @@ export declare class MySqlQuery<TTable extends MySqlTable, IV extends MySqlInser
     /********************************************************************************************************************
      * edit
      * ******************************************************************************************************************/
-    edit(set: UV, where: BaseWhere<this>): Omit<import("drizzle-orm/mysql-core").MySqlAsyncUpdateBase<import("drizzle-orm").Assume<import("drizzle-orm").Assume<TTable, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, import("drizzle-orm/mysql2").MySql2QueryResultHKT, false, "where">, "where">;
+    edit(this: this & (TableMutationPolicy<TTable> extends {
+        updateBlocked: true;
+    } ? never : unknown), set: UV, where: BaseWhere<this>): Omit<import("drizzle-orm/mysql-core").MySqlAsyncUpdateBase<import("drizzle-orm").Assume<import("drizzle-orm").Assume<TTable, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, import("drizzle-orm/mysql2").MySql2QueryResultHKT, false, "where">, "where">;
     /********************************************************************************************************************
      * editByPrimaryKey
      * ******************************************************************************************************************/
-    editByPrimaryKey(set: UV, key: PrimaryKeyInput<TTable>): Omit<import("drizzle-orm/mysql-core").MySqlAsyncUpdateBase<import("drizzle-orm").Assume<import("drizzle-orm").Assume<TTable, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, import("drizzle-orm/mysql2").MySql2QueryResultHKT, false, "where">, "where">;
+    editByPrimaryKey(this: this & (TableMutationPolicy<TTable> extends {
+        updateBlocked: true;
+    } ? never : unknown), set: UV, key: PrimaryKeyInput<TTable>): Omit<import("drizzle-orm/mysql-core").MySqlAsyncUpdateBase<import("drizzle-orm").Assume<import("drizzle-orm").Assume<TTable, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, import("drizzle-orm/mysql2").MySql2QueryResultHKT, false, "where">, "where">;
     /********************************************************************************************************************
      * remove
      * ******************************************************************************************************************/
-    remove(where: BaseWhere<this>): Omit<import("drizzle-orm/mysql-core").MySqlAsyncDeleteBase<import("drizzle-orm").Assume<TTable, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, import("drizzle-orm/mysql2").MySql2QueryResultHKT, false, "where">, "where">;
+    remove(this: this & (TableMutationPolicy<TTable> extends {
+        deleteBlocked: true;
+    } ? never : unknown), where: BaseWhere<this>): Omit<import("drizzle-orm/mysql-core").MySqlAsyncDeleteBase<import("drizzle-orm").Assume<TTable, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, import("drizzle-orm/mysql2").MySql2QueryResultHKT, false, "where">, "where">;
     /********************************************************************************************************************
      * removeByPrimaryKey
      * ******************************************************************************************************************/
-    removeByPrimaryKey(key: PrimaryKeyInput<TTable>): Omit<import("drizzle-orm/mysql-core").MySqlAsyncDeleteBase<import("drizzle-orm").Assume<TTable, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, import("drizzle-orm/mysql2").MySql2QueryResultHKT, false, "where">, "where">;
+    removeByPrimaryKey(this: this & (TableMutationPolicy<TTable> extends {
+        deleteBlocked: true;
+    } ? never : unknown), key: PrimaryKeyInput<TTable>): Omit<import("drizzle-orm/mysql-core").MySqlAsyncDeleteBase<import("drizzle-orm").Assume<TTable, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, import("drizzle-orm/mysql2").MySql2QueryResultHKT, false, "where">, "where">;
+    private assertMutationAllowed;
     /********************************************************************************************************************
      * eq
      * ******************************************************************************************************************/

package/dist/MySqlQuery.d.ts

@@ -3,6 +3,7 @@ import { MySqlTable, MySqlColumn, type MySqlAsyncSelectBase } from 'drizzle-orm/
 import type { SelectedFields } from 'drizzle-orm/operations';
 import type { GetSelectTableName } from 'drizzle-orm/query-builders/select.types';
 import type { MySqlColumnSelectionName, MySqlSelectedNamedColumnUnion, MySqlSelectedNamedColumns, MySqlSelectedTableColumns, MySqlAliasTable } from './columns.js';
+import { type TableMutationPolicy } from './mysqlTable.js';
 import type { MySqlInsertValues, MySqlUpdateValues, MySqlCompareValues, MySqlColumnName, MySqlArrayCompareValues, MySqlRangeCompareValues, MySqlPatternCompareValues, MySqlNullConditionInput, MySqlConditions } from './@types/index.js';
 import type { MySql2Database } from 'drizzle-orm/mysql2';
 /********************************************************************************************************************
@@ -114,19 +115,28 @@ export declare class MySqlQuery<TTable extends MySqlTable, IV extends MySqlInser
     /********************************************************************************************************************
      * edit
      * ******************************************************************************************************************/
-    edit(set: UV, where: BaseWhere<this>): Omit<import("drizzle-orm/mysql-core").MySqlAsyncUpdateBase<import("drizzle-orm").Assume<import("drizzle-orm").Assume<TTable, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, import("drizzle-orm/mysql2").MySql2QueryResultHKT, false, "where">, "where">;
+    edit(this: this & (TableMutationPolicy<TTable> extends {
+        updateBlocked: true;
+    } ? never : unknown), set: UV, where: BaseWhere<this>): Omit<import("drizzle-orm/mysql-core").MySqlAsyncUpdateBase<import("drizzle-orm").Assume<import("drizzle-orm").Assume<TTable, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, import("drizzle-orm/mysql2").MySql2QueryResultHKT, false, "where">, "where">;
     /********************************************************************************************************************
      * editByPrimaryKey
      * ******************************************************************************************************************/
-    editByPrimaryKey(set: UV, key: PrimaryKeyInput<TTable>): Omit<import("drizzle-orm/mysql-core").MySqlAsyncUpdateBase<import("drizzle-orm").Assume<import("drizzle-orm").Assume<TTable, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, import("drizzle-orm/mysql2").MySql2QueryResultHKT, false, "where">, "where">;
+    editByPrimaryKey(this: this & (TableMutationPolicy<TTable> extends {
+        updateBlocked: true;
+    } ? never : unknown), set: UV, key: PrimaryKeyInput<TTable>): Omit<import("drizzle-orm/mysql-core").MySqlAsyncUpdateBase<import("drizzle-orm").Assume<import("drizzle-orm").Assume<TTable, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, import("drizzle-orm/mysql2").MySql2QueryResultHKT, false, "where">, "where">;
     /********************************************************************************************************************
      * remove
      * ******************************************************************************************************************/
-    remove(where: BaseWhere<this>): Omit<import("drizzle-orm/mysql-core").MySqlAsyncDeleteBase<import("drizzle-orm").Assume<TTable, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, import("drizzle-orm/mysql2").MySql2QueryResultHKT, false, "where">, "where">;
+    remove(this: this & (TableMutationPolicy<TTable> extends {
+        deleteBlocked: true;
+    } ? never : unknown), where: BaseWhere<this>): Omit<import("drizzle-orm/mysql-core").MySqlAsyncDeleteBase<import("drizzle-orm").Assume<TTable, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, import("drizzle-orm/mysql2").MySql2QueryResultHKT, false, "where">, "where">;
     /********************************************************************************************************************
      * removeByPrimaryKey
      * ******************************************************************************************************************/
-    removeByPrimaryKey(key: PrimaryKeyInput<TTable>): Omit<import("drizzle-orm/mysql-core").MySqlAsyncDeleteBase<import("drizzle-orm").Assume<TTable, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, import("drizzle-orm/mysql2").MySql2QueryResultHKT, false, "where">, "where">;
+    removeByPrimaryKey(this: this & (TableMutationPolicy<TTable> extends {
+        deleteBlocked: true;
+    } ? never : unknown), key: PrimaryKeyInput<TTable>): Omit<import("drizzle-orm/mysql-core").MySqlAsyncDeleteBase<import("drizzle-orm").Assume<TTable, MySqlTable<import("drizzle-orm/mysql-core").TableConfig>>, import("drizzle-orm/mysql2").MySql2QueryResultHKT, false, "where">, "where">;
+    private assertMutationAllowed;
     /********************************************************************************************************************
      * eq
      * ******************************************************************************************************************/

package/dist/index.cjs

@@ -1,4 +1,4 @@
-'use strict';Object.defineProperty(exports,'__esModule',{value:true});var mysql=require('mysql2/promise'),mysql2=require('drizzle-orm/mysql2'),native=require('drizzle-orm'),node_async_hooks=require('node:async_hooks'),alias=require('drizzle-orm/mysql-core/alias'),mysqlCore=require('drizzle-orm/mysql-core'),columnBuilder=require('drizzle-orm/column-builder');function _interopNamespaceDefault(e){var n=Object.create(null);if(e){Object.keys(e).forEach(function(k){if(k!=='default'){var d=Object.getOwnPropertyDescriptor(e,k);Object.defineProperty(n,k,d.get?d:{enumerable:true,get:function(){return e[k]}});}})}n.default=e;return Object.freeze(n)}var native__namespace=/*#__PURE__*/_interopNamespaceDefault(native);function createAlias(schema) {
+'use strict';Object.defineProperty(exports,'__esModule',{value:true});var mysql=require('mysql2/promise'),mysql2=require('drizzle-orm/mysql2'),native=require('drizzle-orm'),node_async_hooks=require('node:async_hooks'),alias=require('drizzle-orm/mysql-core/alias'),mysqlCore=require('drizzle-orm/mysql-core'),common=require('drizzle-orm/mysql-core/columns/common');function _interopNamespaceDefault(e){var n=Object.create(null);if(e){Object.keys(e).forEach(function(k){if(k!=='default'){var d=Object.getOwnPropertyDescriptor(e,k);Object.defineProperty(n,k,d.get?d:{enumerable:true,get:function(){return e[k]}});}})}n.default=e;return Object.freeze(n)}var native__namespace=/*#__PURE__*/_interopNamespaceDefault(native);function createAlias(schema) {
     /********************************************************************************************************************
      * getDefaultAlias
      * ******************************************************************************************************************/
@@ -202,7 +202,7 @@ for (const [method, policy] of Object.entries({
     createdAt: { timestamp: 'created' },
     updatedAt: { timestamp: 'updated' },
 })) {
-    Object.defineProperty(columnBuilder.ColumnBuilder.prototype, method, {
+    Object.defineProperty(common.MySqlColumnBuilder.prototype, method, {
         configurable: true,
         value: function () {
             policies.set(this, { ...policies.get(this), ...policy });
@@ -211,15 +211,28 @@ for (const [method, policy] of Object.entries({
     });
 }
 const tablePolicies = new WeakMap();
+const tableMutationPolicies = new WeakMap();
 function getColumnPolicies(table) {
     return tablePolicies.get(table) ?? {};
 }
-function mysqlTable(name, columns, extraConfig) {
+function getTablePolicy(table) {
+    return tableMutationPolicies.get(table) ?? {};
+}
+function mysqlTable(name, columns, extraConfigOrPolicy, policy) {
+    const extraConfig = typeof extraConfigOrPolicy === 'function' ? extraConfigOrPolicy : undefined;
+    const mutationPolicy = typeof extraConfigOrPolicy === 'object' ? extraConfigOrPolicy : policy;
+    const nativeExtraConfig = extraConfig
+        ? (self) => {
+            const config = extraConfig(self);
+            return Array.isArray(config) ? config : Object.values(config);
+        }
+        : undefined;
     let builders = {};
     const table = typeof columns === 'function'
-        ? mysqlCore.mysqlTable(name, (types) => (builders = columns(types)), extraConfig)
-        : mysqlCore.mysqlTable(name, (builders = columns), extraConfig);
+        ? mysqlCore.mysqlTable(name, (types) => (builders = columns(types)), nativeExtraConfig)
+        : mysqlCore.mysqlTable(name, (builders = columns), nativeExtraConfig);
     tablePolicies.set(table, Object.fromEntries(Object.entries(builders).map(([key, builder]) => [key, policies.get(builder) ?? {}])));
+    tableMutationPolicies.set(table, { ...mutationPolicy });
     return table;
 }/********************************************************************************************************************
  * MySqlQuery
@@ -419,9 +432,7 @@ class MySqlQuery {
                 values[key] === undefined) {
                 throw new Error(`update: column "${key}" is required.`);
             }
-            if (policy.timestamp &&
-                values[key] === undefined &&
-                (operation === 'insert' || policy.timestamp === 'updated')) {
+            if (policy.timestamp && values[key] === undefined && (operation === 'insert' || policy.timestamp === 'updated')) {
                 if (!generated) {
                     const getTimestamp = this.getTimestamp ?? this.current.getTimestamp;
                     if (!getTimestamp)
@@ -482,6 +493,7 @@ class MySqlQuery {
      * edit
      * ******************************************************************************************************************/
     edit(set, where) {
+        this.assertMutationAllowed('update', 'edit');
         const condition = typeof where === 'function' ? where(this) : where;
         if (!native.is(condition, native.SQL)) {
             throw new Error('edit: a SQL where condition is required.');
@@ -496,12 +508,14 @@ class MySqlQuery {
      * editByPrimaryKey
      * ******************************************************************************************************************/
     editByPrimaryKey(set, key) {
+        this.assertMutationAllowed('update', 'editByPrimaryKey');
         return this.edit(set, this.primaryKeyCondition(key, 'editByPrimaryKey'));
     }
     /********************************************************************************************************************
      * remove
      * ******************************************************************************************************************/
     remove(where) {
+        this.assertMutationAllowed('delete', 'remove');
         const condition = typeof where === 'function' ? where(this) : where;
         if (!native.is(condition, native.SQL)) {
             throw new Error('remove: a SQL where condition is required.');
@@ -513,8 +527,15 @@ class MySqlQuery {
      * removeByPrimaryKey
      * ******************************************************************************************************************/
     removeByPrimaryKey(key) {
+        this.assertMutationAllowed('delete', 'removeByPrimaryKey');
         return this.remove(this.primaryKeyCondition(key, 'removeByPrimaryKey'));
     }
+    assertMutationAllowed(operation, method) {
+        const policy = getTablePolicy(this.t);
+        if (operation === 'update' ? policy.updateBlocked : policy.deleteBlocked) {
+            throw new Error(`${method}: ${operation} is blocked for table "${mysqlCore.getTableConfig(this.t).name}".`);
+        }
+    }
     /********************************************************************************************************************
      * eq
      * ******************************************************************************************************************/

package/dist/index.d.cts

@@ -2,7 +2,7 @@ import { drizzleMySql } from './drizzleMySql.cjs';
 export default drizzleMySql;
 export * from './@types/index.cjs';
 export * from './columns.cjs';
-export { mysqlTable } from './mysqlTable.cjs';
+export { mysqlTable, type TablePolicy } from './mysqlTable.cjs';
 export * from './conditions.cjs';
 export * from './drizzleMySql.cjs';
 export * from './MySqlQuery.cjs';

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { drizzleMySql } from './drizzleMySql.js';
 export default drizzleMySql;
 export * from './@types/index.js';
 export * from './columns.js';
-export { mysqlTable } from './mysqlTable.js';
+export { mysqlTable, type TablePolicy } from './mysqlTable.js';
 export * from './conditions.js';
 export * from './drizzleMySql.js';
 export * from './MySqlQuery.js';

package/dist/index.esm.js

@@ -1,4 +1,4 @@
-import mysql from'mysql2/promise';import {drizzle}from'drizzle-orm/mysql2';import*as native from'drizzle-orm';import {isTable,getTableColumns,sql,is,SQL,eq,and,count,defineRelations}from'drizzle-orm';export{asc,avg,avgDistinct,count,countDistinct,desc,exists,max,min,not,notExists,sum,sumDistinct}from'drizzle-orm';import {AsyncLocalStorage}from'node:async_hooks';import {alias}from'drizzle-orm/mysql-core/alias';import {MySqlTable,mysqlTable as mysqlTable$1,getTableConfig,MySqlColumn}from'drizzle-orm/mysql-core';export{bigint,binary,blob,boolean,char,check,customType,date,datetime,decimal,double,float,foreignKey,index,int,json,longblob,longtext,mediumblob,mediumint,mediumtext,mysqlDatabase,mysqlEnum,mysqlSchema,mysqlTableCreator,mysqlView,primaryKey,real,serial,smallint,text,time,timestamp,tinyblob,tinyint,tinytext,unique,uniqueIndex,varbinary,varchar,year}from'drizzle-orm/mysql-core';import {ColumnBuilder}from'drizzle-orm/column-builder';function createAlias(schema) {
+import mysql from'mysql2/promise';import {drizzle}from'drizzle-orm/mysql2';import*as native from'drizzle-orm';import {isTable,getTableColumns,sql,is,SQL,eq,and,count,defineRelations}from'drizzle-orm';export{asc,avg,avgDistinct,count,countDistinct,desc,exists,max,min,not,notExists,sum,sumDistinct}from'drizzle-orm';import {AsyncLocalStorage}from'node:async_hooks';import {alias}from'drizzle-orm/mysql-core/alias';import {MySqlTable,mysqlTable as mysqlTable$1,getTableConfig,MySqlColumn}from'drizzle-orm/mysql-core';export{bigint,binary,blob,boolean,char,check,customType,date,datetime,decimal,double,float,foreignKey,index,int,json,longblob,longtext,mediumblob,mediumint,mediumtext,mysqlDatabase,mysqlEnum,mysqlSchema,mysqlTableCreator,mysqlView,primaryKey,real,serial,smallint,text,time,timestamp,tinyblob,tinyint,tinytext,unique,uniqueIndex,varbinary,varchar,year}from'drizzle-orm/mysql-core';import {MySqlColumnBuilder}from'drizzle-orm/mysql-core/columns/common';function createAlias(schema) {
     /********************************************************************************************************************
      * getDefaultAlias
      * ******************************************************************************************************************/
@@ -202,7 +202,7 @@ for (const [method, policy] of Object.entries({
     createdAt: { timestamp: 'created' },
     updatedAt: { timestamp: 'updated' },
 })) {
-    Object.defineProperty(ColumnBuilder.prototype, method, {
+    Object.defineProperty(MySqlColumnBuilder.prototype, method, {
         configurable: true,
         value: function () {
             policies.set(this, { ...policies.get(this), ...policy });
@@ -211,15 +211,28 @@ for (const [method, policy] of Object.entries({
     });
 }
 const tablePolicies = new WeakMap();
+const tableMutationPolicies = new WeakMap();
 function getColumnPolicies(table) {
     return tablePolicies.get(table) ?? {};
 }
-function mysqlTable(name, columns, extraConfig) {
+function getTablePolicy(table) {
+    return tableMutationPolicies.get(table) ?? {};
+}
+function mysqlTable(name, columns, extraConfigOrPolicy, policy) {
+    const extraConfig = typeof extraConfigOrPolicy === 'function' ? extraConfigOrPolicy : undefined;
+    const mutationPolicy = typeof extraConfigOrPolicy === 'object' ? extraConfigOrPolicy : policy;
+    const nativeExtraConfig = extraConfig
+        ? (self) => {
+            const config = extraConfig(self);
+            return Array.isArray(config) ? config : Object.values(config);
+        }
+        : undefined;
     let builders = {};
     const table = typeof columns === 'function'
-        ? mysqlTable$1(name, (types) => (builders = columns(types)), extraConfig)
-        : mysqlTable$1(name, (builders = columns), extraConfig);
+        ? mysqlTable$1(name, (types) => (builders = columns(types)), nativeExtraConfig)
+        : mysqlTable$1(name, (builders = columns), nativeExtraConfig);
     tablePolicies.set(table, Object.fromEntries(Object.entries(builders).map(([key, builder]) => [key, policies.get(builder) ?? {}])));
+    tableMutationPolicies.set(table, { ...mutationPolicy });
     return table;
 }/********************************************************************************************************************
  * MySqlQuery
@@ -419,9 +432,7 @@ class MySqlQuery {
                 values[key] === undefined) {
                 throw new Error(`update: column "${key}" is required.`);
             }
-            if (policy.timestamp &&
-                values[key] === undefined &&
-                (operation === 'insert' || policy.timestamp === 'updated')) {
+            if (policy.timestamp && values[key] === undefined && (operation === 'insert' || policy.timestamp === 'updated')) {
                 if (!generated) {
                     const getTimestamp = this.getTimestamp ?? this.current.getTimestamp;
                     if (!getTimestamp)
@@ -482,6 +493,7 @@ class MySqlQuery {
      * edit
      * ******************************************************************************************************************/
     edit(set, where) {
+        this.assertMutationAllowed('update', 'edit');
         const condition = typeof where === 'function' ? where(this) : where;
         if (!is(condition, SQL)) {
             throw new Error('edit: a SQL where condition is required.');
@@ -496,12 +508,14 @@ class MySqlQuery {
      * editByPrimaryKey
      * ******************************************************************************************************************/
     editByPrimaryKey(set, key) {
+        this.assertMutationAllowed('update', 'editByPrimaryKey');
         return this.edit(set, this.primaryKeyCondition(key, 'editByPrimaryKey'));
     }
     /********************************************************************************************************************
      * remove
      * ******************************************************************************************************************/
     remove(where) {
+        this.assertMutationAllowed('delete', 'remove');
         const condition = typeof where === 'function' ? where(this) : where;
         if (!is(condition, SQL)) {
             throw new Error('remove: a SQL where condition is required.');
@@ -513,8 +527,15 @@ class MySqlQuery {
      * removeByPrimaryKey
      * ******************************************************************************************************************/
     removeByPrimaryKey(key) {
+        this.assertMutationAllowed('delete', 'removeByPrimaryKey');
         return this.remove(this.primaryKeyCondition(key, 'removeByPrimaryKey'));
     }
+    assertMutationAllowed(operation, method) {
+        const policy = getTablePolicy(this.t);
+        if (operation === 'update' ? policy.updateBlocked : policy.deleteBlocked) {
+            throw new Error(`${method}: ${operation} is blocked for table "${getTableConfig(this.t).name}".`);
+        }
+    }
     /********************************************************************************************************************
      * eq
      * ******************************************************************************************************************/

package/dist/mysqlTable.d.cts

@@ -1,4 +1,4 @@
-import { type ColumnBuilderBase } from 'drizzle-orm/column-builder';
+import type { ColumnBuilderBase, ColumnBuilderBaseConfig, ColumnBuilderExtraConfig, ColumnType } from 'drizzle-orm/column-builder';
 import { type MySqlTable, type MySqlTableWithColumns } from 'drizzle-orm/mysql-core';
 import type { BuildColumns } from 'drizzle-orm/column-builder';
 import type { MySqlColumnBuilders } from 'drizzle-orm/mysql-core/columns/all';
@@ -8,13 +8,18 @@ export type ColumnPolicy = {
     update?: 'blocked' | 'allowed' | 'required';
     timestamp?: 'created' | 'updated';
 };
+export type TablePolicy = {
+    updateBlocked?: boolean;
+    deleteBlocked?: boolean;
+};
 declare const policyType: unique symbol;
 declare const tablePolicyType: unique symbol;
+declare const tableMutationPolicyType: unique symbol;
 type Mark<T, P extends ColumnPolicy> = T & {
     readonly [policyType]: P;
 };
-declare module 'drizzle-orm/column-builder' {
-    interface ColumnBuilder<T, TRuntimeConfig, TExtraConfig> {
+declare module 'drizzle-orm/mysql-core/columns/common' {
+    interface MySqlColumnBuilder<T extends ColumnBuilderBaseConfig<ColumnType>, TRuntimeConfig extends object, TExtraConfig extends ColumnBuilderExtraConfig> {
         insertBlocked(): Mark<this, {
             insert: 'blocked';
         }>;
@@ -46,7 +51,10 @@ type Policies<C> = {
 export type TablePolicies<T> = T extends {
     readonly [tablePolicyType]: infer P;
 } ? P : {};
-type TableResult<N extends string, C extends Record<string, ColumnBuilderBase>> = MySqlTableWithColumns<{
+export type TableMutationPolicy<T> = T extends {
+    readonly [tableMutationPolicyType]: infer P;
+} ? P : {};
+type TableResult<N extends string, C extends Record<string, ColumnBuilderBase>, P extends TablePolicy> = MySqlTableWithColumns<{
     name: N;
     schema: undefined;
     columns: BuildColumns<N, C, 'mysql'>;
@@ -54,7 +62,10 @@ type TableResult<N extends string, C extends Record<string, ColumnBuilderBase>>
     isAlias: false;
 }> & {
     readonly [tablePolicyType]: Policies<C>;
+    readonly [tableMutationPolicyType]: P;
 };
 export declare function getColumnPolicies(table: MySqlTable): Record<string, ColumnPolicy>;
-export declare function mysqlTable<N extends string, C extends Record<string, ColumnBuilderBase>>(name: N, columns: C | ((types: MySqlColumnBuilders) => C), extraConfig?: (self: BuildColumns<N, C, 'mysql'>) => MySqlTableExtraConfig | (MySqlTableExtraConfigValue | MySqlTableExtraConfigValue[])[]): TableResult<N, C>;
+export declare function getTablePolicy(table: MySqlTable): TablePolicy;
+type ExtraConfig<N extends string, C extends Record<string, ColumnBuilderBase>> = (self: BuildColumns<N, C, 'mysql'>) => MySqlTableExtraConfig | (MySqlTableExtraConfigValue | MySqlTableExtraConfigValue[])[];
+export declare function mysqlTable<N extends string, C extends Record<string, ColumnBuilderBase>, const P extends TablePolicy = {}, const Q extends TablePolicy = {}>(name: N, columns: C | ((types: MySqlColumnBuilders) => C), extraConfigOrPolicy?: ExtraConfig<N, C> | (P & TablePolicy), policy?: Q & TablePolicy): TableResult<N, C, P & Q>;
 export {};

package/dist/mysqlTable.d.ts

@@ -1,4 +1,4 @@
-import { type ColumnBuilderBase } from 'drizzle-orm/column-builder';
+import type { ColumnBuilderBase, ColumnBuilderBaseConfig, ColumnBuilderExtraConfig, ColumnType } from 'drizzle-orm/column-builder';
 import { type MySqlTable, type MySqlTableWithColumns } from 'drizzle-orm/mysql-core';
 import type { BuildColumns } from 'drizzle-orm/column-builder';
 import type { MySqlColumnBuilders } from 'drizzle-orm/mysql-core/columns/all';
@@ -8,13 +8,18 @@ export type ColumnPolicy = {
     update?: 'blocked' | 'allowed' | 'required';
     timestamp?: 'created' | 'updated';
 };
+export type TablePolicy = {
+    updateBlocked?: boolean;
+    deleteBlocked?: boolean;
+};
 declare const policyType: unique symbol;
 declare const tablePolicyType: unique symbol;
+declare const tableMutationPolicyType: unique symbol;
 type Mark<T, P extends ColumnPolicy> = T & {
     readonly [policyType]: P;
 };
-declare module 'drizzle-orm/column-builder' {
-    interface ColumnBuilder<T, TRuntimeConfig, TExtraConfig> {
+declare module 'drizzle-orm/mysql-core/columns/common' {
+    interface MySqlColumnBuilder<T extends ColumnBuilderBaseConfig<ColumnType>, TRuntimeConfig extends object, TExtraConfig extends ColumnBuilderExtraConfig> {
         insertBlocked(): Mark<this, {
             insert: 'blocked';
         }>;
@@ -46,7 +51,10 @@ type Policies<C> = {
 export type TablePolicies<T> = T extends {
     readonly [tablePolicyType]: infer P;
 } ? P : {};
-type TableResult<N extends string, C extends Record<string, ColumnBuilderBase>> = MySqlTableWithColumns<{
+export type TableMutationPolicy<T> = T extends {
+    readonly [tableMutationPolicyType]: infer P;
+} ? P : {};
+type TableResult<N extends string, C extends Record<string, ColumnBuilderBase>, P extends TablePolicy> = MySqlTableWithColumns<{
     name: N;
     schema: undefined;
     columns: BuildColumns<N, C, 'mysql'>;
@@ -54,7 +62,10 @@ type TableResult<N extends string, C extends Record<string, ColumnBuilderBase>>
     isAlias: false;
 }> & {
     readonly [tablePolicyType]: Policies<C>;
+    readonly [tableMutationPolicyType]: P;
 };
 export declare function getColumnPolicies(table: MySqlTable): Record<string, ColumnPolicy>;
-export declare function mysqlTable<N extends string, C extends Record<string, ColumnBuilderBase>>(name: N, columns: C | ((types: MySqlColumnBuilders) => C), extraConfig?: (self: BuildColumns<N, C, 'mysql'>) => MySqlTableExtraConfig | (MySqlTableExtraConfigValue | MySqlTableExtraConfigValue[])[]): TableResult<N, C>;
+export declare function getTablePolicy(table: MySqlTable): TablePolicy;
+type ExtraConfig<N extends string, C extends Record<string, ColumnBuilderBase>> = (self: BuildColumns<N, C, 'mysql'>) => MySqlTableExtraConfig | (MySqlTableExtraConfigValue | MySqlTableExtraConfigValue[])[];
+export declare function mysqlTable<N extends string, C extends Record<string, ColumnBuilderBase>, const P extends TablePolicy = {}, const Q extends TablePolicy = {}>(name: N, columns: C | ((types: MySqlColumnBuilders) => C), extraConfigOrPolicy?: ExtraConfig<N, C> | (P & TablePolicy), policy?: Q & TablePolicy): TableResult<N, C, P & Q>;
 export {};

package/package.json

@@ -2,7 +2,7 @@
   "name": "@pdg/drizzle-mysql",
   "title": "Drizzle for MySql",
   "description": "Drizzle for MySql",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.esm.js",