dsqlbase 0.1.0 → 0.1.1

package/dist/schema/table.d.ts

@@ -0,0 +1,20 @@
+import { TableDefinition, AnyColumnDefinition, AnyNamespaceDefinition } from "@dsqlbase/core/definition";
+/**
+ * Defines a table schema with specified columns and optional schema association.
+ *
+ * @param name Table name in the database
+ * @param columns An object defining the columns of the table, where keys are field names used at runtime and values are ColumnDefinition instances that specify the column's properties and constraints.
+ * @returns A new instance of TableDefinition representing the defined table schema.
+ *
+ * @example
+ *
+ * ```ts
+ * const users = table("users", {
+ *  id: uuid("id").primaryKey(),
+ *  name: text("name").notNull(),
+ *  email: text("email").unique(),
+ * });
+ * ```
+ */
+export declare function table<TName extends string, TColumns extends Record<string, AnyColumnDefinition>>(name: TName, columns: TColumns): TableDefinition<TName, TColumns, AnyNamespaceDefinition>;
+//# sourceMappingURL=table.d.ts.map

package/dist/schema/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/schema/table.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;;;;;;;GAgBG;AAEH,wBAAgB,KAAK,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAC9F,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,QAAQ,GAChB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,sBAAsB,CAAC,CAE1D"}

package/dist/schema/table.js

@@ -0,0 +1,22 @@
+import { TableDefinition, } from "@dsqlbase/core/definition";
+/**
+ * Defines a table schema with specified columns and optional schema association.
+ *
+ * @param name Table name in the database
+ * @param columns An object defining the columns of the table, where keys are field names used at runtime and values are ColumnDefinition instances that specify the column's properties and constraints.
+ * @returns A new instance of TableDefinition representing the defined table schema.
+ *
+ * @example
+ *
+ * ```ts
+ * const users = table("users", {
+ *  id: uuid("id").primaryKey(),
+ *  name: text("name").notNull(),
+ *  email: text("email").unique(),
+ * });
+ * ```
+ */
+export function table(name, columns) {
+    return new TableDefinition(name, { columns });
+}
+//# sourceMappingURL=table.js.map

package/dist/schema/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../src/schema/table.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,GAGhB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,UAAU,KAAK,CACnB,IAAW,EACX,OAAiB;IAEjB,OAAO,IAAI,eAAe,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/schema/utils/date.d.ts

@@ -0,0 +1,33 @@
+export type DateTimeMode = "iso" | "string" | "date";
+export declare const safeParseDate: (value: unknown) => Date;
+export declare const utcDate: (date: Date) => Date;
+/**
+ * Formats a `Date` for a Postgres `timestamp` / `timestamp with time zone` literal.
+ *
+ * - `tz: true`  → ISO 8601 in UTC (e.g. `"2026-04-30T09:00:00.000Z"`). Postgres normalises
+ *   to an absolute instant on insert; downstream reads are session-zone agnostic.
+ * - `tz: false` → space-separated **local wall clock** (e.g. `"2026-04-30 12:00:00.000"`).
+ *   The literal value the caller wrote is the literal value Postgres stores. There is
+ *   no zone metadata, so `getTime()` parity across machines is not preserved — that is
+ *   the contract of `timestamp without time zone`.
+ */
+export declare const formatTimestamp: (date: Date, opts: {
+    tz: boolean;
+}) => string;
+/**
+ * Formats a `Date` as a Postgres `date` literal `YYYY-MM-DD` using the **local**
+ * components of the input — Postgres `date` has no timezone concept, so we preserve
+ * the wall-clock day the caller authored.
+ */
+export declare const formatDate: (date: Date) => string;
+/**
+ * Formats a `Date`'s time-of-day for a Postgres `time` / `time with time zone` literal.
+ *
+ * - `tz: true`  → UTC components with a trailing `Z` (e.g. `"09:00:00.000Z"`), mirroring
+ *   the absolute-instant convention used for `timestamp with time zone`.
+ * - `tz: false` → local clock components (e.g. `"12:00:00.000"`), wall-clock semantics.
+ */
+export declare const formatTime: (date: Date, opts: {
+    tz: boolean;
+}) => string;
+//# sourceMappingURL=date.d.ts.map

package/dist/schema/utils/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../src/schema/utils/date.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErD,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,SAoB3C,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,MAAM,IAAI,SAEjC,CAAC;AAIF;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,IAAI,EAAE,MAAM;IAAE,EAAE,EAAE,OAAO,CAAA;CAAE,WAUhE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,IAAI,WAEpC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,IAAI,EAAE,MAAM;IAAE,EAAE,EAAE,OAAO,CAAA;CAAE,WAY3D,CAAC"}

package/dist/schema/utils/date.js

@@ -0,0 +1,62 @@
+export const safeParseDate = (value) => {
+    if (typeof value === "string") {
+        const parsed = Date.parse(value);
+        if (isNaN(parsed)) {
+            throw new Error(`Invalid date string: ${value}`);
+        }
+        return new Date(parsed);
+    }
+    if (value instanceof Date) {
+        if (isNaN(value.getTime())) {
+            throw new Error(`Invalid Date object: ${value}`);
+        }
+        return value;
+    }
+    throw new Error(`Unsupported date value: ${value}`);
+};
+export const utcDate = (date) => {
+    return new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+};
+const pad = (n, width = 2) => String(n).padStart(width, "0");
+/**
+ * Formats a `Date` for a Postgres `timestamp` / `timestamp with time zone` literal.
+ *
+ * - `tz: true`  → ISO 8601 in UTC (e.g. `"2026-04-30T09:00:00.000Z"`). Postgres normalises
+ *   to an absolute instant on insert; downstream reads are session-zone agnostic.
+ * - `tz: false` → space-separated **local wall clock** (e.g. `"2026-04-30 12:00:00.000"`).
+ *   The literal value the caller wrote is the literal value Postgres stores. There is
+ *   no zone metadata, so `getTime()` parity across machines is not preserved — that is
+ *   the contract of `timestamp without time zone`.
+ */
+export const formatTimestamp = (date, opts) => {
+    if (opts.tz) {
+        return date.toISOString();
+    }
+    return (`${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}` +
+        ` ${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}` +
+        `.${pad(date.getMilliseconds(), 3)}`);
+};
+/**
+ * Formats a `Date` as a Postgres `date` literal `YYYY-MM-DD` using the **local**
+ * components of the input — Postgres `date` has no timezone concept, so we preserve
+ * the wall-clock day the caller authored.
+ */
+export const formatDate = (date) => {
+    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+};
+/**
+ * Formats a `Date`'s time-of-day for a Postgres `time` / `time with time zone` literal.
+ *
+ * - `tz: true`  → UTC components with a trailing `Z` (e.g. `"09:00:00.000Z"`), mirroring
+ *   the absolute-instant convention used for `timestamp with time zone`.
+ * - `tz: false` → local clock components (e.g. `"12:00:00.000"`), wall-clock semantics.
+ */
+export const formatTime = (date, opts) => {
+    if (opts.tz) {
+        return (`${pad(date.getUTCHours())}:${pad(date.getUTCMinutes())}:${pad(date.getUTCSeconds())}` +
+            `.${pad(date.getUTCMilliseconds(), 3)}Z`);
+    }
+    return (`${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}` +
+        `.${pad(date.getMilliseconds(), 3)}`);
+};
+//# sourceMappingURL=date.js.map

package/dist/schema/utils/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../../src/schema/utils/date.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,EAAE;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAEjC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;AACtD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAU,EAAE,EAAE;IACpC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AACjF,CAAC,CAAC;AAEF,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAErE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAU,EAAE,IAAqB,EAAE,EAAE;IACnE,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;IAED,OAAO,CACL,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE;QAC1E,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE;QAC9E,IAAI,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,EAAE,CACrC,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAU,EAAE,EAAE;IACvC,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;AACpF,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAU,EAAE,IAAqB,EAAE,EAAE;IAC9D,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;QACZ,OAAO,CACL,GAAG,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,EAAE;YACtF,IAAI,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,GAAG,CACzC,CAAC;IACJ,CAAC;IAED,OAAO,CACL,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE;QAC7E,IAAI,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,EAAE,CACrC,CAAC;AACJ,CAAC,CAAC"}

package/dist/schema/utils/duration.d.ts

@@ -0,0 +1,66 @@
+export interface Duration {
+    years: number;
+    months: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}
+export declare const ISO_DURATION_REGEX: RegExp;
+export declare const STRING_DURATION_REGEX: RegExp;
+/**
+ * Formats a Duration object into an ISO 8601 duration string.
+ *
+ * @param duration Duration object
+ * @returns ISO 8601 duration string like "P3Y6M4DT12H30M5S"
+ */
+export declare const formatISODuration: (duration: Partial<Duration>) => string;
+/**
+ * Parses an ISO 8601 duration string into a Duration object. Supported formats include:
+ * - "P3Y6M4DT12H30M5S" (3 years, 6 months, 4 days, 12 hours, 30 minutes, and 5 seconds)
+ * - "P2Y" (2 years)
+ * - "PT15M" (15 minutes)
+ * - "P1DT12H" (1 day and 12 hours)
+ * - "PT0.5S" (0.5 seconds)
+ * @param isoString
+ * @returns Duration object
+ */
+export declare const parseISODuration: (iso: string) => Duration;
+/**
+ * Formats a Duration object into a human-readable string format.
+ *
+ * @param duration Duration object
+ * @returns String fomrat like "3 years 6 months 4 days 12 hours 30 minutes 5 seconds"
+ */
+export declare const formatStringDuration: (duration: Partial<Duration>) => string;
+/**
+ * Parses a human-readable duration string into a Duration object.
+ * Supported formats include:
+ * - "3 years 6 months 4 days 12 hours 30 minutes 5 seconds"
+ * - "2 hours 15 minutes"
+ * - "45 seconds"
+ *
+ * @param str String formatted duration
+ * @returns Duration object
+ */
+export declare const parseStringDuration: (str: string) => Duration;
+export declare const PG_INTERVAL_REGEX: RegExp;
+/**
+ * Parses Postgres' default `intervalstyle = 'postgres'` text format into a Duration object.
+ * Supported shapes include:
+ * - "40:00:00" / "12:30:05.5" (time-only, optional fractional seconds)
+ * - "-12:30:05" (signed time)
+ * - "4 days 12:30:05"
+ * - "3 years 6 mons 4 days 12:30:05" (note: PG uses `mons`, not `months`)
+ * - Per-component negatives: "-3 years -6 mons -4 days -12:30:05"
+ *
+ * Each calendar component carries its own sign; the time portion's leading `-` applies to
+ * hours/minutes/seconds/milliseconds together.
+ *
+ * @param str Postgres-formatted interval string
+ * @returns Duration object
+ */
+export declare const parsePGIntervalDuration: (str: string) => Duration;
+export declare const safeParseDuration: (value: unknown) => Duration;
+//# sourceMappingURL=duration.d.ts.map

package/dist/schema/utils/duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../../src/schema/utils/duration.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,kBAAkB,QAC8I,CAAC;AAE9K,eAAO,MAAM,qBAAqB,QACgI,CAAC;AAEnK;;;;;GAKG;AAEH,eAAO,MAAM,iBAAiB,GAAI,UAAU,OAAO,CAAC,QAAQ,CAAC,WAsB5D,CAAC;AAEF;;;;;;;;;GASG;AAEH,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,KAAG,QAkB9C,CAAC;AAEF;;;;;GAKG;AAEH,eAAO,MAAM,oBAAoB,GAAI,UAAU,OAAO,CAAC,QAAQ,CAAC,WAW/D,CAAC;AAEF;;;;;;;;;GASG;AAEH,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,KAAG,QAiBjD,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAC6K,CAAC;AAE5M;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,uBAAuB,GAAI,KAAK,MAAM,KAAG,QAmBrD,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,QA6BlD,CAAC"}

package/dist/schema/utils/duration.js

@@ -0,0 +1,167 @@
+export const ISO_DURATION_REGEX = /^P(?:(?<years>\d+)Y)?(?:(?<months>\d+)M)?(?:(?<weeks>\d+)W)?(?:(?<days>\d+)D)?(?:T(?:(?<hours>\d+)H)?(?:(?<minutes>\d+)M)?(?:(?<seconds>\d+)(?:\.(?<fraction>\d+))?S)?)?$/;
+export const STRING_DURATION_REGEX = /^(?:(\d+)\s*year[s]?)?\s*(?:(\d+)\s*month[s]?)?\s*(?:(\d+)\s*day[s]?)?\s*(?:(\d+)\s*hour[s]?)?\s*(?:(\d+)\s*minute[s]?)?\s*(?:(\d+(?:\.\d+)?)\s*second[s]?)?$/i;
+/**
+ * Formats a Duration object into an ISO 8601 duration string.
+ *
+ * @param duration Duration object
+ * @returns ISO 8601 duration string like "P3Y6M4DT12H30M5S"
+ */
+export const formatISODuration = (duration) => {
+    let iso = "P";
+    if (duration.years)
+        iso += `${duration.years}Y`;
+    if (duration.months)
+        iso += `${duration.months}M`;
+    if (duration.days)
+        iso += `${duration.days}D`;
+    if (duration.hours || duration.minutes || duration.seconds) {
+        iso += "T";
+        if (duration.hours)
+            iso += `${duration.hours}H`;
+        if (duration.minutes)
+            iso += `${duration.minutes}M`;
+        if (duration.seconds) {
+            const seconds = duration.milliseconds
+                ? `${duration.seconds}.${duration.milliseconds}`
+                : duration.seconds;
+            iso += `${seconds}S`;
+        }
+    }
+    return iso;
+};
+/**
+ * Parses an ISO 8601 duration string into a Duration object. Supported formats include:
+ * - "P3Y6M4DT12H30M5S" (3 years, 6 months, 4 days, 12 hours, 30 minutes, and 5 seconds)
+ * - "P2Y" (2 years)
+ * - "PT15M" (15 minutes)
+ * - "P1DT12H" (1 day and 12 hours)
+ * - "PT0.5S" (0.5 seconds)
+ * @param isoString
+ * @returns Duration object
+ */
+export const parseISODuration = (iso) => {
+    const match = ISO_DURATION_REGEX.exec(iso);
+    if (!match?.groups) {
+        throw new Error(`Invalid ISO 8601 duration string: ${iso}`);
+    }
+    const { years, months, days, hours, minutes, seconds, fraction } = match.groups;
+    return {
+        years: parseInt(years ?? "0") || 0,
+        months: parseInt(months ?? "0") || 0,
+        days: parseInt(days ?? "0") || 0,
+        hours: parseInt(hours ?? "0") || 0,
+        minutes: parseInt(minutes ?? "0") || 0,
+        seconds: parseInt(seconds ?? "0") || 0,
+        milliseconds: fraction ? Math.round(parseFloat(`0.${fraction}`) * 1000) : 0,
+    };
+};
+/**
+ * Formats a Duration object into a human-readable string format.
+ *
+ * @param duration Duration object
+ * @returns String fomrat like "3 years 6 months 4 days 12 hours 30 minutes 5 seconds"
+ */
+export const formatStringDuration = (duration) => {
+    let str = "";
+    if (duration.years)
+        str += `${duration.years} year${duration.years > 1 ? "s" : ""} `;
+    if (duration.months)
+        str += `${duration.months} month${duration.months > 1 ? "s" : ""} `;
+    if (duration.days)
+        str += `${duration.days} day${duration.days > 1 ? "s" : ""} `;
+    if (duration.hours)
+        str += `${duration.hours} hour${duration.hours > 1 ? "s" : ""} `;
+    if (duration.minutes)
+        str += `${duration.minutes} minute${duration.minutes > 1 ? "s" : ""} `;
+    if (duration.seconds)
+        str += `${duration.seconds} second${duration.seconds > 1 ? "s" : ""} `;
+    return str.trim();
+};
+/**
+ * Parses a human-readable duration string into a Duration object.
+ * Supported formats include:
+ * - "3 years 6 months 4 days 12 hours 30 minutes 5 seconds"
+ * - "2 hours 15 minutes"
+ * - "45 seconds"
+ *
+ * @param str String formatted duration
+ * @returns Duration object
+ */
+export const parseStringDuration = (str) => {
+    const match = STRING_DURATION_REGEX.exec(str);
+    if (!match) {
+        throw new Error(`Invalid duration string: ${str}`);
+    }
+    const [, years, months, days, hours, minutes, seconds] = match;
+    return {
+        years: parseInt(years) || 0,
+        months: parseInt(months) || 0,
+        days: parseInt(days) || 0,
+        hours: parseInt(hours) || 0,
+        minutes: parseInt(minutes) || 0,
+        seconds: parseFloat(seconds) || 0,
+        milliseconds: 0,
+    };
+};
+export const PG_INTERVAL_REGEX = /^(?:(?<years>-?\d+)\s+years?\s*)?(?:(?<months>-?\d+)\s+mon(?:th)?s?\s*)?(?:(?<days>-?\d+)\s+days?\s*)?(?:(?<timeSign>-)?(?<hours>\d+):(?<minutes>\d{1,2}):(?<seconds>\d{1,2})(?:\.(?<fraction>\d+))?)?$/;
+/**
+ * Parses Postgres' default `intervalstyle = 'postgres'` text format into a Duration object.
+ * Supported shapes include:
+ * - "40:00:00" / "12:30:05.5" (time-only, optional fractional seconds)
+ * - "-12:30:05" (signed time)
+ * - "4 days 12:30:05"
+ * - "3 years 6 mons 4 days 12:30:05" (note: PG uses `mons`, not `months`)
+ * - Per-component negatives: "-3 years -6 mons -4 days -12:30:05"
+ *
+ * Each calendar component carries its own sign; the time portion's leading `-` applies to
+ * hours/minutes/seconds/milliseconds together.
+ *
+ * @param str Postgres-formatted interval string
+ * @returns Duration object
+ */
+export const parsePGIntervalDuration = (str) => {
+    const match = PG_INTERVAL_REGEX.exec(str.trim());
+    if (!match?.groups) {
+        throw new Error(`Invalid Postgres interval string: ${str}`);
+    }
+    const { years, months, days, timeSign, hours, minutes, seconds, fraction } = match.groups;
+    const sign = timeSign === "-" ? -1 : 1;
+    return {
+        years: parseInt(years ?? "0") || 0,
+        months: parseInt(months ?? "0") || 0,
+        days: parseInt(days ?? "0") || 0,
+        hours: hours ? parseInt(hours) * sign : 0,
+        minutes: minutes ? parseInt(minutes) * sign : 0,
+        seconds: seconds ? parseInt(seconds) * sign : 0,
+        milliseconds: fraction ? Math.round(parseFloat(`0.${fraction}`) * 1000) * sign : 0,
+    };
+};
+export const safeParseDuration = (value) => {
+    if (typeof value === "string") {
+        try {
+            return parseISODuration(value);
+        }
+        catch {
+            try {
+                return parsePGIntervalDuration(value);
+            }
+            catch {
+                return parseStringDuration(value);
+            }
+        }
+    }
+    if (typeof value === "object" && value !== null) {
+        const { years, months, days, hours, minutes, seconds, milliseconds } = value;
+        return {
+            years: parseInt(String(years)) || 0,
+            months: parseInt(String(months)) || 0,
+            days: parseInt(String(days)) || 0,
+            hours: parseInt(String(hours)) || 0,
+            minutes: parseInt(String(minutes)) || 0,
+            seconds: parseFloat(String(seconds)) || 0,
+            milliseconds: parseInt(String(milliseconds)) || 0,
+        };
+    }
+    throw new Error(`Unsupported duration value: ${value}`);
+};
+//# sourceMappingURL=duration.js.map

package/dist/schema/utils/duration.js.map

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

package/dist/schema/utils/json.d.ts

@@ -0,0 +1,2 @@
+export declare const safeParseJson: (value: unknown) => any;
+//# sourceMappingURL=json.d.ts.map

package/dist/schema/utils/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/schema/utils/json.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,QAU3C,CAAC"}

package/dist/schema/utils/json.js

@@ -0,0 +1,12 @@
+export const safeParseJson = (value) => {
+    if (typeof value === "string") {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return value;
+        }
+    }
+    return value;
+};
+//# sourceMappingURL=json.js.map

package/dist/schema/utils/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/schema/utils/json.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,EAAE;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsqlbase",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Query client and schema definition for distributed SQL databases",
   "sideEffects": false,
   "type": "module",
@@ -40,9 +40,21 @@
       "default": "./dist/index.js",
       "types": "./dist/index.d.ts"
     },
-    "./*": {
-      "default": "./dist/*.js",
-      "types": "./dist/*.d.ts"
+    "./client": {
+      "default": "./dist/client/index.js",
+      "types": "./dist/client/index.d.ts"
+    },
+    "./pg": {
+      "default": "./dist/pg/index.js",
+      "types": "./dist/pg/index.d.ts"
+    },
+    "./pglite": {
+      "default": "./dist/pglite/index.js",
+      "types": "./dist/pglite/index.d.ts"
+    },
+    "./schema": {
+      "default": "./dist/schema/index.js",
+      "types": "./dist/schema/index.d.ts"
     }
   },
   "scripts": {
@@ -50,8 +62,22 @@
     "lint": "eslint src --ext .ts"
   },
   "dependencies": {
-    "@dsqlbase/core": "^0.1.0",
-    "@dsqlbase/schema": "^0.1.0",
-    "@dsqlbase/client": "^0.1.0"
+    "@dsqlbase/core": "^0.1.1",
+    "@dsqlbase/schema": "^0.1.0"
+  },
+  "peerDependencies": {
+    "@electric-sql/pglite": "^0.4.5",
+    "pg": "^8.20.0"
+  },
+  "peerDependenciesMeta": {
+    "pg": {
+      "optional": true
+    },
+    "@electric-sql/pglite": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/pg": "^8.20.0"
   }
 }

package/dist/schema.d.ts

@@ -1,2 +0,0 @@
-export { array, bigint, bool, boolean, bytea, char, date, datetime, decimal, double, duration, float4, float8, identity, int, int2, int4, int8, interval, json, numeric, real, smallint, text, time, timestamp, uuid, varchar, domain, namespace, sequence, schema, table, relations, belongsTo, hasMany, hasOne, type DateColumnOptions, type DateTimeColumnOptions, type IdentityColumnOptions, type IntervalColumnOptions, type TimeColumnOptions, type DateValueType, type Duration, } from "@dsqlbase/schema/definition";
-//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,EACL,MAAM,EACN,IAAI,EACJ,OAAO,EACP,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,MAAM,EACN,QAAQ,EACR,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,OAAO,EAEP,MAAM,EACN,SAAS,EACT,QAAQ,EACR,MAAM,EACN,KAAK,EAEL,SAAS,EACT,SAAS,EACT,OAAO,EACP,MAAM,EAEN,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,QAAQ,GACd,MAAM,6BAA6B,CAAC"}

package/dist/schema.js

@@ -1,8 +0,0 @@
-export { 
-// Columns
-array, bigint, bool, boolean, bytea, char, date, datetime, decimal, double, duration, float4, float8, identity, int, int2, int4, int8, interval, json, numeric, real, smallint, text, time, timestamp, uuid, varchar, 
-// Objects
-domain, namespace, sequence, schema, table, 
-// Relations
-relations, belongsTo, hasMany, hasOne, } from "@dsqlbase/schema/definition";
-//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO;AACL,UAAU;AACV,KAAK,EACL,MAAM,EACN,IAAI,EACJ,OAAO,EACP,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,MAAM,EACN,QAAQ,EACR,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,OAAO;AACP,UAAU;AACV,MAAM,EACN,SAAS,EACT,QAAQ,EACR,MAAM,EACN,KAAK;AACL,YAAY;AACZ,SAAS,EACT,SAAS,EACT,OAAO,EACP,MAAM,GASP,MAAM,6BAA6B,CAAC"}