@voyant-travel/db 0.108.0

package/dist/index.js

@@ -0,0 +1,155 @@
+import { neon, Pool } from "@neondatabase/serverless";
+import { drizzle as drizzleNeon } from "drizzle-orm/neon-http";
+import { drizzle as drizzleNeonServerless } from "drizzle-orm/neon-serverless";
+import { withReplicas } from "drizzle-orm/pg-core";
+import { drizzle as drizzlePostgres } from "drizzle-orm/postgres-js";
+import postgres from "postgres";
+import { resolveNodePostgresOptions, resolveServerlessPoolConfig, warnIfDirectNeonEndpoint, } from "./connection-config.js";
+import { VOYANT_DB_DISPOSE, VOYANT_DB_SUPPORTS_TRANSACTIONS } from "./transaction-capability.js";
+function tagTransactionCapability(db, supportsTransactions, dispose) {
+    Object.defineProperty(db, VOYANT_DB_SUPPORTS_TRANSACTIONS, {
+        value: supportsTransactions,
+        enumerable: false,
+        configurable: false,
+    });
+    if (dispose) {
+        Object.defineProperty(db, VOYANT_DB_DISPOSE, {
+            value: dispose,
+            enumerable: false,
+            configurable: false,
+        });
+    }
+    return db;
+}
+export function createDbClient(connectionString, options) {
+    const { adapter = process.env.DB_ADAPTER || "edge", schema, replicas = [], nodeMaxConnections, timeouts, } = options || {};
+    if (adapter === "node") {
+        const nodeOptions = resolveNodePostgresOptions({ max: nodeMaxConnections, timeouts });
+        const client = postgres(connectionString, nodeOptions);
+        const primary = tagTransactionCapability(schema ? drizzlePostgres(client, { schema }) : drizzlePostgres(client), true);
+        if (replicas.length === 0) {
+            return primary;
+        }
+        const replicaInstances = replicas.map((replicaUrl) => {
+            const replicaClient = postgres(replicaUrl, nodeOptions);
+            return schema ? drizzlePostgres(replicaClient, { schema }) : drizzlePostgres(replicaClient);
+        });
+        const [firstReplica, ...otherReplicas] = replicaInstances;
+        if (firstReplica) {
+            return tagTransactionCapability(withReplicas(primary, [firstReplica, ...otherReplicas]), true);
+        }
+        return primary;
+    }
+    if (adapter === "serverless") {
+        if (replicas.length > 0) {
+            throw new Error("DB_ADAPTER=serverless does not support read replicas");
+        }
+        return createServerlessDbClient(connectionString, {
+            schema,
+            pool: options?.serverlessPool,
+            timeouts,
+        }).db;
+    }
+    // edge (neon-http): the Neon HTTP client has no client-side query/statement
+    // timeout config — queries rely on the server-side default statement_timeout
+    // and the Workers runtime's own request limits. A follow-up handles request
+    // deadlines at a different layer; do NOT try to bolt timeouts on here.
+    const sql = neon(connectionString);
+    const primary = tagTransactionCapability(schema ? drizzleNeon(sql, { schema }) : drizzleNeon(sql), false);
+    if (replicas.length === 0) {
+        return primary;
+    }
+    const replicaInstances = replicas.map((replicaUrl) => {
+        const replicaSql = neon(replicaUrl);
+        return schema ? drizzleNeon(replicaSql, { schema }) : drizzleNeon(replicaSql);
+    });
+    const [firstReplica, ...otherReplicas] = replicaInstances;
+    if (firstReplica) {
+        return tagTransactionCapability(withReplicas(primary, [firstReplica, ...otherReplicas]), false);
+    }
+    return primary;
+}
+/**
+ * Create a per-request Neon WebSocket pool + drizzle client.
+ *
+ * Timeout defaults (overridable via `timeouts`, or per-field via `pool`):
+ * `statement_timeout: 10_000`, `query_timeout: 15_000`,
+ * `connectionTimeoutMillis: 10_000`. Both `statement_timeout` (server-side)
+ * and `query_timeout` (client-side) are set because transaction-mode poolers
+ * (PgBouncer) may ignore `statement_timeout` as a startup parameter — see
+ * {@link resolveServerlessPoolConfig}.
+ *
+ * Warns (once per connection string) when pointed at a Neon direct endpoint
+ * instead of the `-pooler` host.
+ */
+export function createServerlessDbClient(connectionString, options) {
+    warnIfDirectNeonEndpoint(connectionString);
+    const pool = new Pool(resolveServerlessPoolConfig(connectionString, options));
+    const dispose = () => pool.end().catch(() => { });
+    const db = tagTransactionCapability(options?.schema
+        ? drizzleNeonServerless(pool, { schema: options.schema })
+        : drizzleNeonServerless(pool), true, dispose);
+    return {
+        db,
+        dispose,
+    };
+}
+/**
+ * Run `fn` with a scoped transaction-capable client (Neon WebSocket
+ * Pool), disposing it on settle. For code paths that need
+ * `db.transaction(...)` but run outside the request middleware that
+ * normally provides the transactional client — event handlers, workflow
+ * steps, scheduled jobs, scripts.
+ *
+ *     const result = await withServerlessDb(env.DATABASE_URL, (db) =>
+ *       db.transaction(async (tx) => { ... }),
+ *     )
+ */
+export async function withServerlessDb(connectionString, fn, options) {
+    const { db, dispose } = createServerlessDbClient(connectionString, options);
+    try {
+        return await fn(db);
+    }
+    finally {
+        await dispose();
+    }
+}
+/**
+ * Get the main database instance for the configured `DATABASE_URL`.
+ * (Single-database deployments; region is chosen per deployment.)
+ */
+export function getDb(adapter) {
+    const url = process.env.DATABASE_URL;
+    return createDbClient(url, { adapter });
+}
+// Lazy default database instance
+let _defaultDb = null;
+function getDefaultDbInstance() {
+    if (!_defaultDb) {
+        const defaultAdapter = process.env.DB_ADAPTER || "edge";
+        if (defaultAdapter === "serverless") {
+            throw new Error("The global @voyant-travel/db proxy cannot use DB_ADAPTER=serverless. Use createServerlessDbClient() per request and dispose it after use.");
+        }
+        _defaultDb = getDb(defaultAdapter);
+    }
+    return _defaultDb;
+}
+// Export a default, ready-to-use instance with lazy initialization
+export const db = new Proxy({}, {
+    get(target, prop) {
+        void target;
+        return getDefaultDbInstance()[prop];
+    },
+});
+// Re-export lib utilities
+export * from "./connection-config.js";
+export * from "./helpers.js";
+export * from "./lib/index.js";
+export * from "./lifecycle.js";
+// Re-export queries
+export * from "./queries/index.js";
+export { withOptionalTransaction } from "./transaction.js";
+export * from "./transaction-capability.js";
+export * from "./types.js";
+export * from "./utils.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/index.d.ts

@@ -0,0 +1,3 @@
+export { anyTypeIdSchema, compareIds, decodeId, getPrefix, getTimestamp, isValidId, newId, newIdFromPrefix, PREFIXES, type PrefixKey, type PrefixValue, typeIdSchema, typeIdSchemaOptional, typeIdSchemas, } from "./typeid.js";
+export { TYPEID_MAX_LENGTH, typeId, typeIdManual, typeIdOptimized, typeIdRef, typeIdRefOptimized, } from "./typeid-column.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,eAAe,EACf,UAAU,EACV,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,SAAS,EACT,KAAK,EACL,eAAe,EACf,QAAQ,EACR,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,YAAY,EACZ,oBAAoB,EACpB,aAAa,GACd,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,iBAAiB,EACjB,MAAM,EACN,YAAY,EACZ,eAAe,EACf,SAAS,EACT,kBAAkB,GACnB,MAAM,oBAAoB,CAAA"}

package/dist/lib/index.js

@@ -0,0 +1,5 @@
+// /packages/db/src/lib/index.ts
+// Re-export all TypeID utilities
+export { anyTypeIdSchema, compareIds, decodeId, getPrefix, getTimestamp, isValidId, newId, newIdFromPrefix, PREFIXES, typeIdSchema, typeIdSchemaOptional, typeIdSchemas, } from "./typeid.js";
+export { TYPEID_MAX_LENGTH, typeId, typeIdManual, typeIdOptimized, typeIdRef, typeIdRefOptimized, } from "./typeid-column.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,iCAAiC;AAEjC,OAAO,EACL,eAAe,EACf,UAAU,EACV,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,SAAS,EACT,KAAK,EACL,eAAe,EACf,QAAQ,EAGR,YAAY,EACZ,oBAAoB,EACpB,aAAa,GACd,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,iBAAiB,EACjB,MAAM,EACN,YAAY,EACZ,eAAe,EACf,SAAS,EACT,kBAAkB,GACnB,MAAM,oBAAoB,CAAA"}

package/dist/lib/typeid-column.d.ts

@@ -0,0 +1,75 @@
+import { type PrefixKey } from "./typeid.js";
+/**
+ * Maximum length of a TypeID string.
+ * Format: prefix (2-4 chars) + "_" + suffix (26 chars) = up to 31 chars
+ * Using 32 for safety margin.
+ */
+export declare const TYPEID_MAX_LENGTH = 32;
+/**
+ * Creates a TypeID primary key column with automatic generation.
+ * Use this for root/parent tables where IDs are generated automatically.
+ *
+ * The column uses `text` type and generates TypeIDs via `$defaultFn`.
+ *
+ * @param prefix - The entity type key from PREFIXES
+ * @param columnName - The database column name (defaults to "id")
+ * @returns A Drizzle column definition
+ *
+ * @example
+ * // In a schema file:
+ * export const productsTable = pgTable("products", {
+ *   id: typeId("products"),
+ *   name: text("name").notNull(),
+ * });
+ */
+export declare function typeId(prefix: PrefixKey, columnName?: string): import("drizzle-orm").HasRuntimeDefault<import("drizzle-orm").HasDefault<import("drizzle-orm").IsPrimaryKey<import("drizzle-orm").NotNull<import("drizzle-orm/pg-core").PgTextBuilderInitial<string, [string, ...string[]]>>>>>;
+/**
+ * Creates a TypeID primary key column WITHOUT automatic generation.
+ * Use this for child/linked tables where the ID must be provided explicitly
+ * to match a parent record (e.g., a 1:1 table whose PK must match the parent PK).
+ *
+ * @param columnName - The database column name (defaults to "id")
+ * @returns A Drizzle column definition without default
+ *
+ * @example
+ * // For 1:1 relationships where ID must match parent:
+ * export const profileTable = pgTable("profiles", {
+ *   id: typeIdManual(), // Must be passed explicitly
+ *   firstName: text("first_name"),
+ * });
+ */
+export declare function typeIdManual(columnName?: string): import("drizzle-orm").IsPrimaryKey<import("drizzle-orm").NotNull<import("drizzle-orm/pg-core").PgTextBuilderInitial<string, [string, ...string[]]>>>;
+/**
+ * Creates a TypeID foreign key column.
+ * Use this for columns that reference another table's TypeID.
+ *
+ * @param columnName - The database column name
+ * @returns A Drizzle column definition for foreign keys
+ *
+ * @example
+ * export const ordersTable = pgTable("orders", {
+ *   id: typeId("orders"),
+ *   productId: typeIdRef("product_id").notNull().references(() => productsTable.id),
+ * });
+ */
+export declare function typeIdRef(columnName: string): import("drizzle-orm/pg-core").PgTextBuilderInitial<string, [string, ...string[]]>;
+/**
+ * Creates an optimized TypeID column using varchar with fixed length.
+ * Use this when you want to optimize storage (varchar vs text).
+ *
+ * Note: Most use cases should prefer `typeId()` with text for simplicity.
+ * Only use this for high-volume tables where storage optimization matters.
+ *
+ * @param prefix - The entity type key from PREFIXES
+ * @param columnName - The database column name (defaults to "id")
+ * @returns A Drizzle column definition with varchar type
+ */
+export declare function typeIdOptimized(prefix: PrefixKey, columnName?: string): import("drizzle-orm").HasRuntimeDefault<import("drizzle-orm").HasDefault<import("drizzle-orm").IsPrimaryKey<import("drizzle-orm").NotNull<import("drizzle-orm/pg-core").PgVarcharBuilderInitial<string, [string, ...string[]], 32>>>>>;
+/**
+ * Creates an optimized TypeID foreign key column using varchar.
+ *
+ * @param columnName - The database column name
+ * @returns A Drizzle column definition for foreign keys with varchar type
+ */
+export declare function typeIdRefOptimized(columnName: string): import("drizzle-orm/pg-core").PgVarcharBuilderInitial<string, [string, ...string[]], 32>;
+//# sourceMappingURL=typeid-column.d.ts.map

package/dist/lib/typeid-column.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeid-column.d.ts","sourceRoot":"","sources":["../../src/lib/typeid-column.ts"],"names":[],"mappings":"AAKA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,aAAa,CAAA;AAEnD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAEnC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,SAAO,mOAI1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,UAAU,SAAO,wJAE7C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,qFAE3C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,SAAO,0OAInE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,4FAEpD"}

package/dist/lib/typeid-column.js

@@ -0,0 +1,92 @@
+// /packages/db/src/lib/typeid-column.ts
+// Drizzle column helpers for TypeID primary keys and foreign keys
+import { text, varchar } from "drizzle-orm/pg-core";
+import { newId } from "./typeid.js";
+/**
+ * Maximum length of a TypeID string.
+ * Format: prefix (2-4 chars) + "_" + suffix (26 chars) = up to 31 chars
+ * Using 32 for safety margin.
+ */
+export const TYPEID_MAX_LENGTH = 32;
+/**
+ * Creates a TypeID primary key column with automatic generation.
+ * Use this for root/parent tables where IDs are generated automatically.
+ *
+ * The column uses `text` type and generates TypeIDs via `$defaultFn`.
+ *
+ * @param prefix - The entity type key from PREFIXES
+ * @param columnName - The database column name (defaults to "id")
+ * @returns A Drizzle column definition
+ *
+ * @example
+ * // In a schema file:
+ * export const productsTable = pgTable("products", {
+ *   id: typeId("products"),
+ *   name: text("name").notNull(),
+ * });
+ */
+export function typeId(prefix, columnName = "id") {
+    return text(columnName)
+        .primaryKey()
+        .$defaultFn(() => newId(prefix));
+}
+/**
+ * Creates a TypeID primary key column WITHOUT automatic generation.
+ * Use this for child/linked tables where the ID must be provided explicitly
+ * to match a parent record (e.g., a 1:1 table whose PK must match the parent PK).
+ *
+ * @param columnName - The database column name (defaults to "id")
+ * @returns A Drizzle column definition without default
+ *
+ * @example
+ * // For 1:1 relationships where ID must match parent:
+ * export const profileTable = pgTable("profiles", {
+ *   id: typeIdManual(), // Must be passed explicitly
+ *   firstName: text("first_name"),
+ * });
+ */
+export function typeIdManual(columnName = "id") {
+    return text(columnName).primaryKey();
+}
+/**
+ * Creates a TypeID foreign key column.
+ * Use this for columns that reference another table's TypeID.
+ *
+ * @param columnName - The database column name
+ * @returns A Drizzle column definition for foreign keys
+ *
+ * @example
+ * export const ordersTable = pgTable("orders", {
+ *   id: typeId("orders"),
+ *   productId: typeIdRef("product_id").notNull().references(() => productsTable.id),
+ * });
+ */
+export function typeIdRef(columnName) {
+    return text(columnName);
+}
+/**
+ * Creates an optimized TypeID column using varchar with fixed length.
+ * Use this when you want to optimize storage (varchar vs text).
+ *
+ * Note: Most use cases should prefer `typeId()` with text for simplicity.
+ * Only use this for high-volume tables where storage optimization matters.
+ *
+ * @param prefix - The entity type key from PREFIXES
+ * @param columnName - The database column name (defaults to "id")
+ * @returns A Drizzle column definition with varchar type
+ */
+export function typeIdOptimized(prefix, columnName = "id") {
+    return varchar(columnName, { length: TYPEID_MAX_LENGTH })
+        .primaryKey()
+        .$defaultFn(() => newId(prefix));
+}
+/**
+ * Creates an optimized TypeID foreign key column using varchar.
+ *
+ * @param columnName - The database column name
+ * @returns A Drizzle column definition for foreign keys with varchar type
+ */
+export function typeIdRefOptimized(columnName) {
+    return varchar(columnName, { length: TYPEID_MAX_LENGTH });
+}
+//# sourceMappingURL=typeid-column.js.map

package/dist/lib/typeid-column.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeid-column.js","sourceRoot":"","sources":["../../src/lib/typeid-column.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,kEAAkE;AAElE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAEnD,OAAO,EAAE,KAAK,EAAkB,MAAM,aAAa,CAAA;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAA;AAEnC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,MAAM,CAAC,MAAiB,EAAE,UAAU,GAAG,IAAI;IACzD,OAAO,IAAI,CAAC,UAAU,CAAC;SACpB,UAAU,EAAE;SACZ,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;AACpC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,UAAU,GAAG,IAAI;IAC5C,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,UAAU,EAAE,CAAA;AACtC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS,CAAC,UAAkB;IAC1C,OAAO,IAAI,CAAC,UAAU,CAAC,CAAA;AACzB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,MAAiB,EAAE,UAAU,GAAG,IAAI;IAClE,OAAO,OAAO,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;SACtD,UAAU,EAAE;SACZ,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,OAAO,OAAO,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAA;AAC3D,CAAC"}

package/dist/lib/typeid-core.d.ts

@@ -0,0 +1,36 @@
+import { TypeID } from "typeid-js";
+import { type PrefixKey, type PrefixValue } from "./typeid-prefixes.js";
+/**
+ * Register a custom TypeID prefix for extension tables.
+ */
+export declare function registerPrefix(tableName: string, prefix: string): void;
+/**
+ * Generates a new TypeID with the correct prefix.
+ */
+export declare function newId(prefix: PrefixKey): string;
+/**
+ * Generates a new TypeID using a raw prefix string.
+ */
+export declare function newIdFromPrefix(prefix: string): string;
+/**
+ * Decodes a TypeID string to extract its components.
+ */
+export declare function decodeId<T extends string>(id: string, expectedPrefix: T): TypeID<T>;
+export declare function decodeId(id: string): TypeID<string>;
+/**
+ * Validates that a string is a valid TypeID with the expected prefix.
+ */
+export declare function isValidId(id: string, expectedPrefix: PrefixKey | PrefixValue): boolean;
+/**
+ * Extracts the prefix from a TypeID string.
+ */
+export declare function getPrefix(id: string): string;
+/**
+ * Extracts the timestamp from a TypeID.
+ */
+export declare function getTimestamp(id: string): Date;
+/**
+ * Compares two TypeIDs chronologically.
+ */
+export declare function compareIds(a: string, b: string): number;
+//# sourceMappingURL=typeid-core.d.ts.map

package/dist/lib/typeid-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeid-core.d.ts","sourceRoot":"","sources":["../../src/lib/typeid-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAU,MAAM,WAAW,CAAA;AAE1C,OAAO,EAAY,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEjF;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAUtE;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;AACpF,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;AAYpD;;GAEG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,CAStF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAI7C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/lib/typeid-core.js

@@ -0,0 +1,67 @@
+import { TypeID, typeid } from "typeid-js";
+import { PREFIXES } from "./typeid-prefixes.js";
+/**
+ * Register a custom TypeID prefix for extension tables.
+ */
+export function registerPrefix(tableName, prefix) {
+    if (PREFIXES[tableName]) {
+        throw new Error(`Prefix already registered for table "${tableName}"`);
+    }
+    if (Object.values(PREFIXES).includes(prefix)) {
+        throw new Error(`Prefix "${prefix}" is already in use`);
+    }
+    ;
+    PREFIXES[tableName] = prefix;
+}
+/**
+ * Generates a new TypeID with the correct prefix.
+ */
+export function newId(prefix) {
+    return typeid(PREFIXES[prefix]).toString();
+}
+/**
+ * Generates a new TypeID using a raw prefix string.
+ */
+export function newIdFromPrefix(prefix) {
+    return typeid(prefix).toString();
+}
+export function decodeId(id, expectedPrefix) {
+    if (expectedPrefix) {
+        return TypeID.fromString(id, expectedPrefix);
+    }
+    return TypeID.fromString(id);
+}
+/**
+ * Validates that a string is a valid TypeID with the expected prefix.
+ */
+export function isValidId(id, expectedPrefix) {
+    try {
+        const decoded = decodeId(id);
+        const prefix = expectedPrefix in PREFIXES ? PREFIXES[expectedPrefix] : expectedPrefix;
+        return decoded.getType() === prefix;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Extracts the prefix from a TypeID string.
+ */
+export function getPrefix(id) {
+    return decodeId(id).getType();
+}
+/**
+ * Extracts the timestamp from a TypeID.
+ */
+export function getTimestamp(id) {
+    const uuid = decodeId(id).toUUID();
+    const hex = uuid.replace(/-/g, "").slice(0, 12);
+    return new Date(parseInt(hex, 16));
+}
+/**
+ * Compares two TypeIDs chronologically.
+ */
+export function compareIds(a, b) {
+    return a.localeCompare(b);
+}
+//# sourceMappingURL=typeid-core.js.map

package/dist/lib/typeid-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeid-core.js","sourceRoot":"","sources":["../../src/lib/typeid-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAE1C,OAAO,EAAE,QAAQ,EAAoC,MAAM,sBAAsB,CAAA;AAEjF;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,MAAc;IAC9D,IAAK,QAAmC,CAAC,SAAS,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,wCAAwC,SAAS,GAAG,CAAC,CAAA;IACvE,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAqB,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,qBAAqB,CAAC,CAAA;IACzD,CAAC;IAED,CAAC;IAAC,QAAmC,CAAC,SAAS,CAAC,GAAG,MAAM,CAAA;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,MAAiB;IACrC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAA;AAClC,CAAC;AAOD,MAAM,UAAU,QAAQ,CACtB,EAAU,EACV,cAAkB;IAElB,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,cAAc,CAAC,CAAA;IAC9C,CAAC;IAED,OAAO,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,EAAU,EAAE,cAAuC;IAC3E,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAA;QAC5B,MAAM,MAAM,GACV,cAAc,IAAI,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,cAA2B,CAAC,CAAC,CAAC,CAAC,cAAc,CAAA;QACrF,OAAO,OAAO,CAAC,OAAO,EAAE,KAAK,MAAM,CAAA;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAA;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAA;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAC/C,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAA;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,CAAS;IAC7C,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;AAC3B,CAAC"}