@danielfgray/pg-sourcerer 0.2.2 → 0.4.0

package/dist/plugins/effect/shared.js

@@ -0,0 +1,164 @@
+/**
+ * Shared utilities for Effect plugin suite
+ */
+import { Schema as S } from "effect";
+import { conjure } from "../../conjure/index.js";
+// =============================================================================
+// Configuration
+// =============================================================================
+/**
+ * HTTP API configuration schema (for Schema validation - simple types only)
+ */
+export const HttpConfigSchema = S.Struct({
+    /** Enable HTTP API generation. Default: true */
+    enabled: S.optionalWith(S.Boolean, { default: () => true }),
+    /** Base path for all routes. Default: "/api" */
+    basePath: S.optionalWith(S.String, { default: () => "/api" }),
+});
+export const EffectConfigSchema = S.Struct({
+    /** Export inferred TypeScript types alongside schemas. Default: true */
+    exportTypes: S.optionalWith(S.Boolean, { default: () => true }),
+    /** Generate Model.makeRepository for tables with single-column PKs. Default: true */
+    repos: S.optionalWith(S.Boolean, { default: () => true }),
+    /** HTTP API generation config. Set to false to disable. Default: enabled */
+    http: S.optionalWith(S.Union(S.Literal(false), HttpConfigSchema), { default: () => ({ enabled: true, basePath: "/api" }) }),
+});
+// =============================================================================
+// PostgreSQL Type Sets
+// =============================================================================
+export const PG_STRING_TYPES = new Set([
+    "uuid",
+    "text",
+    "varchar",
+    "char",
+    "character",
+    "name",
+    "bpchar",
+    "citext",
+]);
+export const PG_NUMBER_TYPES = new Set([
+    "int2",
+    "int4",
+    "int8",
+    "integer",
+    "smallint",
+    "bigint",
+    "numeric",
+    "decimal",
+    "real",
+    "float4",
+    "float8",
+    "double",
+]);
+export const PG_BOOLEAN_TYPES = new Set(["bool", "boolean"]);
+export const PG_DATE_TYPES = new Set(["timestamp", "timestamptz", "date", "time", "timetz"]);
+export const PG_JSON_TYPES = new Set(["json", "jsonb"]);
+export function fieldToEffectMapping(field, enums) {
+    const pgType = field.pgAttribute.getType();
+    if (!pgType) {
+        return { kind: "schema", schema: conjure.id("S").prop("Unknown").build() };
+    }
+    let typeName;
+    let typeInfo;
+    if (pgType.typcategory === "A") {
+        typeName = field.elementTypeName ?? "unknown";
+        typeInfo = pgType;
+    }
+    else if (pgType.typtype === "d" && field.domainBaseType) {
+        typeName = field.domainBaseType.typeName;
+        typeInfo = { typcategory: field.domainBaseType.category };
+    }
+    else {
+        typeName = pgType.typname;
+        typeInfo = pgType;
+    }
+    const baseResult = baseTypeToEffectMapping(typeName, typeInfo, enums);
+    if (baseResult.kind === "enumRef") {
+        return baseResult;
+    }
+    let schema = baseResult.schema;
+    // S.Array(elementType) - static method, not chained
+    if (field.isArray) {
+        schema = conjure.id("S").method("Array", [schema]).build();
+    }
+    if (field.nullable) {
+        schema = conjure.id("S").method("NullOr", [schema]).build();
+    }
+    return { kind: "schema", schema };
+}
+function baseTypeToEffectMapping(typeName, pgType, enums) {
+    const normalized = typeName.toLowerCase();
+    if (PG_STRING_TYPES.has(normalized)) {
+        if (normalized === "uuid") {
+            return { kind: "schema", schema: conjure.id("S").prop("UUID").build() };
+        }
+        return { kind: "schema", schema: conjure.id("S").prop("String").build() };
+    }
+    if (PG_NUMBER_TYPES.has(normalized)) {
+        if (normalized === "bigint" || normalized === "int8") {
+            return { kind: "schema", schema: conjure.id("S").prop("BigInt").build() };
+        }
+        return { kind: "schema", schema: conjure.id("S").prop("Number").build() };
+    }
+    if (PG_BOOLEAN_TYPES.has(normalized)) {
+        return { kind: "schema", schema: conjure.id("S").prop("Boolean").build() };
+    }
+    if (PG_DATE_TYPES.has(normalized)) {
+        return { kind: "schema", schema: conjure.id("S").prop("DateFromSelf").build() };
+    }
+    if (PG_JSON_TYPES.has(normalized)) {
+        return { kind: "schema", schema: conjure.id("S").prop("Unknown").build() };
+    }
+    if (pgType.typtype === "e" || pgType.typcategory === "E") {
+        const enumEntity = enums.find(e => e.pgType.typname === typeName);
+        if (enumEntity) {
+            return { kind: "enumRef", enumRef: enumEntity.name };
+        }
+        return { kind: "schema", schema: conjure.id("S").prop("Unknown").build() };
+    }
+    return { kind: "schema", schema: conjure.id("S").prop("Unknown").build() };
+}
+// =============================================================================
+// Entity Helpers
+// =============================================================================
+/**
+ * Check if entity has a single-column primary key (required for makeRepository)
+ */
+export function hasSingleColumnPrimaryKey(entity) {
+    return entity.primaryKey !== undefined && entity.primaryKey.columns.length === 1;
+}
+/**
+ * Get the primary key column name
+ */
+export function getPrimaryKeyColumn(entity) {
+    return entity.primaryKey?.columns[0];
+}
+/**
+ * Check if a field should be treated as DB-generated.
+ * Includes GENERATED ALWAYS, IDENTITY, and PK fields with defaults.
+ */
+export function isDbGenerated(field, entity) {
+    return (field.isGenerated ||
+        field.isIdentity ||
+        (field.hasDefault && entity.primaryKey?.columns.includes(field.columnName) === true));
+}
+/**
+ * Check for auto-timestamp patterns (created_at, updated_at)
+ */
+export function getAutoTimestamp(field) {
+    if (!field.hasDefault)
+        return undefined;
+    const name = field.columnName.toLowerCase();
+    if (name === "created_at" || name === "createdat")
+        return "insert";
+    if (name === "updated_at" || name === "updatedat")
+        return "update";
+    return undefined;
+}
+// =============================================================================
+// AST Helpers  
+// =============================================================================
+export function toExpr(node) {
+    return node;
+}
+//# sourceMappingURL=shared.js.map

package/dist/plugins/effect/shared.js.map

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

package/dist/plugins/http-elysia.d.ts

@@ -1,32 +1,25 @@
+import type { Plugin } from "../runtime/types.js";
+import { type FileNaming } from "../runtime/file-assignment.js";
 /**
- * HTTP Elysia Plugin - Generate Elysia route handlers from query plugins
- *
- * Consumes method symbols from sql-queries or kysely-queries via the symbol registry
- * and generates type-safe Elysia HTTP route handlers.
+ * Config type for user input.
+ * Supports both string literals and FileNaming functions for file paths.
  */
-import { Schema as S } from "effect";
-import { definePlugin } from "../services/plugin.js";
-declare const HttpElysiaConfigSchema: S.Struct<{
-    /** Output directory for generated route files. Default: "routes" */
-    outputDir: S.optionalWith<typeof S.String, {
-        default: () => string;
-    }>;
-    /** Base path for all routes. Default: "/api" */
-    basePath: S.optionalWith<typeof S.String, {
-        default: () => string;
-    }>;
-    /** Header content to prepend to each generated file */
-    header: S.optional<typeof S.String>;
+export interface HttpElysiaConfig {
+    outputDir?: string;
+    basePath?: string;
     /**
-     * Name of the aggregated router export.
-     * Default: "api"
+     * Output file for route handlers.
+     * Can be a static string or a function receiving FileNamingContext.
+     * @example "routes.ts" - all routes in one file
+     * @example ({ entityName }) => `${entityName}/routes.ts` - per-entity files
      */
-    aggregatorName: S.optionalWith<typeof S.String, {
-        default: () => string;
-    }>;
-}>;
-/** Input config type (with optional fields) */
-export type HttpElysiaConfig = S.Schema.Encoded<typeof HttpElysiaConfigSchema>;
-export declare function httpElysia(config: HttpElysiaConfig): ReturnType<typeof definePlugin>;
-export {};
+    routesFile?: string | FileNaming;
+    /**
+     * Output file for the aggregator app that .use()s all routes.
+     * @example "index.ts"
+     * @example ({ folderName }) => `${folderName}/app.ts`
+     */
+    appFile?: string | FileNaming;
+}
+export declare function elysia(config?: HttpElysiaConfig): Plugin;
 //# sourceMappingURL=http-elysia.d.ts.map

package/dist/plugins/http-elysia.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-elysia.d.ts","sourceRoot":"","sources":["../../src/plugins/http-elysia.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAgB,MAAM,IAAI,CAAC,EAAE,MAAM,QAAQ,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAsB,MAAM,uBAAuB,CAAC;AAkCzE,QAAA,MAAM,sBAAsB;IAC1B,oEAAoE;;;;IAGpE,gDAAgD;;;;IAGhD,uDAAuD;;IAGvD;;;OAGG;;;;EAEH,CAAC;AAEH,+CAA+C;AAC/C,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,sBAAsB,CAAC,CAAC;AA6jB/E,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAqMpF"}
+{"version":3,"file":"http-elysia.d.ts","sourceRoot":"","sources":["../../src/plugins/http-elysia.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,MAAM,EAAqC,MAAM,qBAAqB,CAAC;AASrF,OAAO,EAAE,KAAK,UAAU,EAA+C,MAAM,+BAA+B,CAAC;AA2D7G;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;CAC/B;AA0bD,wBAAgB,MAAM,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,MAAM,CA+IxD"}