@prisma-next/targets-postgres 0.0.1

package/README.md

@@ -0,0 +1,62 @@
+# @prisma-next/targets-postgres
+
+Postgres target pack for Prisma Next.
+
+## Package Classification
+
+- **Domain**: extensions
+- **Layer**: targets
+- **Plane**: multi-plane (migration, runtime)
+
+## Purpose
+
+Provides the Postgres target descriptor (`TargetDescriptor`) for CLI config. The target descriptor includes the target manifest with capabilities and type information.
+
+## Responsibilities
+
+- **Target Descriptor Export**: Exports the Postgres `TargetDescriptor` for use in CLI configuration files
+- **Manifest Loading**: Loads the Postgres target manifest from `packs/manifest.json` with capabilities and type information
+- **Multi-Plane Support**: Provides both migration-plane (CLI) and runtime-plane entry points for the Postgres target
+
+This package spans multiple planes:
+- **Migration plane** (`src/exports/cli.ts`): CLI entry point that exports `TargetDescriptor` for config files
+- **Runtime plane** (`src/exports/runtime.ts`): Runtime entry point for target-specific runtime code (future)
+
+## Usage
+
+### Migration Plane (CLI)
+
+```typescript
+import postgres from '@prisma-next/targets-postgres/control';
+
+// postgres is a TargetDescriptor with:
+// - kind: 'target'
+// - id: 'postgres'
+// - family: 'sql'
+// - manifest: ExtensionPackManifest
+```
+
+### Runtime Plane
+
+```typescript
+// Runtime entry point (future)
+import { ... } from '@prisma-next/targets-postgres/runtime';
+```
+
+## Architecture
+
+This package provides both CLI and runtime entry points for the Postgres target. The CLI entry point loads the target manifest from `packs/manifest.json` and exports it as a `TargetDescriptor`. The runtime entry point will provide target-specific runtime functionality in the future.
+
+## Dependencies
+
+- **`@prisma-next/cli`**: CLI descriptor types (`TargetDescriptor`, `ExtensionPackManifest`)
+- **`arktype`**: Runtime validation
+
+**Dependents:**
+- CLI configuration files import this package to register the Postgres target
+
+## Exports
+
+- `./cli`: Migration entry point for `TargetDescriptor`
+- `./runtime`: Runtime entry point for target-specific runtime code (future)
+

package/dist/exports/control.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Specifies how to import TypeScript types from a package.
+ * Used in extension pack manifests to declare codec and operation type imports.
+ */
+interface TypesImportSpec {
+    readonly package: string;
+    readonly named: string;
+    readonly alias: string;
+}
+type ArgSpecManifest = {
+    readonly kind: 'typeId';
+    readonly type: string;
+} | {
+    readonly kind: 'param';
+} | {
+    readonly kind: 'literal';
+};
+type ReturnSpecManifest = {
+    readonly kind: 'typeId';
+    readonly type: string;
+} | {
+    readonly kind: 'builtin';
+    readonly type: 'number' | 'boolean' | 'string';
+};
+interface LoweringSpecManifest {
+    readonly targetFamily: 'sql';
+    readonly strategy: 'infix' | 'function';
+    readonly template: string;
+}
+interface OperationManifest {
+    readonly for: string;
+    readonly method: string;
+    readonly args: ReadonlyArray<ArgSpecManifest>;
+    readonly returns: ReturnSpecManifest;
+    readonly lowering: LoweringSpecManifest;
+    readonly capabilities?: ReadonlyArray<string>;
+}
+interface ExtensionPackManifest {
+    readonly id: string;
+    readonly version: string;
+    readonly targets?: Record<string, {
+        readonly minVersion?: string;
+    }>;
+    readonly capabilities?: Record<string, unknown>;
+    readonly types?: {
+        readonly codecTypes?: {
+            readonly import: TypesImportSpec;
+        };
+        readonly operationTypes?: {
+            readonly import: TypesImportSpec;
+        };
+        readonly storage?: readonly {
+            readonly typeId: string;
+            readonly familyId: string;
+            readonly targetId: string;
+            readonly nativeType?: string;
+        }[];
+    };
+    readonly operations?: ReadonlyArray<OperationManifest>;
+}
+
+/**
+ * Base interface for control-plane target instances.
+ *
+ * @template TFamilyId - The family ID (e.g., 'sql', 'document')
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ */
+interface ControlTargetInstance<TFamilyId extends string = string, TTargetId extends string = string> {
+    readonly familyId: TFamilyId;
+    readonly targetId: TTargetId;
+}
+/**
+ * Descriptor for a control-plane target pack (e.g., Postgres target).
+ *
+ * @template TFamilyId - The family ID (e.g., 'sql', 'document')
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ * @template TTargetInstance - The target instance type
+ */
+interface ControlTargetDescriptor<TFamilyId extends string, TTargetId extends string, TTargetInstance extends ControlTargetInstance<TFamilyId, TTargetId> = ControlTargetInstance<TFamilyId, TTargetId>> {
+    readonly kind: 'target';
+    readonly id: string;
+    readonly familyId: TFamilyId;
+    readonly targetId: TTargetId;
+    readonly manifest: ExtensionPackManifest;
+    create(): TTargetInstance;
+}
+
+/**
+ * Postgres target descriptor for CLI config.
+ */
+declare const postgresTargetDescriptor: ControlTargetDescriptor<'sql', 'postgres', ControlTargetInstance<'sql', 'postgres'>>;
+
+export { postgresTargetDescriptor as default };

package/dist/exports/control.js

@@ -0,0 +1,55 @@
+// src/exports/control.ts
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { type } from "arktype";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname(__filename);
+var TypesImportSpecSchema = type({
+  package: "string",
+  named: "string",
+  alias: "string"
+});
+var ExtensionPackManifestSchema = type({
+  id: "string",
+  version: "string",
+  "targets?": type({ "[string]": type({ "minVersion?": "string" }) }),
+  "capabilities?": "Record<string, unknown>",
+  "types?": type({
+    "codecTypes?": type({
+      import: TypesImportSpecSchema
+    }),
+    "operationTypes?": type({
+      import: TypesImportSpecSchema
+    })
+  }),
+  "operations?": "unknown[]"
+});
+function loadTargetManifest() {
+  const manifestPath = join(__dirname, "../../packs/manifest.json");
+  const manifestJson = JSON.parse(readFileSync(manifestPath, "utf-8"));
+  const result = ExtensionPackManifestSchema(manifestJson);
+  if (result instanceof type.errors) {
+    const messages = result.map((p) => p.message).join("; ");
+    throw new Error(`Invalid target manifest structure at ${manifestPath}: ${messages}`);
+  }
+  return result;
+}
+var postgresTargetDescriptor = {
+  kind: "target",
+  familyId: "sql",
+  targetId: "postgres",
+  id: "postgres",
+  manifest: loadTargetManifest(),
+  create() {
+    return {
+      familyId: "sql",
+      targetId: "postgres"
+    };
+  }
+};
+var control_default = postgresTargetDescriptor;
+export {
+  control_default as default
+};
+//# sourceMappingURL=control.js.map

package/dist/exports/control.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/exports/control.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { ExtensionPackManifest } from '@prisma-next/contract/pack-manifest-types';\nimport type {\n  ControlTargetDescriptor,\n  ControlTargetInstance,\n} from '@prisma-next/core-control-plane/types';\nimport { type } from 'arktype';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\nconst TypesImportSpecSchema = type({\n  package: 'string',\n  named: 'string',\n  alias: 'string',\n});\n\nconst ExtensionPackManifestSchema = type({\n  id: 'string',\n  version: 'string',\n  'targets?': type({ '[string]': type({ 'minVersion?': 'string' }) }),\n  'capabilities?': 'Record<string, unknown>',\n  'types?': type({\n    'codecTypes?': type({\n      import: TypesImportSpecSchema,\n    }),\n    'operationTypes?': type({\n      import: TypesImportSpecSchema,\n    }),\n  }),\n  'operations?': 'unknown[]',\n});\n\n/**\n * Loads the target manifest from packs/manifest.json.\n */\nfunction loadTargetManifest(): ExtensionPackManifest {\n  const manifestPath = join(__dirname, '../../packs/manifest.json');\n  const manifestJson = JSON.parse(readFileSync(manifestPath, 'utf-8'));\n\n  const result = ExtensionPackManifestSchema(manifestJson);\n  if (result instanceof type.errors) {\n    const messages = result.map((p: { message: string }) => p.message).join('; ');\n    throw new Error(`Invalid target manifest structure at ${manifestPath}: ${messages}`);\n  }\n\n  return result as ExtensionPackManifest;\n}\n\n/**\n * Postgres target descriptor for CLI config.\n */\nconst postgresTargetDescriptor: ControlTargetDescriptor<\n  'sql',\n  'postgres',\n  ControlTargetInstance<'sql', 'postgres'>\n> = {\n  kind: 'target',\n  familyId: 'sql',\n  targetId: 'postgres',\n  id: 'postgres',\n  manifest: loadTargetManifest(),\n  create(): ControlTargetInstance<'sql', 'postgres'> {\n    return {\n      familyId: 'sql',\n      targetId: 'postgres',\n    };\n  },\n};\n\nexport default postgresTargetDescriptor;\n"],"mappings":";AAAA,SAAS,oBAAoB;AAC7B,SAAS,SAAS,YAAY;AAC9B,SAAS,qBAAqB;AAM9B,SAAS,YAAY;AAErB,IAAM,aAAa,cAAc,YAAY,GAAG;AAChD,IAAM,YAAY,QAAQ,UAAU;AAEpC,IAAM,wBAAwB,KAAK;AAAA,EACjC,SAAS;AAAA,EACT,OAAO;AAAA,EACP,OAAO;AACT,CAAC;AAED,IAAM,8BAA8B,KAAK;AAAA,EACvC,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,YAAY,KAAK,EAAE,YAAY,KAAK,EAAE,eAAe,SAAS,CAAC,EAAE,CAAC;AAAA,EAClE,iBAAiB;AAAA,EACjB,UAAU,KAAK;AAAA,IACb,eAAe,KAAK;AAAA,MAClB,QAAQ;AAAA,IACV,CAAC;AAAA,IACD,mBAAmB,KAAK;AAAA,MACtB,QAAQ;AAAA,IACV,CAAC;AAAA,EACH,CAAC;AAAA,EACD,eAAe;AACjB,CAAC;AAKD,SAAS,qBAA4C;AACnD,QAAM,eAAe,KAAK,WAAW,2BAA2B;AAChE,QAAM,eAAe,KAAK,MAAM,aAAa,cAAc,OAAO,CAAC;AAEnE,QAAM,SAAS,4BAA4B,YAAY;AACvD,MAAI,kBAAkB,KAAK,QAAQ;AACjC,UAAM,WAAW,OAAO,IAAI,CAAC,MAA2B,EAAE,OAAO,EAAE,KAAK,IAAI;AAC5E,UAAM,IAAI,MAAM,wCAAwC,YAAY,KAAK,QAAQ,EAAE;AAAA,EACrF;AAEA,SAAO;AACT;AAKA,IAAM,2BAIF;AAAA,EACF,MAAM;AAAA,EACN,UAAU;AAAA,EACV,UAAU;AAAA,EACV,IAAI;AAAA,EACJ,UAAU,mBAAmB;AAAA,EAC7B,SAAmD;AACjD,WAAO;AAAA,MACL,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,EACF;AACF;AAEA,IAAO,kBAAQ;","names":[]}

package/dist/exports/runtime.d.ts

@@ -0,0 +1,13 @@
+import { RuntimeTargetDescriptor, RuntimeTargetInstance } from '@prisma-next/core-execution-plane/types';
+
+/**
+ * Postgres runtime target instance interface.
+ */
+interface PostgresRuntimeTargetInstance extends RuntimeTargetInstance<'sql', 'postgres'> {
+}
+/**
+ * Postgres target descriptor for runtime plane.
+ */
+declare const postgresRuntimeTargetDescriptor: RuntimeTargetDescriptor<'sql', 'postgres', PostgresRuntimeTargetInstance>;
+
+export { type PostgresRuntimeTargetInstance, postgresRuntimeTargetDescriptor as default };

package/dist/exports/runtime.js

@@ -0,0 +1,55 @@
+// src/exports/runtime.ts
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { type } from "arktype";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname(__filename);
+var TypesImportSpecSchema = type({
+  package: "string",
+  named: "string",
+  alias: "string"
+});
+var ExtensionPackManifestSchema = type({
+  id: "string",
+  version: "string",
+  "targets?": type({ "[string]": type({ "minVersion?": "string" }) }),
+  "capabilities?": "Record<string, unknown>",
+  "types?": type({
+    "codecTypes?": type({
+      import: TypesImportSpecSchema
+    }),
+    "operationTypes?": type({
+      import: TypesImportSpecSchema
+    })
+  }),
+  "operations?": "unknown[]"
+});
+function loadTargetManifest() {
+  const manifestPath = join(__dirname, "../../packs/manifest.json");
+  const manifestJson = JSON.parse(readFileSync(manifestPath, "utf-8"));
+  const result = ExtensionPackManifestSchema(manifestJson);
+  if (result instanceof type.errors) {
+    const messages = result.map((p) => p.message).join("; ");
+    throw new Error(`Invalid target manifest structure at ${manifestPath}: ${messages}`);
+  }
+  return result;
+}
+var postgresRuntimeTargetDescriptor = {
+  kind: "target",
+  familyId: "sql",
+  targetId: "postgres",
+  id: "postgres",
+  manifest: loadTargetManifest(),
+  create() {
+    return {
+      familyId: "sql",
+      targetId: "postgres"
+    };
+  }
+};
+var runtime_default = postgresRuntimeTargetDescriptor;
+export {
+  runtime_default as default
+};
+//# sourceMappingURL=runtime.js.map

package/dist/exports/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/exports/runtime.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { ExtensionPackManifest } from '@prisma-next/contract/pack-manifest-types';\nimport type {\n  RuntimeTargetDescriptor,\n  RuntimeTargetInstance,\n} from '@prisma-next/core-execution-plane/types';\nimport { type } from 'arktype';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\nconst TypesImportSpecSchema = type({\n  package: 'string',\n  named: 'string',\n  alias: 'string',\n});\n\nconst ExtensionPackManifestSchema = type({\n  id: 'string',\n  version: 'string',\n  'targets?': type({ '[string]': type({ 'minVersion?': 'string' }) }),\n  'capabilities?': 'Record<string, unknown>',\n  'types?': type({\n    'codecTypes?': type({\n      import: TypesImportSpecSchema,\n    }),\n    'operationTypes?': type({\n      import: TypesImportSpecSchema,\n    }),\n  }),\n  'operations?': 'unknown[]',\n});\n\n/**\n * Loads the target manifest from packs/manifest.json.\n */\nfunction loadTargetManifest(): ExtensionPackManifest {\n  const manifestPath = join(__dirname, '../../packs/manifest.json');\n  const manifestJson = JSON.parse(readFileSync(manifestPath, 'utf-8'));\n\n  const result = ExtensionPackManifestSchema(manifestJson);\n  if (result instanceof type.errors) {\n    const messages = result.map((p: { message: string }) => p.message).join('; ');\n    throw new Error(`Invalid target manifest structure at ${manifestPath}: ${messages}`);\n  }\n\n  return result as ExtensionPackManifest;\n}\n\n/**\n * Postgres runtime target instance interface.\n */\nexport interface PostgresRuntimeTargetInstance extends RuntimeTargetInstance<'sql', 'postgres'> {}\n\n/**\n * Postgres target descriptor for runtime plane.\n */\nconst postgresRuntimeTargetDescriptor: RuntimeTargetDescriptor<\n  'sql',\n  'postgres',\n  PostgresRuntimeTargetInstance\n> = {\n  kind: 'target',\n  familyId: 'sql',\n  targetId: 'postgres',\n  id: 'postgres',\n  manifest: loadTargetManifest(),\n  create(): PostgresRuntimeTargetInstance {\n    return {\n      familyId: 'sql',\n      targetId: 'postgres',\n    };\n  },\n};\n\nexport default postgresRuntimeTargetDescriptor;\n"],"mappings":";AAAA,SAAS,oBAAoB;AAC7B,SAAS,SAAS,YAAY;AAC9B,SAAS,qBAAqB;AAM9B,SAAS,YAAY;AAErB,IAAM,aAAa,cAAc,YAAY,GAAG;AAChD,IAAM,YAAY,QAAQ,UAAU;AAEpC,IAAM,wBAAwB,KAAK;AAAA,EACjC,SAAS;AAAA,EACT,OAAO;AAAA,EACP,OAAO;AACT,CAAC;AAED,IAAM,8BAA8B,KAAK;AAAA,EACvC,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,YAAY,KAAK,EAAE,YAAY,KAAK,EAAE,eAAe,SAAS,CAAC,EAAE,CAAC;AAAA,EAClE,iBAAiB;AAAA,EACjB,UAAU,KAAK;AAAA,IACb,eAAe,KAAK;AAAA,MAClB,QAAQ;AAAA,IACV,CAAC;AAAA,IACD,mBAAmB,KAAK;AAAA,MACtB,QAAQ;AAAA,IACV,CAAC;AAAA,EACH,CAAC;AAAA,EACD,eAAe;AACjB,CAAC;AAKD,SAAS,qBAA4C;AACnD,QAAM,eAAe,KAAK,WAAW,2BAA2B;AAChE,QAAM,eAAe,KAAK,MAAM,aAAa,cAAc,OAAO,CAAC;AAEnE,QAAM,SAAS,4BAA4B,YAAY;AACvD,MAAI,kBAAkB,KAAK,QAAQ;AACjC,UAAM,WAAW,OAAO,IAAI,CAAC,MAA2B,EAAE,OAAO,EAAE,KAAK,IAAI;AAC5E,UAAM,IAAI,MAAM,wCAAwC,YAAY,KAAK,QAAQ,EAAE;AAAA,EACrF;AAEA,SAAO;AACT;AAUA,IAAM,kCAIF;AAAA,EACF,MAAM;AAAA,EACN,UAAU;AAAA,EACV,UAAU;AAAA,EACV,IAAI;AAAA,EACJ,UAAU,mBAAmB;AAAA,EAC7B,SAAwC;AACtC,WAAO;AAAA,MACL,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,EACF;AACF;AAEA,IAAO,kBAAQ;","names":[]}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@prisma-next/targets-postgres",
+  "version": "0.0.1",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Postgres target pack for Prisma Next",
+  "dependencies": {
+    "arktype": "^2.0.0",
+    "@prisma-next/core-execution-plane": "0.0.1",
+    "@prisma-next/cli": "0.0.1"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.0",
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.1",
+    "@prisma-next/test-utils": "0.0.1"
+  },
+  "files": [
+    "dist",
+    "packs"
+  ],
+  "exports": {
+    "./control": {
+      "types": "./dist/exports/control.d.ts",
+      "import": "./dist/exports/control.js"
+    },
+    "./runtime": {
+      "types": "./dist/exports/runtime.d.ts",
+      "import": "./dist/exports/runtime.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts",
+    "test": "vitest run --passWithNoTests",
+    "test:coverage": "vitest run --coverage --passWithNoTests",
+    "typecheck": "tsc --project tsconfig.json --noEmit",
+    "lint": "biome check . --config-path ../../../biome.json --error-on-warnings",
+    "clean": "node ../../../scripts/clean.mjs"
+  }
+}

package/packs/manifest.json

@@ -0,0 +1,10 @@
+{
+  "id": "postgres",
+  "version": "15.0.0",
+  "targets": {
+    "postgres": {
+      "minVersion": "12"
+    }
+  },
+  "capabilities": {}
+}