@supawatch/target-factories 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Omar Dulaimi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,25 @@
+# @supawatch/target-factories
+
+The fixture-factory target for
+[supawatch](https://github.com/omar-dulaimi/supawatch). Emits one typed
+factory per table returning a full, deterministic row in driver shape,
+with overrides merged on top.
+
+Configure it in `supawatch.config.ts` (the CLI loads this package by name):
+
+```ts
+targets: [{ kind: "factories" }]
+```
+
+```ts
+import { makeTasks } from "./src/schemas/factories/tasks.mjs";
+
+const task = makeTasks({ title: "override just what the test cares about" });
+```
+
+The repo's suite asserts every factory's default row satisfies the
+generated Zod schema for the same table, so factories cannot drift into
+the narrow, wrong fixtures that hide bugs. That check has already caught
+one: an invalid placeholder UUID.
+
+MIT.

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import type { Rendered, Snapshot, Table, Target, TargetCapabilities, TargetOptions } from "@supawatch/core";
+export type FactoriesTargetOptions = TargetOptions;
+export declare function exportNameFor(table: Table): string;
+export declare class FactoriesTarget implements Target<FactoriesTargetOptions> {
+    readonly name = "factories";
+    readonly fileExtension = ".mjs";
+    readonly capabilities: TargetCapabilities;
+    renderTable(table: Table, _snapshot: Snapshot, _opts: FactoriesTargetOptions): Rendered;
+    renderTypes(table: Table, _snapshot: Snapshot, _opts: FactoriesTargetOptions): string;
+}
+export default FactoriesTarget;

package/dist/index.js

@@ -0,0 +1,112 @@
+function defaultExpr(runtime, seedPath) {
+    switch (runtime.kind) {
+        case "number":
+            return runtime.integer ? "1" : "1.5";
+        case "string":
+            switch (runtime.format) {
+                case "uuid":
+                    // A real v4 literal: zod's z.uuid() enforces RFC 4122 version
+                    // and variant bits, so an all-zeros-style value is rejected.
+                    // The cross-check against the zod target caught exactly that.
+                    return '"9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"';
+                case "numeric":
+                    return '"0.00"';
+                case "bigint":
+                    return '"1"';
+                default:
+                    return JSON.stringify(seedPath);
+            }
+        case "boolean":
+            return "false";
+        case "date":
+            return "new Date(0)";
+        case "bytes":
+            return "new Uint8Array()";
+        case "json":
+        case "unknown":
+            return "null";
+        case "array":
+            return "[]";
+        case "enum":
+            return JSON.stringify(runtime.labels[0] ?? "");
+    }
+}
+function baseNameFor(table) {
+    return table.name.replace(/[^a-zA-Z0-9_]/g, "_");
+}
+export function exportNameFor(table) {
+    const base = baseNameFor(table);
+    return "make" + base.charAt(0).toUpperCase() + base.slice(1);
+}
+function fieldDefault(table, col) {
+    if (col.nullable)
+        return "null";
+    return defaultExpr(col.runtime, `${table.name}.${col.name}`);
+}
+export class FactoriesTarget {
+    name = "factories";
+    fileExtension = ".mjs";
+    capabilities = {
+        strictObjects: false,
+        brandedTypes: false,
+        dateInstances: true,
+    };
+    renderTable(table, _snapshot, _opts) {
+        const fields = table.columns
+            .map((col) => `    ${JSON.stringify(col.name)}: ${fieldDefault(table, col)},`)
+            .join("\n");
+        const body = [
+            `export function ${exportNameFor(table)}(overrides = {}) {`,
+            "  return {",
+            fields,
+            "    ...overrides,",
+            "  };",
+            "}",
+        ].join("\n");
+        return { imports: [], body, exportName: exportNameFor(table) };
+    }
+    renderTypes(table, _snapshot, _opts) {
+        const name = exportNameFor(table);
+        const base = baseNameFor(table);
+        const rowType = `${base}FactoryRow`;
+        const tsType = (runtime) => {
+            switch (runtime.kind) {
+                case "number":
+                    return "number";
+                case "string":
+                    return "string";
+                case "boolean":
+                    return "boolean";
+                case "date":
+                    return "Date";
+                case "bytes":
+                    return "Uint8Array";
+                case "json":
+                case "unknown":
+                    return "unknown";
+                case "array": {
+                    const el = tsType(runtime.element);
+                    return el.includes("|") ? `(${el})[]` : `${el}[]`;
+                }
+                case "enum":
+                    return runtime.labels.map((l) => JSON.stringify(l)).join(" | ");
+            }
+        };
+        const fields = table.columns
+            .map((col) => {
+            const base = tsType(col.runtime);
+            const t = col.nullable && base !== "unknown" ? `${base} | null` : base;
+            return `  ${JSON.stringify(col.name)}: ${t};`;
+        })
+            .join("\n");
+        return [
+            "// Generated by supawatch. Do not edit.",
+            `export type ${rowType} = {`,
+            fields,
+            "};",
+            `export declare function ${name}(overrides?: Partial<${rowType}>): ${rowType};`,
+            "",
+        ].join("\n");
+    }
+}
+export default FactoriesTarget;

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@supawatch/target-factories",
+  "version": "0.1.3",
+  "description": "Typed fixture factories generated from live Postgres by supawatch, guaranteed to satisfy the generated Zod schemas.",
+  "keywords": [
+    "supabase",
+    "postgres",
+    "postgresql",
+    "codegen",
+    "schema",
+    "typescript",
+    "fixtures",
+    "factories",
+    "testing"
+  ],
+  "license": "MIT",
+  "author": "Omar Dulaimi",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/omar-dulaimi/supawatch.git",
+    "directory": "packages/target-factories"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@supawatch/core": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.1",
+    "typescript": "^5.9.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  }
+}