prisma-ltree 0.4.0 → 0.6.0

package/src/contract.d.ts

@@ -1,46 +1,36 @@
 // ⚠️  GENERATED FILE - DO NOT EDIT
 // This file is automatically generated by 'prisma contract emit'.
 // To regenerate, run: prisma contract emit
-import type { QueryOperationTypes as PgAdapterQueryOps } from '@prisma/orm-postgres/adapter/operation-types';
 import type {
-  Bit,
-  Char,
   CodecTypes as PgTypes,
-  Interval,
-  JsonValue,
-  Numeric,
-  Time,
-  TimeString,
-  Timestamp,
-  TimestampString,
-  Timestamptz,
-  TimestamptzString,
-  Timetz,
-  VarBit,
-  Varchar,
+  ParameterizedOutputTypesForTypeParams as PgParameterizedOutputTypes,
 } from '@prisma/orm-postgres/target/codec-types';
+import type { QueryOperationTypes as PgTargetQueryOps } from '@prisma/orm-postgres/target/operation-types';
 
 import type {
+  ColumnTypesFromStorage,
   ContractWithTypeMaps,
+  RelationKeys,
   TypeMaps as TypeMapsType,
 } from '@prisma/orm-postgres/family-contract/types';
 import type {
   Contract as ContractType,
   ExecutionHashBase,
+  FieldTypesFromDomain,
   NamespaceId,
   ProfileHashBase,
   StorageHashBase,
 } from '@prisma/orm-postgres/contract/types';
 
 export type StorageHash =
-  StorageHashBase<'ca70941530ea2af306b38e95be66ab1deac79357bcfafb48302d07c8f2c9aa92'>;
+  StorageHashBase<'6db18d99f118ef4e7fd359cf8bc472b9335bf3edeeefa8a15ee11eaf7742f9fb'>;
 export type ExecutionHash = ExecutionHashBase<string>;
 export type ProfileHash =
   ProfileHashBase<'3916f444a8a17ad749191acf9e08dad97d1a327b88c2f1d45d12f240296aa8b2'>;
 
 export type CodecTypes = PgTypes;
 export type LaneCodecTypes = CodecTypes;
-export type QueryOperationTypes = PgAdapterQueryOps<CodecTypes>;
+export type QueryOperationTypes = PgTargetQueryOps<CodecTypes>;
 export type AggregateTypes = {
   readonly avg: {
     readonly byCodec: {
@@ -52,6 +42,10 @@ export type AggregateTypes = {
       readonly 'pg/int4@1': { readonly output: 'pg/float8@1'; readonly nullable: true };
       readonly 'pg/int8@1': { readonly output: 'pg/float8@1'; readonly nullable: true };
       readonly 'pg/int8number@1': { readonly output: 'pg/float8@1'; readonly nullable: true };
+      readonly 'pg/interval-string@1': {
+        readonly output: 'pg/interval-string@1';
+        readonly nullable: true;
+      };
       readonly 'pg/interval@1': { readonly output: 'pg/interval@1'; readonly nullable: true };
       readonly 'pg/numeric@1': { readonly output: 'pg/numeric@1'; readonly nullable: true };
       readonly 'pg/time-string@1': { readonly output: 'pg/interval@1'; readonly nullable: true };
@@ -101,8 +95,14 @@ export type AggregateTypes = {
       readonly 'pg/int4@1': { readonly output: 'pg/int4@1'; readonly nullable: true };
       readonly 'pg/int8@1': { readonly output: 'pg/int8@1'; readonly nullable: true };
       readonly 'pg/int8number@1': { readonly output: 'pg/int8number@1'; readonly nullable: true };
+      readonly 'pg/interval-string@1': {
+        readonly output: 'pg/interval-string@1';
+        readonly nullable: true;
+      };
       readonly 'pg/interval@1': { readonly output: 'pg/interval@1'; readonly nullable: true };
+      readonly 'pg/money@1': { readonly output: 'pg/money@1'; readonly nullable: true };
       readonly 'pg/numeric@1': { readonly output: 'pg/numeric@1'; readonly nullable: true };
+      readonly 'pg/oid@1': { readonly output: 'pg/oid@1'; readonly nullable: true };
       readonly 'pg/text-array@1': { readonly output: 'pg/text-array@1'; readonly nullable: true };
       readonly 'pg/text@1': { readonly output: 'pg/text@1'; readonly nullable: true };
       readonly 'pg/time-string@1': { readonly output: 'pg/time-string@1'; readonly nullable: true };
@@ -110,6 +110,14 @@ export type AggregateTypes = {
         readonly output: 'pg/time-temporal@1';
         readonly nullable: true;
       };
+      readonly 'pg/timestamp-date@1': {
+        readonly output: 'pg/timestamp-date@1';
+        readonly nullable: true;
+      };
+      readonly 'pg/timestamp-instant@1': {
+        readonly output: 'pg/timestamp-instant@1';
+        readonly nullable: true;
+      };
       readonly 'pg/timestamp-string@1': {
         readonly output: 'pg/timestamp-string@1';
         readonly nullable: true;
@@ -118,6 +126,10 @@ export type AggregateTypes = {
         readonly output: 'pg/timestamp-temporal@1';
         readonly nullable: true;
       };
+      readonly 'pg/timestamptz-date@1': {
+        readonly output: 'pg/timestamptz-date@1';
+        readonly nullable: true;
+      };
       readonly 'pg/timestamptz-string@1': {
         readonly output: 'pg/timestamptz-string@1';
         readonly nullable: true;
@@ -157,8 +169,14 @@ export type AggregateTypes = {
       readonly 'pg/int4@1': { readonly output: 'pg/int4@1'; readonly nullable: true };
       readonly 'pg/int8@1': { readonly output: 'pg/int8@1'; readonly nullable: true };
       readonly 'pg/int8number@1': { readonly output: 'pg/int8number@1'; readonly nullable: true };
+      readonly 'pg/interval-string@1': {
+        readonly output: 'pg/interval-string@1';
+        readonly nullable: true;
+      };
       readonly 'pg/interval@1': { readonly output: 'pg/interval@1'; readonly nullable: true };
+      readonly 'pg/money@1': { readonly output: 'pg/money@1'; readonly nullable: true };
       readonly 'pg/numeric@1': { readonly output: 'pg/numeric@1'; readonly nullable: true };
+      readonly 'pg/oid@1': { readonly output: 'pg/oid@1'; readonly nullable: true };
       readonly 'pg/text-array@1': { readonly output: 'pg/text-array@1'; readonly nullable: true };
       readonly 'pg/text@1': { readonly output: 'pg/text@1'; readonly nullable: true };
       readonly 'pg/time-string@1': { readonly output: 'pg/time-string@1'; readonly nullable: true };
@@ -166,6 +184,14 @@ export type AggregateTypes = {
         readonly output: 'pg/time-temporal@1';
         readonly nullable: true;
       };
+      readonly 'pg/timestamp-date@1': {
+        readonly output: 'pg/timestamp-date@1';
+        readonly nullable: true;
+      };
+      readonly 'pg/timestamp-instant@1': {
+        readonly output: 'pg/timestamp-instant@1';
+        readonly nullable: true;
+      };
       readonly 'pg/timestamp-string@1': {
         readonly output: 'pg/timestamp-string@1';
         readonly nullable: true;
@@ -174,6 +200,10 @@ export type AggregateTypes = {
         readonly output: 'pg/timestamp-temporal@1';
         readonly nullable: true;
       };
+      readonly 'pg/timestamptz-date@1': {
+        readonly output: 'pg/timestamptz-date@1';
+        readonly nullable: true;
+      };
       readonly 'pg/timestamptz-string@1': {
         readonly output: 'pg/timestamptz-string@1';
         readonly nullable: true;
@@ -205,7 +235,12 @@ export type AggregateTypes = {
       readonly 'pg/int4@1': { readonly output: 'pg/int8number@1'; readonly nullable: true };
       readonly 'pg/int8@1': { readonly output: 'pg/int8number@1'; readonly nullable: true };
       readonly 'pg/int8number@1': { readonly output: 'pg/int8number@1'; readonly nullable: true };
+      readonly 'pg/interval-string@1': {
+        readonly output: 'pg/interval-string@1';
+        readonly nullable: true;
+      };
       readonly 'pg/interval@1': { readonly output: 'pg/interval@1'; readonly nullable: true };
+      readonly 'pg/money@1': { readonly output: 'pg/money@1'; readonly nullable: true };
       readonly 'pg/numeric@1': { readonly output: 'pg/numeric@1'; readonly nullable: true };
       readonly 'pg/time-string@1': { readonly output: 'pg/interval@1'; readonly nullable: true };
       readonly 'pg/time-temporal@1': { readonly output: 'pg/interval@1'; readonly nullable: true };
@@ -237,11 +272,47 @@ type DefaultLiteralValue<CodecId extends string, Encoded> = CodecId extends keyo
     ? Encoded
     : CodecTypes[CodecId]['json']
   : Encoded;
+type ParameterizedOutputTypeFunctions = PgParameterizedOutputTypes;
+
+type FieldTypeOverrides = {};
+export type FieldOutputTypes = FieldTypesFromDomain<
+  ContractBase['domain']['namespaces'],
+  CodecTypes,
+  ParameterizedOutputTypeFunctions,
+  FieldTypeOverrides,
+  'output',
+  ContractBase['storage']['namespaces']
+>;
+export type FieldInputTypes = FieldTypesFromDomain<
+  ContractBase['domain']['namespaces'],
+  CodecTypes,
+  ParameterizedOutputTypeFunctions,
+  FieldTypeOverrides,
+  'input',
+  ContractBase['storage']['namespaces']
+>;
+type ColumnTypeOverrides = {};
+export type StorageColumnTypes = ColumnTypesFromStorage<
+  ContractBase['storage'],
+  CodecTypes,
+  ParameterizedOutputTypeFunctions,
+  ColumnTypeOverrides,
+  'output'
+>;
+export type StorageColumnInputTypes = ColumnTypesFromStorage<
+  ContractBase['storage'],
+  CodecTypes,
+  ParameterizedOutputTypeFunctions,
+  ColumnTypeOverrides,
+  'input'
+>;
+
+export namespace Models {}
+
+export declare const models: {
+  public: {};
+};
 
-export type FieldOutputTypes = { readonly public: Record<string, never> };
-export type FieldInputTypes = { readonly public: Record<string, never> };
-export type StorageColumnTypes = { readonly public: {} };
-export type StorageColumnInputTypes = { readonly public: {} };
 export type TypeMaps = TypeMapsType<
   CodecTypes,
   QueryOperationTypes,
@@ -255,6 +326,11 @@ export type TypeMaps = TypeMapsType<
 type ContractBase = Omit<
   ContractType<{
     readonly namespaces: {
+      readonly __unbound__: {
+        readonly id: '__unbound__';
+        readonly kind: 'postgres-unbound-schema';
+        readonly entries: { readonly table: {} };
+      };
       readonly public: {
         readonly id: 'public';
         readonly kind: 'postgres-schema';
@@ -265,13 +341,13 @@ type ContractBase = Omit<
       readonly ltree: {
         readonly kind: 'codec-instance';
         readonly codecId: 'pg/ltree@1';
-        readonly nativeType: 'ltree';
+        readonly dataType: 'ltree/ltree';
         readonly typeParams: Record<string, never>;
       };
       readonly ltreeArray: {
         readonly kind: 'codec-instance';
         readonly codecId: 'pg/ltree-array@1';
-        readonly nativeType: 'ltree[]';
+        readonly dataType: 'ltree/ltree-array';
         readonly typeParams: Record<string, never>;
       };
     };
@@ -292,6 +368,8 @@ type ContractBase = Omit<
   readonly capabilities: {
     readonly postgres: {
       readonly distinctOn: true;
+      readonly forKeyShare: true;
+      readonly forNoKeyUpdate: true;
       readonly jsonAgg: true;
       readonly lateral: true;
       readonly limit: true;
@@ -302,14 +380,21 @@ type ContractBase = Omit<
       readonly checkConstraint: true;
       readonly defaultInInsert: true;
       readonly enums: true;
+      readonly forShare: true;
+      readonly forUpdate: true;
+      readonly insertOnConflictSkip: true;
+      readonly insertOnConflictTarget: true;
+      readonly insertOnConflictWithoutTarget: true;
       readonly lateral: true;
+      readonly lockNowait: true;
+      readonly lockOf: true;
+      readonly lockSkipLocked: true;
       readonly returning: true;
       readonly scalarList: true;
     };
   };
   readonly extensions: {};
   readonly meta: {};
-
   readonly profileHash: ProfileHash;
 };
 

package/src/contract.json

@@ -13,6 +13,19 @@
   },
   "storage": {
     "namespaces": {
+      "__unbound__": {
+        "entries": {
+          "extension": {
+            "ltree": {
+              "kind": "extension",
+              "name": "ltree"
+            }
+          },
+          "table": {}
+        },
+        "id": "__unbound__",
+        "kind": "postgres-unbound-schema"
+      },
       "public": {
         "entries": {
           "table": {}
@@ -21,23 +34,25 @@
         "kind": "postgres-schema"
       }
     },
-    "storageHash": "ca70941530ea2af306b38e95be66ab1deac79357bcfafb48302d07c8f2c9aa92",
+    "storageHash": "6db18d99f118ef4e7fd359cf8bc472b9335bf3edeeefa8a15ee11eaf7742f9fb",
     "types": {
       "ltree": {
         "codecId": "pg/ltree@1",
-        "kind": "codec-instance",
-        "nativeType": "ltree"
+        "dataType": "ltree/ltree",
+        "kind": "codec-instance"
       },
       "ltreeArray": {
         "codecId": "pg/ltree-array@1",
-        "kind": "codec-instance",
-        "nativeType": "ltree[]"
+        "dataType": "ltree/ltree-array",
+        "kind": "codec-instance"
       }
     }
   },
   "capabilities": {
     "postgres": {
       "distinctOn": true,
+      "forKeyShare": true,
+      "forNoKeyUpdate": true,
       "jsonAgg": true,
       "lateral": true,
       "limit": true,
@@ -48,7 +63,15 @@
       "checkConstraint": true,
       "defaultInInsert": true,
       "enums": true,
+      "forShare": true,
+      "forUpdate": true,
+      "insertOnConflictSkip": true,
+      "insertOnConflictTarget": true,
+      "insertOnConflictWithoutTarget": true,
       "lateral": true,
+      "lockNowait": true,
+      "lockOf": true,
+      "lockSkipLocked": true,
       "returning": true,
       "scalarList": true
     }

package/src/contract.ts

@@ -1,27 +1,39 @@
-import { defineContract } from "@prisma/orm-postgres/contract-builder";
+import { assembleDataTypes } from "@prisma/orm-framework/components/codec";
+import { defineContract, extension, unbound } from "@prisma/orm-postgres/contract-builder";
+import { assemblePostgresCodecRegistryWithBuiltins } from "@prisma/orm-target-postgres/target/codecs";
+import { postgresDataTypes } from "@prisma/orm-target-postgres/target/data-types";
+import type { Temporal } from "temporal-spec";
 import { LTREE_ARRAY_CODEC_ID, LTREE_CODEC_ID } from "./core/constants";
-import {
-  LTREE_ARRAY_STORAGE_TYPE,
-  LTREE_ARRAY_NATIVE_TYPE,
-  LTREE_NATIVE_TYPE,
-} from "./core/contract-space-constants";
+import { LTREE_ARRAY_STORAGE_TYPE, LTREE_NATIVE_TYPE } from "./core/contract-space-constants";
+import { codecDescriptors } from "./core/codecs";
+import { ltreeDataTypes } from "./core/data-types";
 
-export const contract = defineContract({}, () => ({
-  types: {
+export type { Temporal };
+
+const dataTypeLookup = assembleDataTypes([
+  { id: "postgres", dataTypes: postgresDataTypes },
+  { id: "ltree", dataTypes: ltreeDataTypes },
+]).lookup;
+const codecLookup = assemblePostgresCodecRegistryWithBuiltins(
+  [{ types: { codecTypes: { codecDescriptors: [...codecDescriptors] } } }],
+  dataTypeLookup,
+);
+
+export const contract = defineContract({ codecLookup, dataTypeLookup }, () => ({
+  databaseTypes: {
     [LTREE_NATIVE_TYPE]: {
       kind: "codec-instance",
       codecId: LTREE_CODEC_ID,
-      nativeType: LTREE_NATIVE_TYPE,
       typeParams: {},
     },
     [LTREE_ARRAY_STORAGE_TYPE]: {
       kind: "codec-instance",
       codecId: LTREE_ARRAY_CODEC_ID,
-      nativeType: LTREE_ARRAY_NATIVE_TYPE,
       typeParams: {},
     },
   },
   models: {},
+  entities: [extension("ltree", { namespace: unbound })],
 }));
 
 export default contract;

package/src/core/authoring.ts

@@ -1,21 +1,20 @@
 import type { AuthoringTypeNamespace } from "@prisma/orm-framework/components/authoring";
 import { LTREE_ARRAY_CODEC_ID, LTREE_CODEC_ID } from "./constants";
-import { LTREE_ARRAY_NATIVE_TYPE, LTREE_NATIVE_TYPE } from "./contract-space-constants";
 
 export const ltreeAuthoringTypes = {
   ltree: {
     Ltree: {
       kind: "typeConstructor",
+      inferred: true,
       output: {
         codecId: LTREE_CODEC_ID,
-        nativeType: LTREE_NATIVE_TYPE,
       },
     },
     LtreeArray: {
       kind: "typeConstructor",
+      inferred: true,
       output: {
         codecId: LTREE_ARRAY_CODEC_ID,
-        nativeType: LTREE_ARRAY_NATIVE_TYPE,
       },
     },
   },

package/src/core/codecs-validation.ts

@@ -0,0 +1,31 @@
+import { LTREE_MAX_LABEL_LENGTH, LTREE_MAX_LABELS } from "./constants";
+
+const LABEL_PATTERN = /^[A-Za-z0-9_-]+$/;
+
+export function assertValidLtree(value: unknown): asserts value is string {
+  if (typeof value !== "string") {
+    throw new Error("ltree value must be a string");
+  }
+  if (value.length === 0) {
+    throw new Error("ltree value must not be empty");
+  }
+  const labels = value.split(".");
+  if (labels.length > LTREE_MAX_LABELS) {
+    throw new Error(`ltree path exceeds max labels: got ${labels.length}, max ${LTREE_MAX_LABELS}`);
+  }
+  for (const label of labels) {
+    if (label.length === 0) {
+      throw new Error(`ltree label must not be empty in path "${value}"`);
+    }
+    if (label.length > LTREE_MAX_LABEL_LENGTH) {
+      throw new Error(
+        `ltree label exceeds max length: got ${label.length}, max ${LTREE_MAX_LABEL_LENGTH}`,
+      );
+    }
+    if (!LABEL_PATTERN.test(label)) {
+      throw new Error(
+        `ltree label "${label}" contains invalid characters; allowed: alphanumeric, underscore, hyphen`,
+      );
+    }
+  }
+}

package/src/core/codecs.ts

@@ -1,56 +1,24 @@
-import type { JsonValue } from "@prisma/orm-framework/contract/types";
 import {
+  type AnyCodecDescriptor,
   type CodecCallContext,
   CodecImpl,
   type CodecInstanceContext,
   type ColumnHelperFor,
   type ColumnHelperForStrict,
   column,
-  voidParamsSchema,
+  type DataTypeValue,
 } from "@prisma/orm-framework/components/codec";
 import type { ExtractCodecTypes, ProjectionExpr } from "@prisma/orm-family-sql/relational-core/ast";
+import { CastExpr } from "@prisma/orm-family-sql/relational-core/ast";
 import {
   definePostgresCodecs,
   PostgresCodecDescriptor,
 } from "@prisma/orm-target-postgres/target/codec-descriptor";
-import type { StandardSchemaV1 } from "@standard-schema/spec";
-import {
-  LTREE_ARRAY_CODEC_ID,
-  LTREE_CODEC_ID,
-  LTREE_MAX_LABEL_LENGTH,
-  LTREE_MAX_LABELS,
-} from "./constants";
-import { LTREE_ARRAY_NATIVE_TYPE, LTREE_NATIVE_TYPE } from "./contract-space-constants";
-
-const LABEL_PATTERN = /^[A-Za-z0-9_-]+$/;
+import { assertValidLtree } from "./codecs-validation";
+import { LTREE_ARRAY_CODEC_ID, LTREE_CODEC_ID } from "./constants";
+import { ltreeArrayDataType, ltreeDataType } from "./data-types";
 
-export function assertValidLtree(value: unknown): asserts value is string {
-  if (typeof value !== "string") {
-    throw new Error("ltree value must be a string");
-  }
-  if (value.length === 0) {
-    throw new Error("ltree value must not be empty");
-  }
-  const labels = value.split(".");
-  if (labels.length > LTREE_MAX_LABELS) {
-    throw new Error(`ltree path exceeds max labels: got ${labels.length}, max ${LTREE_MAX_LABELS}`);
-  }
-  for (const label of labels) {
-    if (label.length === 0) {
-      throw new Error(`ltree label must not be empty in path "${value}"`);
-    }
-    if (label.length > LTREE_MAX_LABEL_LENGTH) {
-      throw new Error(
-        `ltree label exceeds max length: got ${label.length}, max ${LTREE_MAX_LABEL_LENGTH}`,
-      );
-    }
-    if (!LABEL_PATTERN.test(label)) {
-      throw new Error(
-        `ltree label "${label}" contains invalid characters; allowed: alphanumeric, underscore, hyphen`,
-      );
-    }
-  }
-}
+export { assertValidLtree } from "./codecs-validation";
 
 export class LtreeCodec extends CodecImpl<
   typeof LTREE_CODEC_ID,
@@ -58,38 +26,39 @@ export class LtreeCodec extends CodecImpl<
   string,
   string
 > {
-  async encode(value: string, _ctx: CodecCallContext): Promise<string> {
+  constructor(descriptor: AnyCodecDescriptor) {
+    super(descriptor, ltreeDataType);
+  }
+
+  async toWire(value: string, _ctx: CodecCallContext): Promise<string> {
     assertValidLtree(value);
     return value;
   }
 
-  async decode(wire: string, _ctx: CodecCallContext): Promise<string> {
+  async fromWire(wire: string, _ctx: CodecCallContext): Promise<string> {
     return wire;
   }
 
-  encodeJson(value: string): JsonValue {
+  toDataTypeValue(value: string): DataTypeValue {
     assertValidLtree(value);
-    return value;
+    return this.dataTypeValueOf(value);
   }
 
-  decodeJson(json: JsonValue): string {
-    assertValidLtree(json);
-    return json;
+  fromDataTypeValue(value: DataTypeValue): string {
+    return value.value as string;
   }
 }
 
 export class LtreeDescriptor extends PostgresCodecDescriptor<void> {
-  protected override nativeType(): string {
-    return LTREE_NATIVE_TYPE;
-  }
+  override readonly jsonType = "string" as const;
   protected override jsonProjection(expression: ProjectionExpr): ProjectionExpr {
-    // ltree's text form is already its canonical JSON string.
-    return expression;
+    // JSON projections read through fromWire; cast so the wire value is text.
+    return CastExpr.as(expression, "text");
   }
+  override readonly dataType = ltreeDataType.id;
   override readonly codecId = LTREE_CODEC_ID;
   override readonly traits = ["equality", "order"] as const;
-  override readonly targetTypes = [LTREE_NATIVE_TYPE] as const;
-  override readonly paramsSchema: StandardSchemaV1<void> = voidParamsSchema;
+  override readonly paramsSchema = undefined;
   override renderOutputType(): string {
     return "string";
   }
@@ -101,8 +70,7 @@ export class LtreeDescriptor extends PostgresCodecDescriptor<void> {
 
 export const ltreeDescriptor = new LtreeDescriptor();
 
-export const ltree = () =>
-  column(ltreeDescriptor.factory(), ltreeDescriptor.codecId, undefined, LTREE_NATIVE_TYPE);
+export const ltree = () => column(ltreeDescriptor.factory(), ltreeDescriptor.codecId, undefined);
 
 ltree satisfies ColumnHelperFor<LtreeDescriptor>;
 ltree satisfies ColumnHelperForStrict<LtreeDescriptor>;
@@ -113,47 +81,47 @@ export class LtreeArrayCodec extends CodecImpl<
   readonly string[],
   readonly string[]
 > {
-  async encode(value: readonly string[], _ctx: CodecCallContext): Promise<readonly string[]> {
+  constructor(descriptor: AnyCodecDescriptor) {
+    super(descriptor, ltreeArrayDataType);
+  }
+
+  async toWire(value: readonly string[], _ctx: CodecCallContext): Promise<readonly string[]> {
     for (const entry of value) {
       assertValidLtree(entry);
     }
     return value;
   }
 
-  async decode(wire: readonly string[], _ctx: CodecCallContext): Promise<readonly string[]> {
+  async fromWire(wire: readonly string[], _ctx: CodecCallContext): Promise<readonly string[]> {
     return wire;
   }
 
-  encodeJson(value: readonly string[]): JsonValue {
+  toDataTypeValue(value: readonly string[]): DataTypeValue {
     for (const entry of value) {
       assertValidLtree(entry);
     }
-    return [...value];
+    return this.dataTypeValueOf([...value]);
   }
 
-  decodeJson(json: JsonValue): readonly string[] {
+  fromDataTypeValue(value: DataTypeValue): readonly string[] {
+    const json = value.value;
     if (!Array.isArray(json)) {
       return [];
     }
-    return json.map((entry) => {
-      assertValidLtree(entry);
-      return String(entry);
-    });
+    return json.map((entry) => String(entry));
   }
 }
 
 export class LtreeArrayDescriptor extends PostgresCodecDescriptor<void> {
-  protected override nativeType(): string {
-    return LTREE_ARRAY_NATIVE_TYPE;
-  }
+  override readonly jsonType = "array" as const;
   protected override jsonProjection(expression: ProjectionExpr): ProjectionExpr {
-    // ltree[] text form projects as a JSON string array already.
+    // ltree[] already projects as a JSON string array for fromWire.
     return expression;
   }
+  override readonly dataType = ltreeArrayDataType.id;
   override readonly codecId = LTREE_ARRAY_CODEC_ID;
   override readonly traits = ["equality"] as const;
-  override readonly targetTypes = [LTREE_ARRAY_NATIVE_TYPE] as const;
-  override readonly paramsSchema: StandardSchemaV1<void> = voidParamsSchema;
+  override readonly paramsSchema = undefined;
   override renderOutputType(): string {
     return "readonly string[]";
   }
@@ -166,12 +134,7 @@ export class LtreeArrayDescriptor extends PostgresCodecDescriptor<void> {
 export const ltreeArrayDescriptor = new LtreeArrayDescriptor();
 
 export const ltreeArray = () =>
-  column(
-    ltreeArrayDescriptor.factory(),
-    ltreeArrayDescriptor.codecId,
-    undefined,
-    LTREE_ARRAY_NATIVE_TYPE,
-  );
+  column(ltreeArrayDescriptor.factory(), ltreeArrayDescriptor.codecId, undefined);
 
 ltreeArray satisfies ColumnHelperFor<LtreeArrayDescriptor>;
 ltreeArray satisfies ColumnHelperForStrict<LtreeArrayDescriptor>;

package/src/core/contract-space-constants.ts

@@ -2,13 +2,22 @@ export const LTREE_SPACE_ID = "ltree" as const;
 
 export const LTREE_NATIVE_TYPE = "ltree" as const;
 
-export const LTREE_ARRAY_NATIVE_TYPE = "ltree[]" as const;
-
 /** Contract storage.types key — must be a valid identifier for contract emit. */
 export const LTREE_ARRAY_STORAGE_TYPE = "ltreeArray" as const;
 
 export const LTREE_BASELINE_MIGRATION_NAME = "20260619T2142_install_ltree" as const;
 
+export const LTREE_DECLARE_EXTENSION_MIGRATION_NAME =
+  "20261111T1905_declare_ltree_extension" as const;
+
+export const LTREE_CREATE_EXTENSION_MIGRATION_NAME =
+  "20261111T1904_create_ltree_extension" as const;
+
+export const LTREE_SEARCH_PATH_MIGRATION_NAME = "20261111T1908_find_ltree_on_search_path" as const;
+
+export const LTREE_SEARCH_PATH_INSTALL_MIGRATION_NAME =
+  "20261111T1908_install_ltree_on_search_path" as const;
+
 export const LTREE_INVARIANTS = {
   installLtree: "ltree:install-ltree-v1",
 } as const;