@geoprotocol/grc-20 0.1.0

package/dist/builder/edit.d.ts

@@ -0,0 +1,107 @@
+import type { Id } from "../types/id.js";
+import type { Edit } from "../types/edit.js";
+import type { CreateRelation, Op } from "../types/op.js";
+import { DataType } from "../types/value.js";
+import { EntityBuilder } from "./entity.js";
+import { UpdateEntityBuilder } from "./update.js";
+import { RelationBuilder } from "./relation.js";
+/**
+ * Builder for constructing an Edit with operations.
+ */
+export declare class EditBuilder {
+    private readonly _id;
+    private name;
+    private authors;
+    private createdAt;
+    private ops;
+    constructor(id: Id);
+    /**
+     * Sets the edit name.
+     */
+    setName(name: string): this;
+    /**
+     * Adds an author to the edit.
+     */
+    addAuthor(authorId: Id): this;
+    /**
+     * Sets multiple authors at once.
+     */
+    setAuthors(authorIds: Id[]): this;
+    /**
+     * Sets the creation timestamp (microseconds since Unix epoch).
+     */
+    setCreatedAt(timestamp: bigint): this;
+    /**
+     * Sets the creation timestamp to now.
+     */
+    setCreatedNow(): this;
+    /**
+     * Adds a CreateProperty operation.
+     */
+    createProperty(id: Id, dataType: DataType): this;
+    /**
+     * Adds a CreateEntity operation using a builder function.
+     */
+    createEntity(id: Id, build: (b: EntityBuilder) => EntityBuilder): this;
+    /**
+     * Adds a CreateEntity operation with no values.
+     */
+    createEmptyEntity(id: Id): this;
+    /**
+     * Adds an UpdateEntity operation using a builder function.
+     */
+    updateEntity(id: Id, build: (b: UpdateEntityBuilder) => UpdateEntityBuilder): this;
+    /**
+     * Adds a DeleteEntity operation.
+     */
+    deleteEntity(id: Id): this;
+    /**
+     * Adds a RestoreEntity operation.
+     */
+    restoreEntity(id: Id): this;
+    /**
+     * Adds a CreateRelation operation in unique mode (ID derived from endpoints + type).
+     */
+    createRelationUnique(from: Id, to: Id, relationType: Id): this;
+    /**
+     * Adds a CreateRelation operation in many mode (explicit ID).
+     */
+    createRelationMany(id: Id, from: Id, to: Id, relationType: Id): this;
+    /**
+     * Adds a CreateRelation operation with full control using a builder.
+     */
+    createRelation(build: (b: RelationBuilder) => RelationBuilder): this;
+    /**
+     * Adds a CreateRelation directly.
+     */
+    addRelation(relation: CreateRelation): this;
+    /**
+     * Adds an UpdateRelation operation (can only update position).
+     */
+    updateRelation(id: Id, position?: string): this;
+    /**
+     * Adds a DeleteRelation operation.
+     */
+    deleteRelation(id: Id): this;
+    /**
+     * Adds a RestoreRelation operation.
+     */
+    restoreRelation(id: Id): this;
+    /**
+     * Adds a raw operation directly.
+     */
+    addOp(op: Op): this;
+    /**
+     * Adds multiple raw operations.
+     */
+    addOps(ops: Op[]): this;
+    /**
+     * Returns the number of operations added so far.
+     */
+    opCount(): number;
+    /**
+     * Builds the final Edit.
+     */
+    build(): Edit;
+}
+//# sourceMappingURL=edit.d.ts.map

package/dist/builder/edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../src/builder/edit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EACV,cAAc,EACd,EAAE,EACH,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAK;IACzB,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,GAAG,CAAY;gBAEX,EAAE,EAAE,EAAE;IAIlB;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,EAAE,GAAG,IAAI;IAK7B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,EAAE,EAAE,GAAG,IAAI;IAKjC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKrC;;OAEG;IACH,aAAa,IAAI,IAAI;IASrB;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAShD;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,aAAa,GAAG,IAAI;IAUtE;;OAEG;IACH,iBAAiB,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAS/B;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,mBAAmB,KAAK,mBAAmB,GAAG,IAAI;IAWlF;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAK1B;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAS3B;;OAEG;IACH,oBAAoB,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,GAAG,IAAI;IAW9D;;OAEG;IACH,kBAAkB,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,GAAG,IAAI;IAWpE;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,eAAe,KAAK,eAAe,GAAG,IAAI;IASpE;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAK3C;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAK/C;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAK5B;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAS7B;;OAEG;IACH,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAKnB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,IAAI;IASvB;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,KAAK,IAAI,IAAI;CASd"}

package/dist/builder/edit.js

@@ -0,0 +1,221 @@
+import { EntityBuilder } from "./entity.js";
+import { UpdateEntityBuilder } from "./update.js";
+import { RelationBuilder } from "./relation.js";
+/**
+ * Builder for constructing an Edit with operations.
+ */
+export class EditBuilder {
+    _id;
+    name = "";
+    authors = [];
+    createdAt = 0n;
+    ops = [];
+    constructor(id) {
+        this._id = id;
+    }
+    /**
+     * Sets the edit name.
+     */
+    setName(name) {
+        this.name = name;
+        return this;
+    }
+    /**
+     * Adds an author to the edit.
+     */
+    addAuthor(authorId) {
+        this.authors.push(authorId);
+        return this;
+    }
+    /**
+     * Sets multiple authors at once.
+     */
+    setAuthors(authorIds) {
+        this.authors = [...authorIds];
+        return this;
+    }
+    /**
+     * Sets the creation timestamp (microseconds since Unix epoch).
+     */
+    setCreatedAt(timestamp) {
+        this.createdAt = timestamp;
+        return this;
+    }
+    /**
+     * Sets the creation timestamp to now.
+     */
+    setCreatedNow() {
+        this.createdAt = BigInt(Date.now()) * 1000n;
+        return this;
+    }
+    // =========================================================================
+    // Property Operations
+    // =========================================================================
+    /**
+     * Adds a CreateProperty operation.
+     */
+    createProperty(id, dataType) {
+        this.ops.push({ type: "createProperty", id, dataType });
+        return this;
+    }
+    // =========================================================================
+    // Entity Operations
+    // =========================================================================
+    /**
+     * Adds a CreateEntity operation using a builder function.
+     */
+    createEntity(id, build) {
+        const builder = build(new EntityBuilder());
+        this.ops.push({
+            type: "createEntity",
+            id,
+            values: builder.getValues(),
+        });
+        return this;
+    }
+    /**
+     * Adds a CreateEntity operation with no values.
+     */
+    createEmptyEntity(id) {
+        this.ops.push({
+            type: "createEntity",
+            id,
+            values: [],
+        });
+        return this;
+    }
+    /**
+     * Adds an UpdateEntity operation using a builder function.
+     */
+    updateEntity(id, build) {
+        const builder = build(new UpdateEntityBuilder(id));
+        this.ops.push({
+            type: "updateEntity",
+            id: builder.id,
+            setProperties: builder.getSetProperties(),
+            unsetProperties: builder.getUnsetProperties(),
+        });
+        return this;
+    }
+    /**
+     * Adds a DeleteEntity operation.
+     */
+    deleteEntity(id) {
+        this.ops.push({ type: "deleteEntity", id });
+        return this;
+    }
+    /**
+     * Adds a RestoreEntity operation.
+     */
+    restoreEntity(id) {
+        this.ops.push({ type: "restoreEntity", id });
+        return this;
+    }
+    // =========================================================================
+    // Relation Operations
+    // =========================================================================
+    /**
+     * Adds a CreateRelation operation in unique mode (ID derived from endpoints + type).
+     */
+    createRelationUnique(from, to, relationType) {
+        this.ops.push({
+            type: "createRelation",
+            idMode: { type: "unique" },
+            relationType,
+            from,
+            to,
+        });
+        return this;
+    }
+    /**
+     * Adds a CreateRelation operation in many mode (explicit ID).
+     */
+    createRelationMany(id, from, to, relationType) {
+        this.ops.push({
+            type: "createRelation",
+            idMode: { type: "many", id },
+            relationType,
+            from,
+            to,
+        });
+        return this;
+    }
+    /**
+     * Adds a CreateRelation operation with full control using a builder.
+     */
+    createRelation(build) {
+        const builder = build(new RelationBuilder());
+        const relation = builder.build();
+        if (relation) {
+            this.ops.push(relation);
+        }
+        return this;
+    }
+    /**
+     * Adds a CreateRelation directly.
+     */
+    addRelation(relation) {
+        this.ops.push(relation);
+        return this;
+    }
+    /**
+     * Adds an UpdateRelation operation (can only update position).
+     */
+    updateRelation(id, position) {
+        this.ops.push({ type: "updateRelation", id, position });
+        return this;
+    }
+    /**
+     * Adds a DeleteRelation operation.
+     */
+    deleteRelation(id) {
+        this.ops.push({ type: "deleteRelation", id });
+        return this;
+    }
+    /**
+     * Adds a RestoreRelation operation.
+     */
+    restoreRelation(id) {
+        this.ops.push({ type: "restoreRelation", id });
+        return this;
+    }
+    // =========================================================================
+    // Raw Operations
+    // =========================================================================
+    /**
+     * Adds a raw operation directly.
+     */
+    addOp(op) {
+        this.ops.push(op);
+        return this;
+    }
+    /**
+     * Adds multiple raw operations.
+     */
+    addOps(ops) {
+        this.ops.push(...ops);
+        return this;
+    }
+    // =========================================================================
+    // Build
+    // =========================================================================
+    /**
+     * Returns the number of operations added so far.
+     */
+    opCount() {
+        return this.ops.length;
+    }
+    /**
+     * Builds the final Edit.
+     */
+    build() {
+        return {
+            id: this._id,
+            name: this.name,
+            authors: this.authors,
+            createdAt: this.createdAt,
+            ops: this.ops,
+        };
+    }
+}
+//# sourceMappingURL=edit.js.map

package/dist/builder/edit.js.map

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

package/dist/builder/entity.d.ts

@@ -0,0 +1,62 @@
+import type { Id } from "../types/id.js";
+import type { DecimalMantissa, PropertyValue, Value } from "../types/value.js";
+import { EmbeddingSubType } from "../types/value.js";
+/**
+ * Builder for entity values (used in CreateEntity).
+ */
+export declare class EntityBuilder {
+    private values;
+    /**
+     * Adds a property value.
+     */
+    value(property: Id, value: Value): this;
+    /**
+     * Adds a TEXT value.
+     */
+    text(property: Id, value: string, language?: Id): this;
+    /**
+     * Adds an INT64 value.
+     */
+    int64(property: Id, value: bigint, unit?: Id): this;
+    /**
+     * Adds a FLOAT64 value.
+     */
+    float64(property: Id, value: number, unit?: Id): this;
+    /**
+     * Adds a BOOL value.
+     */
+    bool(property: Id, value: boolean): this;
+    /**
+     * Adds a BYTES value.
+     */
+    bytes(property: Id, value: Uint8Array): this;
+    /**
+     * Adds a POINT value (latitude, longitude).
+     */
+    point(property: Id, lat: number, lon: number): this;
+    /**
+     * Adds a DATE value (ISO 8601 string like "2024-01-15" or "2024-01" or "2024").
+     */
+    date(property: Id, value: string): this;
+    /**
+     * Adds a TIMESTAMP value (microseconds since Unix epoch).
+     */
+    timestamp(property: Id, micros: bigint): this;
+    /**
+     * Adds a DECIMAL value.
+     */
+    decimal(property: Id, exponent: number, mantissa: DecimalMantissa, unit?: Id): this;
+    /**
+     * Adds a DECIMAL value from a bigint mantissa.
+     */
+    decimalI64(property: Id, exponent: number, mantissa: bigint, unit?: Id): this;
+    /**
+     * Adds an EMBEDDING value.
+     */
+    embedding(property: Id, subType: EmbeddingSubType, dims: number, data: Uint8Array): this;
+    /**
+     * Returns the built values array.
+     */
+    getValues(): PropertyValue[];
+}
+//# sourceMappingURL=entity.d.ts.map

package/dist/builder/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/builder/entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAuB;IAErC;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAKvC;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,IAAI;IAQtD;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI;IAQnD;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI;IAQrD;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAQxC;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAQ5C;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAQnD;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQvC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ7C;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI;IAQnF;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI;IAI7E;;OAEG;IACH,SAAS,CACP,QAAQ,EAAE,EAAE,EACZ,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,GACf,IAAI;IAQP;;OAEG;IACH,SAAS,IAAI,aAAa,EAAE;CAG7B"}

package/dist/builder/entity.js

@@ -0,0 +1,126 @@
+/**
+ * Builder for entity values (used in CreateEntity).
+ */
+export class EntityBuilder {
+    values = [];
+    /**
+     * Adds a property value.
+     */
+    value(property, value) {
+        this.values.push({ property, value });
+        return this;
+    }
+    /**
+     * Adds a TEXT value.
+     */
+    text(property, value, language) {
+        this.values.push({
+            property,
+            value: { type: "text", value, language },
+        });
+        return this;
+    }
+    /**
+     * Adds an INT64 value.
+     */
+    int64(property, value, unit) {
+        this.values.push({
+            property,
+            value: { type: "int64", value, unit },
+        });
+        return this;
+    }
+    /**
+     * Adds a FLOAT64 value.
+     */
+    float64(property, value, unit) {
+        this.values.push({
+            property,
+            value: { type: "float64", value, unit },
+        });
+        return this;
+    }
+    /**
+     * Adds a BOOL value.
+     */
+    bool(property, value) {
+        this.values.push({
+            property,
+            value: { type: "bool", value },
+        });
+        return this;
+    }
+    /**
+     * Adds a BYTES value.
+     */
+    bytes(property, value) {
+        this.values.push({
+            property,
+            value: { type: "bytes", value },
+        });
+        return this;
+    }
+    /**
+     * Adds a POINT value (latitude, longitude).
+     */
+    point(property, lat, lon) {
+        this.values.push({
+            property,
+            value: { type: "point", lat, lon },
+        });
+        return this;
+    }
+    /**
+     * Adds a DATE value (ISO 8601 string like "2024-01-15" or "2024-01" or "2024").
+     */
+    date(property, value) {
+        this.values.push({
+            property,
+            value: { type: "date", value },
+        });
+        return this;
+    }
+    /**
+     * Adds a TIMESTAMP value (microseconds since Unix epoch).
+     */
+    timestamp(property, micros) {
+        this.values.push({
+            property,
+            value: { type: "timestamp", value: micros },
+        });
+        return this;
+    }
+    /**
+     * Adds a DECIMAL value.
+     */
+    decimal(property, exponent, mantissa, unit) {
+        this.values.push({
+            property,
+            value: { type: "decimal", exponent, mantissa, unit },
+        });
+        return this;
+    }
+    /**
+     * Adds a DECIMAL value from a bigint mantissa.
+     */
+    decimalI64(property, exponent, mantissa, unit) {
+        return this.decimal(property, exponent, { type: "i64", value: mantissa }, unit);
+    }
+    /**
+     * Adds an EMBEDDING value.
+     */
+    embedding(property, subType, dims, data) {
+        this.values.push({
+            property,
+            value: { type: "embedding", subType, dims, data },
+        });
+        return this;
+    }
+    /**
+     * Returns the built values array.
+     */
+    getValues() {
+        return this.values;
+    }
+}
+//# sourceMappingURL=entity.js.map

package/dist/builder/entity.js.map

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

package/dist/builder/index.d.ts

@@ -0,0 +1,5 @@
+export { EditBuilder } from "./edit.js";
+export { EntityBuilder } from "./entity.js";
+export { UpdateEntityBuilder } from "./update.js";
+export { RelationBuilder } from "./relation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/builder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/builder/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/builder/index.js

@@ -0,0 +1,5 @@
+export { EditBuilder } from "./edit.js";
+export { EntityBuilder } from "./entity.js";
+export { UpdateEntityBuilder } from "./update.js";
+export { RelationBuilder } from "./relation.js";
+//# sourceMappingURL=index.js.map

package/dist/builder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/builder/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/builder/relation.d.ts

@@ -0,0 +1,66 @@
+import type { Id } from "../types/id.js";
+import type { CreateRelation } from "../types/op.js";
+/**
+ * Builder for CreateRelation operations with full control.
+ */
+export declare class RelationBuilder {
+    private idMode?;
+    private relationType?;
+    private from?;
+    private to?;
+    private entity?;
+    private position?;
+    private fromSpace?;
+    private fromVersion?;
+    private toSpace?;
+    private toVersion?;
+    /**
+     * Sets unique mode (ID derived from from+to+type).
+     */
+    unique(): this;
+    /**
+     * Sets many mode with an explicit relation ID.
+     */
+    many(id: Id): this;
+    /**
+     * Sets the relation type.
+     */
+    type(id: Id): this;
+    /**
+     * Sets the source entity.
+     */
+    fromEntity(id: Id): this;
+    /**
+     * Sets the target entity.
+     */
+    toEntity(id: Id): this;
+    /**
+     * Sets an explicit reified entity ID (many mode only).
+     */
+    reifiedEntity(id: Id): this;
+    /**
+     * Sets the position string for ordering.
+     */
+    atPosition(pos: string): this;
+    /**
+     * Sets the from_space pin.
+     */
+    pinFromSpace(id: Id): this;
+    /**
+     * Sets the from_version pin.
+     */
+    pinFromVersion(id: Id): this;
+    /**
+     * Sets the to_space pin.
+     */
+    pinToSpace(id: Id): this;
+    /**
+     * Sets the to_version pin.
+     */
+    pinToVersion(id: Id): this;
+    /**
+     * Builds the CreateRelation, returning undefined if required fields are missing.
+     */
+    build(): CreateRelation | undefined;
+}
+//# sourceMappingURL=relation.d.ts.map

package/dist/builder/relation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../../src/builder/relation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,gBAAgB,CAAC;AAErE;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAiB;IAChC,OAAO,CAAC,YAAY,CAAC,CAAK;IAC1B,OAAO,CAAC,IAAI,CAAC,CAAK;IAClB,OAAO,CAAC,EAAE,CAAC,CAAK;IAChB,OAAO,CAAC,MAAM,CAAC,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAC,CAAK;IACvB,OAAO,CAAC,WAAW,CAAC,CAAK;IACzB,OAAO,CAAC,OAAO,CAAC,CAAK;IACrB,OAAO,CAAC,SAAS,CAAC,CAAK;IAEvB;;OAEG;IACH,MAAM,IAAI,IAAI;IAKd;;OAEG;IACH,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAKlB;;OAEG;IACH,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAKlB;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAKxB;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAKtB;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAK3B;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK7B;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAK1B;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAK5B;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAKxB;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAK1B;;OAEG;IACH,KAAK,IAAI,cAAc,GAAG,SAAS;CAmBpC"}