@byline/db-postgres 2.1.2 → 2.2.0

package/dist/database/schema/auth.d.ts

@@ -9,6 +9,40 @@ export declare const adminUsers: import("drizzle-orm/pg-core").PgTableWithColumn
     name: "byline_admin_users";
     schema: undefined;
     columns: {
+        created_at: import("drizzle-orm/pg-core").PgColumn<{
+            name: string;
+            tableName: "byline_admin_users";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updated_at: import("drizzle-orm/pg-core").PgColumn<{
+            name: string;
+            tableName: "byline_admin_users";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         id: import("drizzle-orm/pg-core").PgColumn<{
             name: "id";
             tableName: "byline_admin_users";
@@ -259,9 +293,16 @@ export declare const adminUsers: import("drizzle-orm/pg-core").PgTableWithColumn
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export declare const adminRoles: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "byline_admin_roles";
+    schema: undefined;
+    columns: {
         created_at: import("drizzle-orm/pg-core").PgColumn<{
-            name: "created_at";
-            tableName: "byline_admin_users";
+            name: string;
+            tableName: "byline_admin_roles";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
@@ -277,8 +318,8 @@ export declare const adminUsers: import("drizzle-orm/pg-core").PgTableWithColumn
             generated: undefined;
         }, {}, {}>;
         updated_at: import("drizzle-orm/pg-core").PgColumn<{
-            name: "updated_at";
-            tableName: "byline_admin_users";
+            name: string;
+            tableName: "byline_admin_roles";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
@@ -293,13 +334,6 @@ export declare const adminUsers: import("drizzle-orm/pg-core").PgTableWithColumn
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-export declare const adminRoles: import("drizzle-orm/pg-core").PgTableWithColumns<{
-    name: "byline_admin_roles";
-    schema: undefined;
-    columns: {
         id: import("drizzle-orm/pg-core").PgColumn<{
             name: "id";
             tableName: "byline_admin_roles";
@@ -406,26 +440,16 @@ export declare const adminRoles: import("drizzle-orm/pg-core").PgTableWithColumn
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export declare const adminRoleAdminUser: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "byline_admin_role_admin_user";
+    schema: undefined;
+    columns: {
         created_at: import("drizzle-orm/pg-core").PgColumn<{
-            name: "created_at";
-            tableName: "byline_admin_roles";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        updated_at: import("drizzle-orm/pg-core").PgColumn<{
-            name: "updated_at";
-            tableName: "byline_admin_roles";
+            name: string;
+            tableName: "byline_admin_role_admin_user";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
@@ -440,13 +464,6 @@ export declare const adminRoles: import("drizzle-orm/pg-core").PgTableWithColumn
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-export declare const adminRoleAdminUser: import("drizzle-orm/pg-core").PgTableWithColumns<{
-    name: "byline_admin_role_admin_user";
-    schema: undefined;
-    columns: {
         admin_role_id: import("drizzle-orm/pg-core").PgColumn<{
             name: "admin_role_id";
             tableName: "byline_admin_role_admin_user";
@@ -481,9 +498,33 @@ export declare const adminRoleAdminUser: import("drizzle-orm/pg-core").PgTableWi
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export declare const adminPermissions: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "byline_admin_permissions";
+    schema: undefined;
+    columns: {
         created_at: import("drizzle-orm/pg-core").PgColumn<{
-            name: "created_at";
-            tableName: "byline_admin_role_admin_user";
+            name: string;
+            tableName: "byline_admin_permissions";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updated_at: import("drizzle-orm/pg-core").PgColumn<{
+            name: string;
+            tableName: "byline_admin_permissions";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
@@ -498,13 +539,6 @@ export declare const adminRoleAdminUser: import("drizzle-orm/pg-core").PgTableWi
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-export declare const adminPermissions: import("drizzle-orm/pg-core").PgTableWithColumns<{
-    name: "byline_admin_permissions";
-    schema: undefined;
-    columns: {
         id: import("drizzle-orm/pg-core").PgColumn<{
             name: "id";
             tableName: "byline_admin_permissions";
@@ -575,9 +609,23 @@ export declare const adminPermissions: import("drizzle-orm/pg-core").PgTableWith
         }, {}, {
             length: 128;
         }>;
+    };
+    dialect: "pg";
+}>;
+/**
+ * Refresh tokens are opaque random strings minted by `JwtSessionProvider`.
+ * We never store the plaintext — only a SHA-256 hash (`token_hash`). When
+ * a token is rotated, `revoked_at` is stamped and `rotated_to_id` points
+ * at the replacement row; presenting a rotated token is treated as replay
+ * and revokes the whole chain.
+ */
+export declare const adminRefreshTokens: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "byline_admin_refresh_tokens";
+    schema: undefined;
+    columns: {
         created_at: import("drizzle-orm/pg-core").PgColumn<{
-            name: "created_at";
-            tableName: "byline_admin_permissions";
+            name: string;
+            tableName: "byline_admin_refresh_tokens";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
@@ -593,8 +641,8 @@ export declare const adminPermissions: import("drizzle-orm/pg-core").PgTableWith
             generated: undefined;
         }, {}, {}>;
         updated_at: import("drizzle-orm/pg-core").PgColumn<{
-            name: "updated_at";
-            tableName: "byline_admin_permissions";
+            name: string;
+            tableName: "byline_admin_refresh_tokens";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
@@ -609,20 +657,6 @@ export declare const adminPermissions: import("drizzle-orm/pg-core").PgTableWith
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-/**
- * Refresh tokens are opaque random strings minted by `JwtSessionProvider`.
- * We never store the plaintext — only a SHA-256 hash (`token_hash`). When
- * a token is rotated, `revoked_at` is stamped and `rotated_to_id` points
- * at the replacement row; presenting a rotated token is treated as replay
- * and revokes the whole chain.
- */
-export declare const adminRefreshTokens: import("drizzle-orm/pg-core").PgTableWithColumns<{
-    name: "byline_admin_refresh_tokens";
-    schema: undefined;
-    columns: {
         id: import("drizzle-orm/pg-core").PgColumn<{
             name: "id";
             tableName: "byline_admin_refresh_tokens";
@@ -799,40 +833,6 @@ export declare const adminRefreshTokens: import("drizzle-orm/pg-core").PgTableWi
         }, {}, {
             length: 45;
         }>;
-        created_at: import("drizzle-orm/pg-core").PgColumn<{
-            name: "created_at";
-            tableName: "byline_admin_refresh_tokens";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        updated_at: import("drizzle-orm/pg-core").PgColumn<{
-            name: "updated_at";
-            tableName: "byline_admin_refresh_tokens";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
     };
     dialect: "pg";
 }>;

package/dist/database/schema/auth.js

@@ -25,6 +25,7 @@
  */
 import { relations } from 'drizzle-orm';
 import { boolean, index, integer, pgTable, primaryKey, text, timestamp, unique, uuid, varchar, } from 'drizzle-orm/pg-core';
+import { createdAt, timestamps } from './common.js';
 // ---------------------------------------------------------------------------
 // byline_admin_users
 // ---------------------------------------------------------------------------
@@ -55,8 +56,7 @@ export const adminUsers = pgTable('byline_admin_users', {
      */
     is_enabled: boolean('is_enabled').notNull().default(false),
     is_email_verified: boolean('is_email_verified').notNull().default(false),
-    created_at: timestamp('created_at').notNull().defaultNow(),
-    updated_at: timestamp('updated_at').notNull().defaultNow(),
+    ...timestamps,
 }, (table) => [index('idx_byline_admin_users_email').on(table.email)]);
 // ---------------------------------------------------------------------------
 // byline_admin_roles
@@ -71,8 +71,7 @@ export const adminRoles = pgTable('byline_admin_roles', {
     description: text('description'),
     /** Display ordering in the role-editor UI. */
     order: integer('order').notNull().default(0),
-    created_at: timestamp('created_at').notNull().defaultNow(),
-    updated_at: timestamp('updated_at').notNull().defaultNow(),
+    ...timestamps,
 }, (table) => [index('idx_byline_admin_roles_machine_name').on(table.machine_name)]);
 // ---------------------------------------------------------------------------
 // byline_admin_role_admin_user — many-to-many join
@@ -84,7 +83,7 @@ export const adminRoleAdminUser = pgTable('byline_admin_role_admin_user', {
     admin_user_id: uuid('admin_user_id')
         .notNull()
         .references(() => adminUsers.id, { onDelete: 'cascade' }),
-    created_at: timestamp('created_at').notNull().defaultNow(),
+    ...createdAt,
 }, (table) => [
     primaryKey({ columns: [table.admin_role_id, table.admin_user_id] }),
     index('idx_byline_admin_role_admin_user_user').on(table.admin_user_id),
@@ -100,8 +99,7 @@ export const adminPermissions = pgTable('byline_admin_permissions', {
         .references(() => adminRoles.id, { onDelete: 'cascade' }),
     /** Flat dotted ability key — see `@byline/auth` AbilityRegistry. */
     ability: varchar('ability', { length: 128 }).notNull(),
-    created_at: timestamp('created_at').notNull().defaultNow(),
-    updated_at: timestamp('updated_at').notNull().defaultNow(),
+    ...timestamps,
 }, (table) => [
     unique('uq_byline_admin_permissions_role_ability').on(table.admin_role_id, table.ability),
     index('idx_byline_admin_permissions_role').on(table.admin_role_id),
@@ -134,8 +132,7 @@ export const adminRefreshTokens = pgTable('byline_admin_refresh_tokens', {
     last_used_at: timestamp('last_used_at', { precision: 6, withTimezone: true }),
     user_agent: varchar('user_agent', { length: 512 }),
     ip: varchar('ip', { length: 45 }),
-    created_at: timestamp('created_at').notNull().defaultNow(),
-    updated_at: timestamp('updated_at').notNull().defaultNow(),
+    ...timestamps,
 }, (table) => [
     index('idx_byline_admin_refresh_tokens_user').on(table.admin_user_id),
     index('idx_byline_admin_refresh_tokens_token_hash').on(table.token_hash),

package/dist/database/schema/common.d.ts

@@ -0,0 +1,34 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+/**
+ * Both `created_at` and `updated_at` for tables whose rows are
+ * mutated in place (most application tables — users, roles, documents,
+ * store rows, paths).
+ *
+ * Spread into a `pgTable` definition:
+ *
+ *   pgTable('byline_admin_users', {
+ *     id: uuid('id').primaryKey(),
+ *     ...timestamps,
+ *   })
+ */
+export declare const timestamps: {
+    created_at: import("drizzle-orm").HasDefault<import("drizzle-orm").NotNull<import("drizzle-orm/pg-core").PgTimestampBuilderInitial<string>>>;
+    updated_at: import("drizzle-orm").HasDefault<import("drizzle-orm").NotNull<import("drizzle-orm/pg-core").PgTimestampBuilderInitial<string>>>;
+};
+/**
+ * `created_at` only — for tables whose rows are immutable once
+ * inserted (junction tables like `byline_admin_role_admin_user`,
+ * append-only relationship rows like `byline_document_relationships`,
+ * registry rows like `byline_counter_groups`).
+ *
+ * Spread into a `pgTable` definition the same way as `timestamps`.
+ */
+export declare const createdAt: {
+    created_at: import("drizzle-orm").HasDefault<import("drizzle-orm").NotNull<import("drizzle-orm/pg-core").PgTimestampBuilderInitial<string>>>;
+};

package/dist/database/schema/common.js

@@ -0,0 +1,45 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import { timestamp } from 'drizzle-orm/pg-core';
+/**
+ * Audit-timestamp column shape used across every Byline table.
+ * `TIMESTAMPTZ` with microsecond precision; stored in UTC, converted
+ * to/from the session timezone automatically.
+ *
+ * Defined once here so adding a new column to every table — or
+ * changing the precision/timezone behaviour across the schema — is a
+ * one-line edit.
+ */
+const auditTimestamp = (name) => timestamp(name, { precision: 6, withTimezone: true }).notNull().defaultNow();
+/**
+ * Both `created_at` and `updated_at` for tables whose rows are
+ * mutated in place (most application tables — users, roles, documents,
+ * store rows, paths).
+ *
+ * Spread into a `pgTable` definition:
+ *
+ *   pgTable('byline_admin_users', {
+ *     id: uuid('id').primaryKey(),
+ *     ...timestamps,
+ *   })
+ */
+export const timestamps = {
+    created_at: auditTimestamp('created_at'),
+    updated_at: auditTimestamp('updated_at'),
+};
+/**
+ * `created_at` only — for tables whose rows are immutable once
+ * inserted (junction tables like `byline_admin_role_admin_user`,
+ * append-only relationship rows like `byline_document_relationships`,
+ * registry rows like `byline_counter_groups`).
+ *
+ * Spread into a `pgTable` definition the same way as `timestamps`.
+ */
+export const createdAt = {
+    created_at: auditTimestamp('created_at'),
+};