@fragno-dev/db 0.1.1 → 0.1.3

package/dist/schema/serialize.js.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.js","names":["supportJson: SQLProvider[]"],"sources":["../../src/schema/serialize.ts"],"sourcesContent":["import type { SQLProvider } from \"../shared/providers\";\nimport type { AnyColumn } from \"./create\";\nimport { FragnoId, FragnoReference } from \"./create\";\n\nexport interface AdditionalColumnMetadata {\n  length?: number;\n  precision?: number;\n  scale?: number;\n}\n\n/**\n * Get the possible column types that the raw DB type can map to.\n */\nexport function dbToSchemaType(\n  dbType: string,\n  provider: SQLProvider,\n  additional: AdditionalColumnMetadata,\n): (AnyColumn[\"type\"] | \"varchar(n)\")[] {\n  dbType = dbType.toLowerCase();\n  if (provider === \"sqlite\") {\n    switch (dbType) {\n      case \"integer\":\n        return [\"bool\", \"date\", \"timestamp\", \"bigint\", \"integer\"];\n      case \"text\":\n        return [\"json\", \"string\", \"bigint\", \"varchar(n)\"];\n      case \"real\":\n      case \"numeric\":\n        return [\"decimal\"];\n      case \"blob\":\n        return [\"bigint\", \"binary\"];\n      default:\n        return [dbType as AnyColumn[\"type\"]];\n    }\n  }\n\n  if (provider === \"postgresql\" || provider === \"cockroachdb\") {\n    switch (dbType) {\n      case \"decimal\":\n      case \"real\":\n      case \"numeric\":\n      case \"double precision\":\n        return [\"decimal\"];\n      case \"timestamp\":\n      case \"timestamptz\":\n        return [\"timestamp\"];\n      case \"varchar\": {\n        const len = additional.length;\n        if (len != null) {\n          return [`varchar(${len})`];\n        }\n        return [\"string\"];\n      }\n      case \"text\":\n        return [\"string\"];\n      case \"boolean\":\n      case \"bool\":\n        return [\"bool\"];\n      case \"bytea\":\n        return [\"binary\"];\n      default:\n        return [dbType as AnyColumn[\"type\"]];\n    }\n  }\n\n  if (provider === \"mysql\") {\n    switch (dbType) {\n      case \"bool\":\n      case \"boolean\":\n        return [\"bool\"];\n      case \"integer\":\n      case \"int\":\n        return [\"integer\"];\n      case \"decimal\":\n      case \"numeric\":\n      case \"float\":\n      case \"double\":\n        return [\"decimal\"];\n      case \"datetime\":\n        return [\"timestamp\"];\n      case \"varchar\": {\n        const len = additional.length;\n        if (len != null) {\n          return [`varchar(${len})`];\n        }\n        return [\"string\"];\n      }\n      case \"text\":\n        return [\"string\"];\n      case \"longblob\":\n      case \"blob\":\n      case \"mediumblob\":\n      case \"tinyblob\":\n        return [\"binary\"];\n      default:\n        return [dbType as AnyColumn[\"type\"]];\n    }\n  }\n\n  if (provider === \"mssql\") {\n    switch (dbType) {\n      case \"int\":\n        return [\"integer\"];\n      case \"decimal\":\n      case \"float\":\n      case \"real\":\n      case \"numeric\":\n        return [\"decimal\"];\n      case \"bit\":\n        return [\"bool\"];\n      case \"datetime\":\n      case \"datetime2\":\n        return [\"timestamp\"];\n      case \"nvarchar\":\n      case \"varchar\": {\n        const len = additional.length;\n        if (len != null) {\n          return [`varchar(${len})`];\n        }\n        return [\"string\", \"json\"];\n      }\n      case \"ntext\":\n      case \"text\":\n      case \"varchar(max)\":\n      case \"nvarchar(max)\":\n        return [\"string\", \"json\"];\n      case \"binary\":\n      case \"varbinary\":\n        return [\"binary\"];\n      default:\n        return [dbType as AnyColumn[\"type\"]];\n    }\n  }\n\n  throw new Error(`unhandled database provider: ${provider}`);\n}\n\n/**\n * Database type literals that can be returned by schemaToDBType\n */\nexport type DBTypeLiteral =\n  // PostgreSQL/CockroachDB types\n  | \"bigserial\"\n  | \"serial\"\n  | \"boolean\"\n  | \"bool\"\n  | \"json\"\n  | \"text\"\n  | \"bytea\"\n  | \"timestamp\"\n  | \"timestamptz\"\n  | \"bigint\"\n  | \"integer\"\n  | \"decimal\"\n  | \"date\"\n  // MySQL types\n  | \"longblob\"\n  | \"datetime\"\n  // SQLite types\n  | \"blob\"\n  | \"real\"\n  // MSSQL types\n  | \"bit\"\n  | \"int\"\n  | \"varbinary(max)\"\n  | \"varchar(max)\"\n  // varchar with length parameter\n  | `varchar(${number})`;\n\nexport function schemaToDBType(\n  column: AnyColumn | Pick<AnyColumn, \"type\">,\n  provider: SQLProvider,\n): DBTypeLiteral {\n  const { type } = column;\n\n  // Handle internal ID columns with auto-increment\n  if (\"role\" in column && column.role === \"internal-id\") {\n    if (provider === \"postgresql\" || provider === \"cockroachdb\") {\n      return \"bigserial\";\n    }\n    if (provider === \"mysql\") {\n      return \"bigint\";\n    }\n    if (provider === \"sqlite\") {\n      return \"integer\"; // SQLite uses INTEGER for auto-increment\n    }\n    if (provider === \"mssql\") {\n      return \"bigint\";\n    }\n  }\n\n  if (provider === \"sqlite\") {\n    switch (type) {\n      case \"integer\":\n      case \"timestamp\":\n      case \"date\":\n      case \"bool\":\n        return \"integer\";\n      case \"binary\":\n      case \"bigint\":\n        return \"blob\";\n      case \"json\":\n      case \"string\":\n        return \"text\";\n      case \"decimal\":\n        return \"real\";\n      default:\n        // sqlite doesn't support varchar\n        if (type.startsWith(\"varchar\")) return \"text\";\n    }\n  }\n\n  if (provider === \"mssql\") {\n    switch (type) {\n      case \"bool\":\n        return \"bit\";\n      case \"timestamp\":\n        return \"datetime\";\n      case \"integer\":\n        return \"int\";\n      case \"string\":\n        return \"varchar(max)\";\n      case \"binary\":\n        return \"varbinary(max)\";\n      // only 2025 preview supports JSON natively\n      case \"json\":\n        return \"varchar(max)\";\n      default:\n        if (type.startsWith(\"varchar\")) return type as `varchar(${number})`;\n        return type;\n    }\n  }\n\n  if (provider === \"postgresql\" || provider === \"cockroachdb\") {\n    switch (type) {\n      case \"bool\":\n        return \"boolean\";\n      case \"json\":\n        return \"json\";\n      case \"string\":\n        return \"text\";\n      case \"binary\":\n        return \"bytea\";\n      default:\n        if (type.startsWith(\"varchar\")) return type as `varchar(${number})`;\n        return type;\n    }\n  }\n\n  if (provider === \"mysql\") {\n    switch (type) {\n      case \"bool\":\n        return \"boolean\";\n      case \"string\":\n        return \"text\";\n      case \"binary\":\n        return \"longblob\";\n      default:\n        if (type.startsWith(\"varchar\")) return type as `varchar(${number})`;\n        return type;\n    }\n  }\n\n  throw new Error(`cannot handle ${provider} ${type}`);\n}\n\nconst supportJson: SQLProvider[] = [\"postgresql\", \"cockroachdb\", \"mysql\"];\n\n/**\n * Parse from driver value\n */\nexport function deserialize(value: unknown, col: AnyColumn, provider: SQLProvider) {\n  if (value === null) return null;\n\n  if (!supportJson.includes(provider) && col.type === \"json\" && typeof value === \"string\") {\n    return JSON.parse(value);\n  }\n\n  if (\n    provider === \"sqlite\" &&\n    (col.type === \"timestamp\" || col.type === \"date\") &&\n    (typeof value === \"number\" || typeof value === \"string\")\n  ) {\n    return new Date(value);\n  }\n\n  if (col.type === \"bool\" && typeof value === \"number\") return value === 1;\n\n  if (col.type === \"bigint\" && value instanceof Buffer) {\n    return value.readBigInt64BE(0);\n  }\n\n  if (col.type === \"bigint\" && typeof value === \"string\") {\n    return BigInt(value);\n  }\n\n  if (col.type === \"binary\" && value instanceof Buffer) {\n    return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);\n  }\n\n  return value;\n}\n\n/**\n * Encode to driver value\n */\nexport function serialize(value: unknown, col: AnyColumn, provider: SQLProvider) {\n  if (value === null) {\n    return null;\n  }\n\n  // Handle FragnoReference objects (for reference columns)\n  if (value instanceof FragnoReference) {\n    return value.internalId;\n  }\n\n  // Handle FragnoId objects\n  if (value instanceof FragnoId) {\n    // For external ID columns, use the external ID\n    if (col.role === \"external-id\") {\n      return value.externalId;\n    }\n    // For internal ID columns, use the internal ID (must be present)\n    if (col.role === \"internal-id\") {\n      if (!value.internalId) {\n        throw new Error(`FragnoId must have internalId for internal-id column ${col.name}`);\n      }\n      return value.internalId;\n    }\n    // For reference columns, prefer internal ID if available\n    if (col.role === \"reference\") {\n      return value.databaseId;\n    }\n    // Default to external ID for other columns\n    return value.externalId;\n  }\n\n  if (!supportJson.includes(provider) && col.type === \"json\") {\n    return JSON.stringify(value);\n  }\n\n  if (provider === \"sqlite\" && value instanceof Date) {\n    return value.getTime();\n  }\n\n  if (provider === \"sqlite\" && typeof value === \"boolean\") return value ? 1 : 0;\n\n  if (provider === \"sqlite\" && typeof value === \"bigint\") {\n    const buf = Buffer.alloc(8);\n    buf.writeBigInt64BE(value);\n    return buf;\n  }\n\n  // most drivers accept Buffer\n  if (col.type === \"binary\" && value instanceof Uint8Array) {\n    return Buffer.from(value);\n  }\n\n  return value;\n}\n"],"mappings":";;;AAwKA,SAAgB,eACd,QACA,UACe;CACf,MAAM,EAAE,SAAS;AAGjB,KAAI,UAAU,UAAU,OAAO,SAAS,eAAe;AACrD,MAAI,aAAa,gBAAgB,aAAa,cAC5C,QAAO;AAET,MAAI,aAAa,QACf,QAAO;AAET,MAAI,aAAa,SACf,QAAO;AAET,MAAI,aAAa,QACf,QAAO;;AAIX,KAAI,aAAa,SACf,SAAQ,MAAR;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,OACH,QAAO;EACT,KAAK;EACL,KAAK,SACH,QAAO;EACT,KAAK;EACL,KAAK,SACH,QAAO;EACT,KAAK,UACH,QAAO;EACT,QAEE,KAAI,KAAK,WAAW,UAAU,CAAE,QAAO;;AAI7C,KAAI,aAAa,QACf,SAAQ,MAAR;EACE,KAAK,OACH,QAAO;EACT,KAAK,YACH,QAAO;EACT,KAAK,UACH,QAAO;EACT,KAAK,SACH,QAAO;EACT,KAAK,SACH,QAAO;EAET,KAAK,OACH,QAAO;EACT;AACE,OAAI,KAAK,WAAW,UAAU,CAAE,QAAO;AACvC,UAAO;;AAIb,KAAI,aAAa,gBAAgB,aAAa,cAC5C,SAAQ,MAAR;EACE,KAAK,OACH,QAAO;EACT,KAAK,OACH,QAAO;EACT,KAAK,SACH,QAAO;EACT,KAAK,SACH,QAAO;EACT;AACE,OAAI,KAAK,WAAW,UAAU,CAAE,QAAO;AACvC,UAAO;;AAIb,KAAI,aAAa,QACf,SAAQ,MAAR;EACE,KAAK,OACH,QAAO;EACT,KAAK,SACH,QAAO;EACT,KAAK,SACH,QAAO;EACT;AACE,OAAI,KAAK,WAAW,UAAU,CAAE,QAAO;AACvC,UAAO;;AAIb,OAAM,IAAI,MAAM,iBAAiB,SAAS,GAAG,OAAO;;AAGtD,MAAMA,cAA6B;CAAC;CAAc;CAAe;CAAQ;;;;AAKzE,SAAgB,YAAY,OAAgB,KAAgB,UAAuB;AACjF,KAAI,UAAU,KAAM,QAAO;AAE3B,KAAI,CAAC,YAAY,SAAS,SAAS,IAAI,IAAI,SAAS,UAAU,OAAO,UAAU,SAC7E,QAAO,KAAK,MAAM,MAAM;AAG1B,KACE,aAAa,aACZ,IAAI,SAAS,eAAe,IAAI,SAAS,YACzC,OAAO,UAAU,YAAY,OAAO,UAAU,UAE/C,QAAO,IAAI,KAAK,MAAM;AAGxB,KAAI,IAAI,SAAS,UAAU,OAAO,UAAU,SAAU,QAAO,UAAU;AAEvE,KAAI,IAAI,SAAS,YAAY,iBAAiB,OAC5C,QAAO,MAAM,eAAe,EAAE;AAGhC,KAAI,IAAI,SAAS,YAAY,OAAO,UAAU,SAC5C,QAAO,OAAO,MAAM;AAGtB,KAAI,IAAI,SAAS,YAAY,iBAAiB,OAC5C,QAAO,IAAI,WAAW,MAAM,QAAQ,MAAM,YAAY,MAAM,WAAW;AAGzE,QAAO;;;;;AAMT,SAAgB,UAAU,OAAgB,KAAgB,UAAuB;AAC/E,KAAI,UAAU,KACZ,QAAO;AAIT,KAAI,iBAAiB,gBACnB,QAAO,MAAM;AAIf,KAAI,iBAAiB,UAAU;AAE7B,MAAI,IAAI,SAAS,cACf,QAAO,MAAM;AAGf,MAAI,IAAI,SAAS,eAAe;AAC9B,OAAI,CAAC,MAAM,WACT,OAAM,IAAI,MAAM,wDAAwD,IAAI,OAAO;AAErF,UAAO,MAAM;;AAGf,MAAI,IAAI,SAAS,YACf,QAAO,MAAM;AAGf,SAAO,MAAM;;AAGf,KAAI,CAAC,YAAY,SAAS,SAAS,IAAI,IAAI,SAAS,OAClD,QAAO,KAAK,UAAU,MAAM;AAG9B,KAAI,aAAa,YAAY,iBAAiB,KAC5C,QAAO,MAAM,SAAS;AAGxB,KAAI,aAAa,YAAY,OAAO,UAAU,UAAW,QAAO,QAAQ,IAAI;AAE5E,KAAI,aAAa,YAAY,OAAO,UAAU,UAAU;EACtD,MAAM,MAAM,OAAO,MAAM,EAAE;AAC3B,MAAI,gBAAgB,MAAM;AAC1B,SAAO;;AAIT,KAAI,IAAI,SAAS,YAAY,iBAAiB,WAC5C,QAAO,OAAO,KAAK,MAAM;AAG3B,QAAO"}
+{"version":3,"file":"serialize.js","names":["supportJson: SQLProvider[]"],"sources":["../../src/schema/serialize.ts"],"sourcesContent":["import type { SQLProvider } from \"../shared/providers\";\nimport type { AnyColumn } from \"./create\";\nimport { FragnoId, FragnoReference } from \"./create\";\n\nexport interface AdditionalColumnMetadata {\n  length?: number;\n  precision?: number;\n  scale?: number;\n}\n\n/**\n * Get the possible column types that the raw DB type can map to.\n */\nexport function dbToSchemaType(\n  dbType: string,\n  provider: SQLProvider,\n  additional: AdditionalColumnMetadata,\n): (AnyColumn[\"type\"] | \"varchar(n)\")[] {\n  dbType = dbType.toLowerCase();\n  if (provider === \"sqlite\") {\n    switch (dbType) {\n      case \"integer\":\n        return [\"bool\", \"date\", \"timestamp\", \"bigint\", \"integer\"];\n      case \"text\":\n        return [\"json\", \"string\", \"bigint\", \"varchar(n)\"];\n      case \"real\":\n      case \"numeric\":\n        return [\"decimal\"];\n      case \"blob\":\n        return [\"bigint\", \"binary\"];\n      default:\n        return [dbType as AnyColumn[\"type\"]];\n    }\n  }\n\n  if (provider === \"postgresql\" || provider === \"cockroachdb\") {\n    switch (dbType) {\n      case \"decimal\":\n      case \"real\":\n      case \"numeric\":\n      case \"double precision\":\n        return [\"decimal\"];\n      case \"timestamp\":\n      case \"timestamptz\":\n        return [\"timestamp\"];\n      case \"varchar\": {\n        const len = additional.length;\n        if (len != null) {\n          return [`varchar(${len})`];\n        }\n        return [\"string\"];\n      }\n      case \"text\":\n        return [\"string\"];\n      case \"boolean\":\n      case \"bool\":\n        return [\"bool\"];\n      case \"bytea\":\n        return [\"binary\"];\n      default:\n        return [dbType as AnyColumn[\"type\"]];\n    }\n  }\n\n  if (provider === \"mysql\") {\n    switch (dbType) {\n      case \"bool\":\n      case \"boolean\":\n        return [\"bool\"];\n      case \"integer\":\n      case \"int\":\n        return [\"integer\"];\n      case \"decimal\":\n      case \"numeric\":\n      case \"float\":\n      case \"double\":\n        return [\"decimal\"];\n      case \"datetime\":\n        return [\"timestamp\"];\n      case \"varchar\": {\n        const len = additional.length;\n        if (len != null) {\n          return [`varchar(${len})`];\n        }\n        return [\"string\"];\n      }\n      case \"text\":\n        return [\"string\"];\n      case \"longblob\":\n      case \"blob\":\n      case \"mediumblob\":\n      case \"tinyblob\":\n        return [\"binary\"];\n      default:\n        return [dbType as AnyColumn[\"type\"]];\n    }\n  }\n\n  if (provider === \"mssql\") {\n    switch (dbType) {\n      case \"int\":\n        return [\"integer\"];\n      case \"decimal\":\n      case \"float\":\n      case \"real\":\n      case \"numeric\":\n        return [\"decimal\"];\n      case \"bit\":\n        return [\"bool\"];\n      case \"datetime\":\n      case \"datetime2\":\n        return [\"timestamp\"];\n      case \"nvarchar\":\n      case \"varchar\": {\n        const len = additional.length;\n        if (len != null) {\n          return [`varchar(${len})`];\n        }\n        return [\"string\", \"json\"];\n      }\n      case \"ntext\":\n      case \"text\":\n      case \"varchar(max)\":\n      case \"nvarchar(max)\":\n        return [\"string\", \"json\"];\n      case \"binary\":\n      case \"varbinary\":\n        return [\"binary\"];\n      default:\n        return [dbType as AnyColumn[\"type\"]];\n    }\n  }\n\n  throw new Error(`unhandled database provider: ${provider}`);\n}\n\n/**\n * Database type literals that can be returned by schemaToDBType\n */\nexport type DBTypeLiteral =\n  // PostgreSQL/CockroachDB types\n  | \"bigserial\"\n  | \"serial\"\n  | \"boolean\"\n  | \"bool\"\n  | \"json\"\n  | \"text\"\n  | \"bytea\"\n  | \"timestamp\"\n  | \"timestamptz\"\n  | \"bigint\"\n  | \"integer\"\n  | \"decimal\"\n  | \"date\"\n  // MySQL types\n  | \"longblob\"\n  | \"datetime\"\n  // SQLite types\n  | \"blob\"\n  | \"real\"\n  // MSSQL types\n  | \"bit\"\n  | \"int\"\n  | \"varbinary(max)\"\n  | \"varchar(max)\"\n  // varchar with length parameter\n  | `varchar(${number})`;\n\nexport function schemaToDBType(\n  column: AnyColumn | Pick<AnyColumn, \"type\">,\n  provider: SQLProvider,\n): DBTypeLiteral {\n  const { type } = column;\n\n  // Handle internal ID columns with auto-increment\n  if (\"role\" in column && column.role === \"internal-id\") {\n    if (provider === \"postgresql\" || provider === \"cockroachdb\") {\n      return \"bigserial\";\n    }\n    if (provider === \"mysql\") {\n      return \"bigint\";\n    }\n    if (provider === \"sqlite\") {\n      return \"integer\"; // SQLite uses INTEGER for auto-increment\n    }\n    if (provider === \"mssql\") {\n      return \"bigint\";\n    }\n  }\n\n  if (\"role\" in column && column.role === \"reference\") {\n    if (provider === \"sqlite\") {\n      return \"integer\";\n    }\n    // Other providers use bigint for references\n  }\n\n  if (provider === \"sqlite\") {\n    switch (type) {\n      case \"integer\":\n      case \"timestamp\":\n      case \"date\":\n      case \"bool\":\n        return \"integer\";\n      case \"binary\":\n      case \"bigint\":\n        return \"blob\";\n      case \"json\":\n      case \"string\":\n        return \"text\";\n      case \"decimal\":\n        return \"real\";\n      default:\n        // sqlite doesn't support varchar\n        if (type.startsWith(\"varchar\")) {\n          return \"text\";\n        }\n    }\n  }\n\n  if (provider === \"mssql\") {\n    switch (type) {\n      case \"bool\":\n        return \"bit\";\n      case \"timestamp\":\n        return \"datetime\";\n      case \"integer\":\n        return \"int\";\n      case \"string\":\n        return \"varchar(max)\";\n      case \"binary\":\n        return \"varbinary(max)\";\n      // only 2025 preview supports JSON natively\n      case \"json\":\n        return \"varchar(max)\";\n      default:\n        if (type.startsWith(\"varchar\")) {\n          return type as `varchar(${number})`;\n        }\n        return type;\n    }\n  }\n\n  if (provider === \"postgresql\" || provider === \"cockroachdb\") {\n    switch (type) {\n      case \"bool\":\n        return \"boolean\";\n      case \"json\":\n        return \"json\";\n      case \"string\":\n        return \"text\";\n      case \"binary\":\n        return \"bytea\";\n      default:\n        if (type.startsWith(\"varchar\")) {\n          return type as `varchar(${number})`;\n        }\n        return type;\n    }\n  }\n\n  if (provider === \"mysql\") {\n    switch (type) {\n      case \"bool\":\n        return \"boolean\";\n      case \"string\":\n        return \"text\";\n      case \"binary\":\n        return \"longblob\";\n      default:\n        if (type.startsWith(\"varchar\")) {\n          return type as `varchar(${number})`;\n        }\n        return type;\n    }\n  }\n\n  throw new Error(`cannot handle ${provider} ${type}`);\n}\n\nconst supportJson: SQLProvider[] = [\"postgresql\", \"cockroachdb\", \"mysql\"];\n\n/**\n * Parse from driver value\n */\nexport function deserialize(value: unknown, col: AnyColumn, provider: SQLProvider) {\n  if (value === null) {\n    return null;\n  }\n\n  if (!supportJson.includes(provider) && col.type === \"json\" && typeof value === \"string\") {\n    return JSON.parse(value);\n  }\n\n  if (\n    provider === \"sqlite\" &&\n    (col.type === \"timestamp\" || col.type === \"date\") &&\n    (typeof value === \"number\" || typeof value === \"string\")\n  ) {\n    return new Date(value);\n  }\n\n  if (col.type === \"bool\" && typeof value === \"number\") {\n    return value === 1;\n  }\n\n  if (col.type === \"bigint\" && value instanceof Buffer) {\n    return value.readBigInt64BE(0);\n  }\n\n  if (col.type === \"bigint\" && typeof value === \"string\") {\n    return BigInt(value);\n  }\n\n  if (col.type === \"binary\" && value instanceof Buffer) {\n    return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);\n  }\n\n  return value;\n}\n\n/**\n * Encode to driver value\n */\nexport function serialize(value: unknown, col: AnyColumn, provider: SQLProvider) {\n  if (value === null) {\n    return null;\n  }\n\n  // Handle FragnoReference objects (for reference columns)\n  if (value instanceof FragnoReference) {\n    return value.internalId;\n  }\n\n  // Handle FragnoId objects\n  if (value instanceof FragnoId) {\n    // For external ID columns, use the external ID\n    if (col.role === \"external-id\") {\n      return value.externalId;\n    }\n    // For internal ID columns, use the internal ID (must be present)\n    if (col.role === \"internal-id\") {\n      if (!value.internalId) {\n        throw new Error(`FragnoId must have internalId for internal-id column ${col.name}`);\n      }\n      return value.internalId;\n    }\n    // For reference columns, prefer internal ID if available\n    if (col.role === \"reference\") {\n      return value.databaseId;\n    }\n    // Default to external ID for other columns\n    return value.externalId;\n  }\n\n  if (!supportJson.includes(provider) && col.type === \"json\") {\n    return JSON.stringify(value);\n  }\n\n  if (provider === \"sqlite\" && value instanceof Date) {\n    return value.getTime();\n  }\n\n  if (provider === \"sqlite\" && typeof value === \"boolean\") {\n    return value ? 1 : 0;\n  }\n\n  if (provider === \"sqlite\" && typeof value === \"bigint\") {\n    const buf = Buffer.alloc(8);\n    buf.writeBigInt64BE(value);\n    return buf;\n  }\n\n  // most drivers accept Buffer\n  if (col.type === \"binary\" && value instanceof Uint8Array) {\n    return Buffer.from(value);\n  }\n\n  return value;\n}\n"],"mappings":"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"}

package/dist/shared/settings-schema.js

@@ -0,0 +1,36 @@
+import { column, idColumn, schema } from "../schema/create.js";
+
+//#region src/shared/settings-schema.ts
+const SETTINGS_TABLE_NAME = "fragno_db_settings";
+const SETTINGS_NAMESPACE = "fragno-db-settings";
+const settingsSchema = schema((s) => {
+	return s.addTable(SETTINGS_TABLE_NAME, (t) => {
+		return t.addColumn("id", idColumn()).addColumn("key", column("string")).addColumn("value", column("string")).createIndex("unique_key", ["key"], { unique: true });
+	});
+});
+function createSettingsManager(queryEngine, namespace) {
+	return {
+		async get(key) {
+			const [[result]] = await queryEngine.createUnitOfWork().find(SETTINGS_TABLE_NAME, (b) => b.whereIndex("unique_key", (eb) => eb("key", "=", `${namespace}.${key}`))).executeRetrieve();
+			return result;
+		},
+		async set(key, value) {
+			const uow = queryEngine.createUnitOfWork("createSettingsManager#set").find(SETTINGS_TABLE_NAME, (b) => b.whereIndex("unique_key", (eb) => eb("key", "=", `${namespace}.${key}`)));
+			const [[existing]] = await uow.executeRetrieve();
+			if (existing) uow.update(SETTINGS_TABLE_NAME, existing.id, (b) => b.set({ value }).check());
+			else uow.create(SETTINGS_TABLE_NAME, {
+				key: `${namespace}.${key}`,
+				value
+			});
+			const { success } = await uow.executeMutations();
+			if (!success) throw new Error("Failed to set schema version");
+		},
+		async delete(id) {
+			await queryEngine.delete(SETTINGS_TABLE_NAME, id);
+		}
+	};
+}
+
+//#endregion
+export { SETTINGS_NAMESPACE, SETTINGS_TABLE_NAME, createSettingsManager, settingsSchema };
+//# sourceMappingURL=settings-schema.js.map

package/dist/shared/settings-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-schema.js","names":[],"sources":["../../src/shared/settings-schema.ts"],"sourcesContent":["import type { AbstractQuery } from \"../query/query\";\nimport { schema, idColumn, column, type FragnoId } from \"../schema/create\";\n\nexport const SETTINGS_TABLE_NAME = \"fragno_db_settings\" as const;\nexport const SETTINGS_NAMESPACE = \"fragno-db-settings\" as const;\n\nexport const settingsSchema = schema((s) => {\n  return s.addTable(SETTINGS_TABLE_NAME, (t) => {\n    return t\n      .addColumn(\"id\", idColumn())\n      .addColumn(\"key\", column(\"string\"))\n      .addColumn(\"value\", column(\"string\"))\n      .createIndex(\"unique_key\", [\"key\"], { unique: true });\n  });\n});\n\nexport function createSettingsManager(\n  // oxlint-disable-next-line no-explicit-any\n  queryEngine: AbstractQuery<typeof settingsSchema, any>,\n  namespace: string,\n) {\n  return {\n    async get(key: string): Promise<{ id: FragnoId; key: string; value: string } | undefined> {\n      const uow = queryEngine\n        .createUnitOfWork()\n        .find(SETTINGS_TABLE_NAME, (b) =>\n          b.whereIndex(\"unique_key\", (eb) => eb(\"key\", \"=\", `${namespace}.${key}`)),\n        );\n      const [[result]] = await uow.executeRetrieve();\n      return result; // Safe: result can be undefined if key doesn't exist\n    },\n\n    async set(key: string, value: string) {\n      const uow = queryEngine\n        .createUnitOfWork(\"createSettingsManager#set\")\n        .find(SETTINGS_TABLE_NAME, (b) =>\n          b.whereIndex(\"unique_key\", (eb) => eb(\"key\", \"=\", `${namespace}.${key}`)),\n        );\n      const [[existing]] = await uow.executeRetrieve();\n\n      if (existing) {\n        uow.update(SETTINGS_TABLE_NAME, existing.id, (b) => b.set({ value }).check());\n      } else {\n        uow.create(SETTINGS_TABLE_NAME, {\n          key: `${namespace}.${key}`,\n          value,\n        });\n      }\n\n      const { success } = await uow.executeMutations();\n\n      if (!success) {\n        throw new Error(\"Failed to set schema version\");\n      }\n    },\n\n    async delete(id: FragnoId) {\n      await queryEngine.delete(SETTINGS_TABLE_NAME, id);\n    },\n  };\n}\n"],"mappings":";;;AAGA,MAAa,sBAAsB;AACnC,MAAa,qBAAqB;AAElC,MAAa,iBAAiB,QAAQ,MAAM;AAC1C,QAAO,EAAE,SAAS,sBAAsB,MAAM;AAC5C,SAAO,EACJ,UAAU,MAAM,UAAU,CAAC,CAC3B,UAAU,OAAO,OAAO,SAAS,CAAC,CAClC,UAAU,SAAS,OAAO,SAAS,CAAC,CACpC,YAAY,cAAc,CAAC,MAAM,EAAE,EAAE,QAAQ,MAAM,CAAC;GACvD;EACF;AAEF,SAAgB,sBAEd,aACA,WACA;AACA,QAAO;EACL,MAAM,IAAI,KAAgF;GAMxF,MAAM,CAAC,CAAC,WAAW,MALP,YACT,kBAAkB,CAClB,KAAK,sBAAsB,MAC1B,EAAE,WAAW,eAAe,OAAO,GAAG,OAAO,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC,CAC1E,CAC0B,iBAAiB;AAC9C,UAAO;;EAGT,MAAM,IAAI,KAAa,OAAe;GACpC,MAAM,MAAM,YACT,iBAAiB,4BAA4B,CAC7C,KAAK,sBAAsB,MAC1B,EAAE,WAAW,eAAe,OAAO,GAAG,OAAO,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC,CAC1E;GACH,MAAM,CAAC,CAAC,aAAa,MAAM,IAAI,iBAAiB;AAEhD,OAAI,SACF,KAAI,OAAO,qBAAqB,SAAS,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC;OAE7E,KAAI,OAAO,qBAAqB;IAC9B,KAAK,GAAG,UAAU,GAAG;IACrB;IACD,CAAC;GAGJ,MAAM,EAAE,YAAY,MAAM,IAAI,kBAAkB;AAEhD,OAAI,CAAC,QACH,OAAM,IAAI,MAAM,+BAA+B;;EAInD,MAAM,OAAO,IAAc;AACzB,SAAM,YAAY,OAAO,qBAAqB,GAAG;;EAEpD"}

package/dist/util/import-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"import-generator.js","names":["v: string[]","names"],"sources":["../../src/util/import-generator.ts"],"sourcesContent":["export function importGenerator() {\n  const names = new Set<string>();\n  // specifier -> import name\n  const map = new Map<string, string[]>();\n\n  return {\n    addImport(name: string, specifier: string) {\n      if (names.has(name)) {\n        return;\n      }\n\n      names.add(name);\n      const list = map.get(specifier) ?? [];\n      list.push(name);\n      map.set(specifier, list);\n    },\n    format(): string {\n      const v: string[] = [];\n      for (const [specifier, names] of map) {\n        if (names.length === 0) continue;\n\n        v.push(`import { ${names.join(\", \")} } from \"${specifier}\"`);\n      }\n\n      return v.join(\"\\n\");\n    },\n  };\n}\n"],"mappings":";AAAA,SAAgB,kBAAkB;CAChC,MAAM,wBAAQ,IAAI,KAAa;CAE/B,MAAM,sBAAM,IAAI,KAAuB;AAEvC,QAAO;EACL,UAAU,MAAc,WAAmB;AACzC,OAAI,MAAM,IAAI,KAAK,CACjB;AAGF,SAAM,IAAI,KAAK;GACf,MAAM,OAAO,IAAI,IAAI,UAAU,IAAI,EAAE;AACrC,QAAK,KAAK,KAAK;AACf,OAAI,IAAI,WAAW,KAAK;;EAE1B,SAAiB;GACf,MAAMA,IAAc,EAAE;AACtB,QAAK,MAAM,CAAC,WAAWC,YAAU,KAAK;AACpC,QAAIA,QAAM,WAAW,EAAG;AAExB,MAAE,KAAK,YAAYA,QAAM,KAAK,KAAK,CAAC,WAAW,UAAU,GAAG;;AAG9D,UAAO,EAAE,KAAK,KAAK;;EAEtB"}
+{"version":3,"file":"import-generator.js","names":["v: string[]","names"],"sources":["../../src/util/import-generator.ts"],"sourcesContent":["export function importGenerator() {\n  const names = new Set<string>();\n  // specifier -> import name\n  const map = new Map<string, string[]>();\n\n  return {\n    addImport(name: string, specifier: string) {\n      if (names.has(name)) {\n        return;\n      }\n\n      names.add(name);\n      const list = map.get(specifier) ?? [];\n      list.push(name);\n      map.set(specifier, list);\n    },\n    format(): string {\n      const v: string[] = [];\n      for (const [specifier, names] of map) {\n        if (names.length === 0) {\n          continue;\n        }\n\n        v.push(`import { ${names.join(\", \")} } from \"${specifier}\"`);\n      }\n\n      return v.join(\"\\n\");\n    },\n  };\n}\n"],"mappings":";AAAA,SAAgB,kBAAkB;CAChC,MAAM,wBAAQ,IAAI,KAAa;CAE/B,MAAM,sBAAM,IAAI,KAAuB;AAEvC,QAAO;EACL,UAAU,MAAc,WAAmB;AACzC,OAAI,MAAM,IAAI,KAAK,CACjB;AAGF,SAAM,IAAI,KAAK;GACf,MAAM,OAAO,IAAI,IAAI,UAAU,IAAI,EAAE;AACrC,QAAK,KAAK,KAAK;AACf,OAAI,IAAI,WAAW,KAAK;;EAE1B,SAAiB;GACf,MAAMA,IAAc,EAAE;AACtB,QAAK,MAAM,CAAC,WAAWC,YAAU,KAAK;AACpC,QAAIA,QAAM,WAAW,EACnB;AAGF,MAAE,KAAK,YAAYA,QAAM,KAAK,KAAK,CAAC,WAAW,UAAU,GAAG;;AAG9D,UAAO,EAAE,KAAK,KAAK;;EAEtB"}

package/dist/util/parse.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse.js","names":[],"sources":["../../src/util/parse.ts"],"sourcesContent":["const RegexVarchar = /^varchar\\((\\d+)\\)$/;\n\nexport function parseVarchar(template: string): number {\n  const match = RegexVarchar.exec(template);\n  if (!match) throw new Error(\"Failed to match varchar(n)\");\n  return Number(match[1]);\n}\n\nexport function ident(s: string, identation = 2): string {\n  const tab = \" \".repeat(identation);\n\n  return s\n    .split(\"\\n\")\n    .map((v) => tab + v)\n    .join(\"\\n\");\n}\n"],"mappings":";AAAA,MAAM,eAAe;AAErB,SAAgB,aAAa,UAA0B;CACrD,MAAM,QAAQ,aAAa,KAAK,SAAS;AACzC,KAAI,CAAC,MAAO,OAAM,IAAI,MAAM,6BAA6B;AACzD,QAAO,OAAO,MAAM,GAAG;;AAGzB,SAAgB,MAAM,GAAW,aAAa,GAAW;CACvD,MAAM,MAAM,IAAI,OAAO,WAAW;AAElC,QAAO,EACJ,MAAM,KAAK,CACX,KAAK,MAAM,MAAM,EAAE,CACnB,KAAK,KAAK"}
+{"version":3,"file":"parse.js","names":[],"sources":["../../src/util/parse.ts"],"sourcesContent":["const RegexVarchar = /^varchar\\((\\d+)\\)$/;\n\nexport function parseVarchar(template: string): number {\n  const match = RegexVarchar.exec(template);\n  if (!match) {\n    throw new Error(\"Failed to match varchar(n)\");\n  }\n  return Number(match[1]);\n}\n\nexport function ident(s: string, identation = 2): string {\n  const tab = \" \".repeat(identation);\n\n  return s\n    .split(\"\\n\")\n    .map((v) => tab + v)\n    .join(\"\\n\");\n}\n"],"mappings":";AAAA,MAAM,eAAe;AAErB,SAAgB,aAAa,UAA0B;CACrD,MAAM,QAAQ,aAAa,KAAK,SAAS;AACzC,KAAI,CAAC,MACH,OAAM,IAAI,MAAM,6BAA6B;AAE/C,QAAO,OAAO,MAAM,GAAG;;AAGzB,SAAgB,MAAM,GAAW,aAAa,GAAW;CACvD,MAAM,MAAM,IAAI,OAAO,WAAW;AAElC,QAAO,EACJ,MAAM,KAAK,CACX,KAAK,MAAM,MAAM,EAAE,CACnB,KAAK,KAAK"}

package/package.json

@@ -1,83 +1,73 @@
 {
   "name": "@fragno-dev/db",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "exports": {
     ".": {
-      "bun": "./src/mod.ts",
       "development": "./src/mod.ts",
       "types": "./dist/mod.d.ts",
       "default": "./dist/mod.js"
     },
     "./id": {
-      "bun": "./src/id.ts",
       "development": "./src/id.ts",
       "types": "./dist/id.d.ts",
       "default": "./dist/id.js"
     },
     "./schema": {
-      "bun": "./src/schema/create.ts",
       "development": "./src/schema/create.ts",
       "types": "./dist/schema/create.d.ts",
       "default": "./dist/schema/create.js"
     },
     "./query": {
-      "bun": "./src/query/query.ts",
       "development": "./src/query/query.ts",
       "types": "./dist/query/query.d.ts",
       "default": "./dist/query/query.js"
     },
     "./adapters/kysely": {
-      "bun": "./src/adapters/kysely/kysely-adapter.ts",
       "development": "./src/adapters/kysely/kysely-adapter.ts",
       "types": "./dist/adapters/kysely/kysely-adapter.d.ts",
       "default": "./dist/adapters/kysely/kysely-adapter.js"
     },
     "./adapters/drizzle": {
-      "bun": "./src/adapters/drizzle/drizzle-adapter.ts",
       "development": "./src/adapters/drizzle/drizzle-adapter.ts",
       "types": "./dist/adapters/drizzle/drizzle-adapter.d.ts",
       "default": "./dist/adapters/drizzle/drizzle-adapter.js"
     },
     "./unit-of-work": {
-      "bun": "./src/query/unit-of-work.ts",
       "development": "./src/query/unit-of-work.ts",
       "types": "./dist/query/unit-of-work.d.ts",
       "default": "./dist/query/unit-of-work.js"
     },
     "./cursor": {
-      "bun": "./src/query/cursor.ts",
       "development": "./src/query/cursor.ts",
       "types": "./dist/query/cursor.d.ts",
       "default": "./dist/query/cursor.js"
     },
     "./fragment": {
-      "bun": "./src/fragment.ts",
       "development": "./src/fragment.ts",
       "types": "./dist/fragment.d.ts",
       "default": "./dist/fragment.js"
+    },
+    "./generation-engine": {
+      "development": "./src/migration-engine/generation-engine.ts",
+      "types": "./dist/migration-engine/generation-engine.d.ts",
+      "default": "./dist/migration-engine/generation-engine.js"
     }
   },
-  "scripts": {
-    "build": "tsdown",
-    "build:watch": "tsdown --watch",
-    "types:check": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest --watch"
-  },
   "devDependencies": {
     "@electric-sql/pglite": "^0.3.10",
-    "@fragno-dev/core": "0.1.1",
-    "@fragno-private/typescript-config": "0.0.1",
-    "@fragno-private/vitest-config": "0.0.0",
-    "@types/bun": "^1.2.23",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^22",
     "@vitest/coverage-istanbul": "^3.2.4",
+    "better-sqlite3": "^12.4.1",
     "drizzle-kit": "^0.31.5",
     "drizzle-orm": "^0.44.6",
     "kysely-pglite": "^0.6.1",
     "vitest": "^3.2.4",
-    "zod": "^4.1.12"
+    "zod": "^4.1.12",
+    "@fragno-dev/core": "0.1.2",
+    "@fragno-private/typescript-config": "0.0.1",
+    "@fragno-private/vitest-config": "0.0.0"
   },
   "repository": {
     "type": "git",
@@ -89,5 +79,12 @@
   "dependencies": {
     "@paralleldrive/cuid2": "^2.2.2",
     "kysely": "^0.28.7"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "build:watch": "tsdown --watch",
+    "types:check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest --watch"
   }
-}
+}

package/src/adapters/adapters.ts

@@ -15,8 +15,15 @@ export interface DatabaseAdapter<TUOWConfig = void> {
   ) => AbstractQuery<T, TUOWConfig>;
 
   createMigrationEngine?: <const T extends AnySchema>(schema: T, namespace: string) => Migrator;
-  createSchemaGenerator?: <const T extends AnySchema>(
-    schema: T,
-    namespace: string,
+
+  /**
+   * Generate a combined schema file from one or more fragments.
+   * If not implemented, schema generation is not supported for this adapter.
+   */
+  createSchemaGenerator?: (
+    fragments: { schema: AnySchema; namespace: string }[],
+    options?: { path?: string },
   ) => SchemaGenerator;
+
+  isConnectionHealthy: () => Promise<boolean>;
 }

package/src/adapters/drizzle/drizzle-adapter-pglite.test.ts

@@ -80,6 +80,7 @@ describe("DrizzleAdapter PGLite", () => {
       "drizzle-adapter-pglite",
       testSchema,
       "postgresql",
+      "namespace",
     );
 
     // Create Drizzle instance with PGLite (in-memory Postgres)
@@ -103,13 +104,16 @@ describe("DrizzleAdapter PGLite", () => {
       provider: "postgresql",
     });
 
+    expect(await adapter.isConnectionHealthy()).toBe(true);
+
     return async () => {
       await cleanup();
     };
   }, 12000);
 
   it("should execute Unit of Work with version checking", async () => {
-    const queryEngine = adapter.createQueryEngine(testSchema, "test");
+    // Pass namespace to ensure mapper translates logical table names to physical (prefixed) names
+    const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
 
     // Create initial user using UOW
     const createUow = queryEngine.createUnitOfWork("create-user").create("users", {
@@ -194,7 +198,7 @@ describe("DrizzleAdapter PGLite", () => {
   });
 
   it("should support count operations", async () => {
-    const queryEngine = adapter.createQueryEngine(testSchema, "test");
+    const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
 
     // Create some users
     await queryEngine
@@ -215,7 +219,7 @@ describe("DrizzleAdapter PGLite", () => {
   });
 
   it("should support cursor-based pagination", async () => {
-    const queryEngine = adapter.createQueryEngine(testSchema, "test");
+    const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
 
     const createUow = queryEngine
       .createUnitOfWork("create-users")
@@ -262,7 +266,7 @@ describe("DrizzleAdapter PGLite", () => {
   });
 
   it("should support joins", async () => {
-    const queryEngine = adapter.createQueryEngine(testSchema, "test");
+    const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
     const queries: DrizzleCompiledQuery[] = [];
 
     const createUow = queryEngine
@@ -298,7 +302,7 @@ describe("DrizzleAdapter PGLite", () => {
 
     const [query] = queries;
     expect(query.sql).toMatchInlineSnapshot(
-      `"select "emails"."id", "emails"."user_id", "emails"."email", "emails"."is_primary", "emails"."_internalId", "emails"."_version", "emails_user"."data" as "user" from "emails" "emails" left join lateral (select json_build_array("emails_user"."name", "emails_user"."id", "emails_user"."age", "emails_user"."_internalId", "emails_user"."_version") as "data" from (select * from "users" "emails_user" where "emails_user"."_internalId" = "emails"."user_id" limit $1) "emails_user") "emails_user" on true"`,
+      `"select "emails_namespace"."id", "emails_namespace"."user_id", "emails_namespace"."email", "emails_namespace"."is_primary", "emails_namespace"."_internalId", "emails_namespace"."_version", "emails_namespace_user"."data" as "user" from "emails_namespace" "emails_namespace" left join lateral (select json_build_array("emails_namespace_user"."name", "emails_namespace_user"."id", "emails_namespace_user"."age", "emails_namespace_user"."_internalId", "emails_namespace_user"."_version") as "data" from (select * from "users_namespace" "emails_namespace_user" where "emails_namespace_user"."_internalId" = "emails_namespace"."user_id" limit $1) "emails_namespace_user") "emails_namespace_user" on true"`,
     );
 
     expect(email).toMatchObject({
@@ -323,7 +327,7 @@ describe("DrizzleAdapter PGLite", () => {
   });
 
   it("should support complex nested joins (comments -> post -> author)", async () => {
-    const queryEngine = adapter.createQueryEngine(testSchema, "test");
+    const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
     const queries: DrizzleCompiledQuery[] = [];
 
     // Create a user (author)
@@ -427,7 +431,7 @@ describe("DrizzleAdapter PGLite", () => {
 
     const [query] = queries;
     expect(query.sql).toMatchInlineSnapshot(
-      `"select "comments"."id", "comments"."post_id", "comments"."user_id", "comments"."text", "comments"."_internalId", "comments"."_version", "comments_post"."data" as "post", "comments_commenter"."data" as "commenter" from "comments" "comments" left join lateral (select json_build_array("comments_post"."id", "comments_post"."title", "comments_post"."content", "comments_post"."_internalId", "comments_post"."_version", "comments_post_author"."data") as "data" from (select * from "posts" "comments_post" where "comments_post"."_internalId" = "comments"."post_id" order by "comments_post"."id" desc limit $1) "comments_post" left join lateral (select json_build_array("comments_post_author"."id", "comments_post_author"."name", "comments_post_author"."age", "comments_post_author"."_internalId", "comments_post_author"."_version") as "data" from (select * from "users" "comments_post_author" where "comments_post_author"."_internalId" = "comments_post"."user_id" order by "comments_post_author"."name" asc limit $2) "comments_post_author") "comments_post_author" on true) "comments_post" on true left join lateral (select json_build_array("comments_commenter"."id", "comments_commenter"."name", "comments_commenter"."_internalId", "comments_commenter"."_version") as "data" from (select * from "users" "comments_commenter" where "comments_commenter"."_internalId" = "comments"."user_id" limit $3) "comments_commenter") "comments_commenter" on true"`,
+      `"select "comments_namespace"."id", "comments_namespace"."post_id", "comments_namespace"."user_id", "comments_namespace"."text", "comments_namespace"."_internalId", "comments_namespace"."_version", "comments_namespace_post"."data" as "post", "comments_namespace_commenter"."data" as "commenter" from "comments_namespace" "comments_namespace" left join lateral (select json_build_array("comments_namespace_post"."id", "comments_namespace_post"."title", "comments_namespace_post"."content", "comments_namespace_post"."_internalId", "comments_namespace_post"."_version", "comments_namespace_post_author"."data") as "data" from (select * from "posts_namespace" "comments_namespace_post" where "comments_namespace_post"."_internalId" = "comments_namespace"."post_id" order by "comments_namespace_post"."id" desc limit $1) "comments_namespace_post" left join lateral (select json_build_array("comments_namespace_post_author"."id", "comments_namespace_post_author"."name", "comments_namespace_post_author"."age", "comments_namespace_post_author"."_internalId", "comments_namespace_post_author"."_version") as "data" from (select * from "users_namespace" "comments_namespace_post_author" where "comments_namespace_post_author"."_internalId" = "comments_namespace_post"."user_id" order by "comments_namespace_post_author"."name" asc limit $2) "comments_namespace_post_author") "comments_namespace_post_author" on true) "comments_namespace_post" on true left join lateral (select json_build_array("comments_namespace_commenter"."id", "comments_namespace_commenter"."name", "comments_namespace_commenter"."_internalId", "comments_namespace_commenter"."_version") as "data" from (select * from "users_namespace" "comments_namespace_commenter" where "comments_namespace_commenter"."_internalId" = "comments_namespace"."user_id" limit $3) "comments_namespace_commenter") "comments_namespace_commenter" on true"`,
     );
   });
 });