@stonyx/orm 0.2.1-beta.91 → 0.2.1-beta.92

package/dist/postgres/migration-generator.js

@@ -1,4 +1,5 @@
 import { introspectModels, introspectViews, buildTableDDL, buildViewDDL, buildVectorIndexDDL, schemasToSnapshot, viewSchemasToSnapshot, getTopologicalOrder } from './schema-introspector.js';
+import { buildCreateHypertable, buildEnableCompression, buildCompressionPolicy } from '../timescale/query-builder.js';
 import { readFile, createFile, createDirectory, fileExists } from '@stonyx/utils/file';
 import path from 'path';
 import config from 'stonyx/config';
@@ -41,6 +42,24 @@ export async function generateMigration(description = 'migration', configKey = '
         }
         downStatements.unshift(`DROP TABLE IF EXISTS "${schemas[name].table}" CASCADE;`);
     }
+    // Hypertable conversion + compression (TimescaleDB only)
+    if (configKey === 'timescale') {
+        for (const name of addedOrdered) {
+            const schema = schemas[name];
+            if (!schema.hypertable)
+                continue;
+            const { timeColumn, chunkInterval } = schema.hypertable;
+            upStatements.push(buildCreateHypertable(schema.table, timeColumn, { chunkInterval }).sql + ';');
+            if (schema.hypertable.compress) {
+                const { segmentBy, orderBy, after } = schema.hypertable.compress;
+                upStatements.push(buildEnableCompression(schema.table, segmentBy, orderBy).sql + ';');
+                if (after) {
+                    upStatements.push(buildCompressionPolicy(schema.table, after).sql + ';');
+                }
+            }
+            downStatements.unshift('-- Hypertable conversion is not reversible; table drop handles cleanup');
+        }
+    }
     // Removed tables (warn only, commented out)
     for (const name of diff.removedModels) {
         upStatements.push(`-- WARNING: Model '${name}' was removed. Uncomment to drop table:`);

package/dist/postgres/schema-introspector.d.ts

@@ -1,4 +1,4 @@
-import type { ForeignKeyDef, ModelSchema, ViewSchema } from '../types/orm-types.js';
+import type { ForeignKeyDef, HypertableConfig, ModelSchema, ViewSchema } from '../types/orm-types.js';
 interface ViewSnapshotEntry {
     viewName: string;
     source: string;
@@ -14,6 +14,7 @@ interface ModelSnapshotEntry {
     columns: Record<string, string>;
     foreignKeys: Record<string, ForeignKeyDef>;
     vectorColumns?: Record<string, number>;
+    hypertable?: HypertableConfig;
 }
 export declare function introspectModels(): Record<string, ModelSchema>;
 export declare function buildTableDDL(name: string, schema: ModelSchema, allSchemas?: Record<string, ModelSchema>): string;

package/dist/postgres/schema-introspector.js

@@ -55,6 +55,7 @@ export function introspectModels() {
                 column: 'id',
             };
         }
+        const hypertable = modelClass.hypertable;
         schemas[name] = {
             table: sanitizeTableName(getPluralName(name)),
             idType,
@@ -62,19 +63,24 @@ export function introspectModels() {
             foreignKeys,
             relationships,
             vectorColumns,
+            hypertable: hypertable || undefined,
             memory: modelClass.memory === true,
         };
     }
     return schemas;
 }
 export function buildTableDDL(name, schema, allSchemas = {}) {
-    const { idType, columns, foreignKeys } = schema;
+    const { idType, columns, foreignKeys, hypertable } = schema;
     const table = sanitizeTableName(schema.table);
     const lines = [];
+    const useCompositePK = hypertable && idType !== 'string';
     // Primary key
     if (idType === 'string') {
         lines.push('  "id" VARCHAR(255) PRIMARY KEY');
     }
+    else if (useCompositePK) {
+        lines.push('  "id" INTEGER GENERATED ALWAYS AS IDENTITY');
+    }
     else {
         lines.push('  "id" INTEGER GENERATED ALWAYS AS IDENTITY PRIMARY KEY');
     }
@@ -88,13 +94,22 @@ export function buildTableDDL(name, schema, allSchemas = {}) {
         lines.push(`  "${fkCol}" ${refIdType}`);
     }
     // Timestamps
-    lines.push('  "created_at" TIMESTAMPTZ DEFAULT NOW()');
+    if (useCompositePK) {
+        lines.push('  "created_at" TIMESTAMPTZ NOT NULL DEFAULT NOW()');
+    }
+    else {
+        lines.push('  "created_at" TIMESTAMPTZ DEFAULT NOW()');
+    }
     lines.push('  "updated_at" TIMESTAMPTZ DEFAULT NOW()');
     // Foreign key constraints
     for (const [fkCol, fkDef] of Object.entries(foreignKeys)) {
         const refTable = sanitizeTableName(fkDef.references);
         lines.push(`  FOREIGN KEY ("${fkCol}") REFERENCES "${refTable}"("${fkDef.column}") ON DELETE SET NULL`);
     }
+    // Composite primary key for hypertable models
+    if (useCompositePK) {
+        lines.push(`  PRIMARY KEY ("id", "${hypertable.timeColumn}")`);
+    }
     return `CREATE TABLE IF NOT EXISTS "${table}" (\n${lines.join(',\n')}\n)`;
 }
 /**
@@ -274,6 +289,7 @@ export function schemasToSnapshot(schemas) {
             ...(schema.vectorColumns && Object.keys(schema.vectorColumns).length > 0
                 ? { vectorColumns: { ...schema.vectorColumns } }
                 : {}),
+            ...(schema.hypertable ? { hypertable: schema.hypertable } : {}),
         };
     }
     return snapshot;

package/dist/types/orm-types.d.ts

@@ -86,6 +86,15 @@ export interface ForeignKeyDef {
     references: string;
     column: string;
 }
+export interface HypertableConfig {
+    timeColumn: string;
+    chunkInterval?: string;
+    compress?: {
+        segmentBy?: string;
+        orderBy?: string;
+        after?: string;
+    };
+}
 export interface ModelSchema {
     table: string;
     idType: string;
@@ -96,6 +105,7 @@ export interface ModelSchema {
         hasMany: Record<string, string | null>;
     };
     vectorColumns?: Record<string, number>;
+    hypertable?: HypertableConfig;
     memory: boolean;
 }
 export interface ViewSchema {
@@ -135,6 +145,7 @@ export interface SnapshotEntry {
     columns?: Record<string, string>;
     foreignKeys?: Record<string, ForeignKeyDef>;
     vectorColumns?: Record<string, number>;
+    hypertable?: HypertableConfig;
     isView?: boolean;
     viewName?: string;
     source?: string;

package/package.json

@@ -4,7 +4,7 @@
     "stonyx-async",
     "stonyx-module"
   ],
-  "version": "0.2.1-beta.91",
+  "version": "0.2.1-beta.92",
   "description": "",
   "main": "dist/index.js",
   "type": "module",

package/src/postgres/migration-generator.ts

@@ -1,4 +1,5 @@
 import { introspectModels, introspectViews, buildTableDDL, buildViewDDL, buildVectorIndexDDL, schemasToSnapshot, viewSchemasToSnapshot, getTopologicalOrder } from './schema-introspector.js';
+import { buildCreateHypertable, buildEnableCompression, buildCompressionPolicy } from '../timescale/query-builder.js';
 import { readFile, createFile, createDirectory, fileExists } from '@stonyx/utils/file';
 import path from 'path';
 import config from 'stonyx/config';
@@ -97,6 +98,27 @@ export async function generateMigration(description: string = 'migration', confi
     downStatements.unshift(`DROP TABLE IF EXISTS "${schemas[name].table}" CASCADE;`);
   }
 
+  // Hypertable conversion + compression (TimescaleDB only)
+  if (configKey === 'timescale') {
+    for (const name of addedOrdered) {
+      const schema = schemas[name];
+      if (!schema.hypertable) continue;
+
+      const { timeColumn, chunkInterval } = schema.hypertable;
+      upStatements.push(buildCreateHypertable(schema.table, timeColumn, { chunkInterval }).sql + ';');
+
+      if (schema.hypertable.compress) {
+        const { segmentBy, orderBy, after } = schema.hypertable.compress;
+        upStatements.push(buildEnableCompression(schema.table, segmentBy, orderBy).sql + ';');
+        if (after) {
+          upStatements.push(buildCompressionPolicy(schema.table, after).sql + ';');
+        }
+      }
+
+      downStatements.unshift('-- Hypertable conversion is not reversible; table drop handles cleanup');
+    }
+  }
+
   // Removed tables (warn only, commented out)
   for (const name of diff.removedModels) {
     upStatements.push(`-- WARNING: Model '${name}' was removed. Uncomment to drop table:`);

package/src/postgres/schema-introspector.ts

@@ -5,7 +5,7 @@ import { getPluralName } from '../plural-registry.js';
 import { dbKey } from '../db.js';
 import { AggregateProperty } from '../aggregates.js';
 import { getRelationshipInfo, sanitizeTableName } from '../schema-helpers.js';
-import type { ForeignKeyDef, ModelSchema, ViewSchema } from '../types/orm-types.js';
+import type { ForeignKeyDef, HypertableConfig, ModelSchema, ViewSchema } from '../types/orm-types.js';
 import ModelProperty from '../model-property.js';
 
 interface ViewSnapshotEntry {
@@ -24,6 +24,7 @@ interface ModelSnapshotEntry {
   columns: Record<string, string>;
   foreignKeys: Record<string, ForeignKeyDef>;
   vectorColumns?: Record<string, number>;
+  hypertable?: HypertableConfig;
 }
 
 interface JoinDef {
@@ -82,6 +83,8 @@ export function introspectModels(): Record<string, ModelSchema> {
       };
     }
 
+    const hypertable = (modelClass as { hypertable?: HypertableConfig }).hypertable;
+
     schemas[name] = {
       table: sanitizeTableName(getPluralName(name)),
       idType,
@@ -89,6 +92,7 @@ export function introspectModels(): Record<string, ModelSchema> {
       foreignKeys,
       relationships,
       vectorColumns,
+      hypertable: hypertable || undefined,
       memory: (modelClass as { memory?: boolean }).memory === true,
     };
   }
@@ -97,13 +101,16 @@ export function introspectModels(): Record<string, ModelSchema> {
 }
 
 export function buildTableDDL(name: string, schema: ModelSchema, allSchemas: Record<string, ModelSchema> = {}): string {
-  const { idType, columns, foreignKeys } = schema;
+  const { idType, columns, foreignKeys, hypertable } = schema;
   const table = sanitizeTableName(schema.table);
   const lines: string[] = [];
+  const useCompositePK = hypertable && idType !== 'string';
 
   // Primary key
   if (idType === 'string') {
     lines.push('  "id" VARCHAR(255) PRIMARY KEY');
+  } else if (useCompositePK) {
+    lines.push('  "id" INTEGER GENERATED ALWAYS AS IDENTITY');
   } else {
     lines.push('  "id" INTEGER GENERATED ALWAYS AS IDENTITY PRIMARY KEY');
   }
@@ -120,7 +127,11 @@ export function buildTableDDL(name: string, schema: ModelSchema, allSchemas: Rec
   }
 
   // Timestamps
-  lines.push('  "created_at" TIMESTAMPTZ DEFAULT NOW()');
+  if (useCompositePK) {
+    lines.push('  "created_at" TIMESTAMPTZ NOT NULL DEFAULT NOW()');
+  } else {
+    lines.push('  "created_at" TIMESTAMPTZ DEFAULT NOW()');
+  }
   lines.push('  "updated_at" TIMESTAMPTZ DEFAULT NOW()');
 
   // Foreign key constraints
@@ -129,6 +140,11 @@ export function buildTableDDL(name: string, schema: ModelSchema, allSchemas: Rec
     lines.push(`  FOREIGN KEY ("${fkCol}") REFERENCES "${refTable}"("${fkDef.column}") ON DELETE SET NULL`);
   }
 
+  // Composite primary key for hypertable models
+  if (useCompositePK) {
+    lines.push(`  PRIMARY KEY ("id", "${hypertable.timeColumn}")`);
+  }
+
   return `CREATE TABLE IF NOT EXISTS "${table}" (\n${lines.join(',\n')}\n)`;
 }
 
@@ -336,6 +352,7 @@ export function schemasToSnapshot(schemas: Record<string, ModelSchema>): Record<
       ...(schema.vectorColumns && Object.keys(schema.vectorColumns).length > 0
         ? { vectorColumns: { ...schema.vectorColumns } }
         : {}),
+      ...(schema.hypertable ? { hypertable: schema.hypertable } : {}),
     };
   }
 

package/src/types/orm-types.ts

@@ -86,6 +86,16 @@ export interface ForeignKeyDef {
   column: string;
 }
 
+export interface HypertableConfig {
+  timeColumn: string;
+  chunkInterval?: string;
+  compress?: {
+    segmentBy?: string;
+    orderBy?: string;
+    after?: string;
+  };
+}
+
 export interface ModelSchema {
   table: string;
   idType: string;
@@ -96,6 +106,7 @@ export interface ModelSchema {
     hasMany: Record<string, string | null>;
   };
   vectorColumns?: Record<string, number>;
+  hypertable?: HypertableConfig;
   memory: boolean;
 }
 
@@ -139,6 +150,7 @@ export interface SnapshotEntry {
   columns?: Record<string, string>;
   foreignKeys?: Record<string, ForeignKeyDef>;
   vectorColumns?: Record<string, number>;
+  hypertable?: HypertableConfig;
   isView?: boolean;
   viewName?: string;
   source?: string;