@teamblind/axeda-core 0.1.0-alpha.0 → 0.1.0-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @teamblind/axeda-core
 
+## 0.1.0-alpha.1
+
+### Patch Changes
+
+- ce83aff: Shorten the ids of audit events from 50 to 36 characters so they fit the `id` column Better Auth creates on MySQL (`varchar(36)`); on SQLite and PostgreSQL the length was never a problem, which is why it went unnoticed. They still sort by time as text, also within one millisecond or when the clock goes back, and carry 88 random bits against collisions between processes. Events already stored keep their ids and keep their place in the order.
+
 ## 0.1.0-alpha.0
 
 ### Minor Changes

package/README.md

@@ -2,7 +2,7 @@
 
 The authorization policy and use cases of Axeda: effective permissions with downward inheritance, anti-escalation rules, companies, businesses, invitations, users, menus and audit. It depends on neither Better Auth nor any HTTP framework; it talks to storage through ports.
 
-> **Status:** alpha (`0.1.0-alpha.0`); the API can still change before 1.0. Install with `npm install @teamblind/axeda-core@alpha`. Documentation: [English](https://github.com/teamblindmx/axeda/tree/main/docs/en) · [Español](https://github.com/teamblindmx/axeda/tree/main/docs/es).
+> **Status:** alpha (`0.1.0-alpha.1`); the API can still change before 1.0. Install with `npm install @teamblind/axeda-core@alpha`. Documentation: [English](https://github.com/teamblindmx/axeda/tree/main/docs/en) · [Español](https://github.com/teamblindmx/axeda/tree/main/docs/es).
 
 ```ts
 import { createAxeda } from '@teamblind/axeda-core';
@@ -10,4 +10,6 @@ import { createAxeda } from '@teamblind/axeda-core';
 
 Most applications use it through [`@teamblind/axeda-better-auth`](https://github.com/teamblindmx/axeda/tree/main/packages/better-auth) and only import types or `createAxeda` directly for tests.
 
+Guides: [Quick start](https://github.com/teamblindmx/axeda/blob/main/docs/en/quickstart.md) · [Configuration](https://github.com/teamblindmx/axeda/blob/main/docs/en/configuration.md) · [Reference](https://github.com/teamblindmx/axeda/blob/main/docs/en/reference.md) · [Upgrading](https://github.com/teamblindmx/axeda/blob/main/docs/en/upgrading.md).
+
 Part of [Axeda](https://github.com/teamblindmx/axeda), hierarchical authorization (global → company → business) on top of [Better Auth](https://www.better-auth.com). Licensed under [Apache-2.0](LICENSE).

package/dist/domain/audit.d.ts

@@ -22,10 +22,12 @@ export interface AuditEvent {
 export type NewAuditEvent = Omit<AuditEvent, 'id' | 'at'>;
 /** Tamaño máximo de `metadata` serializado (S12). */
 export declare const MAX_AUDIT_METADATA_BYTES = 2048;
+/** Largo de un identificador de auditoría: cabe en la columna `id` de Better Auth en MySQL. */
+export declare const AUDIT_ID_LENGTH = 36;
 /**
- * Generador de identificadores de auditoría que ordenan cronológicamente como cadenas:
- * milisegundos, un contador (estrictamente creciente dentro del proceso, aunque el reloj
- * retroceda o dos eventos caigan en el mismo milisegundo) y un UUID para evitar colisiones
- * entre procesos.
+ * Generador de identificadores de auditoría que ordenan cronológicamente como cadenas, de
+ * `AUDIT_ID_LENGTH` caracteres: milisegundos, un contador (estrictamente creciente dentro del
+ * proceso, aunque el reloj retroceda o dos eventos caigan en el mismo milisegundo) y 88 bits
+ * aleatorios para evitar colisiones entre procesos.
  */
 export declare function createAuditIdFactory(): (at: Date) => string;

package/dist/domain/audit.js

@@ -1,10 +1,12 @@
 /** Tamaño máximo de `metadata` serializado (S12). */
 export const MAX_AUDIT_METADATA_BYTES = 2048;
+/** Largo de un identificador de auditoría: cabe en la columna `id` de Better Auth en MySQL. */
+export const AUDIT_ID_LENGTH = 36;
 /**
- * Generador de identificadores de auditoría que ordenan cronológicamente como cadenas:
- * milisegundos, un contador (estrictamente creciente dentro del proceso, aunque el reloj
- * retroceda o dos eventos caigan en el mismo milisegundo) y un UUID para evitar colisiones
- * entre procesos.
+ * Generador de identificadores de auditoría que ordenan cronológicamente como cadenas, de
+ * `AUDIT_ID_LENGTH` caracteres: milisegundos, un contador (estrictamente creciente dentro del
+ * proceso, aunque el reloj retroceda o dos eventos caigan en el mismo milisegundo) y 88 bits
+ * aleatorios para evitar colisiones entre procesos.
  */
 export function createAuditIdFactory() {
     let lastMillis = 0;
@@ -13,6 +15,7 @@ export function createAuditIdFactory() {
         const millis = Math.max(at.getTime(), lastMillis);
         sequence = millis === lastMillis ? sequence + 1 : 0;
         lastMillis = millis;
-        return `${millis.toString(36).padStart(9, '0')}${sequence.toString(36).padStart(4, '0')}-${globalThis.crypto.randomUUID()}`;
+        const random = Array.from(globalThis.crypto.getRandomValues(new Uint8Array(11)), (byte) => byte.toString(16).padStart(2, '0')).join('');
+        return `${millis.toString(36).padStart(9, '0')}${sequence.toString(36).padStart(4, '0')}-${random}`;
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teamblind/axeda-core",
-  "version": "0.1.0-alpha.0",
+  "version": "0.1.0-alpha.1",
   "description": "Axeda core: hierarchical authorization policy, use cases and ports (no Better Auth or framework dependencies).",
   "license": "Apache-2.0",
   "author": "TeamBlind",