@geoprotocol/geo-sdk 0.18.3 → 0.19.1

package/dist/src/client/edits.js

@@ -0,0 +1,131 @@
+import { encodeAbiParameters, encodeFunctionData, toHex } from 'viem';
+import { SpaceRegistryAbi } from '../abis/index.js';
+import { isValid } from '../id.js';
+import { toBytes } from '../id-utils.js';
+import { UUID_DASHLESS_REGEX } from '../internal/uuid.js';
+import { publishEditCore } from '../ipfs-core.js';
+import { requireGeoContract } from '../networks.js';
+import { EDITS_PUBLISHED, EMPTY_SIGNATURE, EMPTY_TOPIC } from '../personal-space/constants.js';
+import { requireFetch } from './context.js';
+function spaceIdToBytes16(spaceId) {
+    if (UUID_DASHLESS_REGEX.test(spaceId)) {
+        return `0x${spaceId.toLowerCase()}`;
+    }
+    if (isValid(spaceId)) {
+        return toHex(toBytes(spaceId));
+    }
+    throw new Error(`Invalid spaceId: "${spaceId}". Expected a valid UUID or 32-character hex string.`);
+}
+/**
+ * Encodes personal-space edit publish calldata.
+ *
+ * Use this when an edit is already uploaded and you only need calldata for the
+ * configured or supplied space registry. The function accepts dashless UUID
+ * space IDs and valid SDK IDs.
+ *
+ * @example
+ * ```ts
+ * const tx = encodePublishEditToSpaceCalldata({
+ *   spaceId,
+ *   cid: 'ipfs://bafkreihdwdcefgh4dqkjv67uzcmw7ojee6xedzdetojuzjevtenxquvyku',
+ *   spaceRegistryAddress: '0x0000000000000000000000000000000000000000',
+ * });
+ *
+ * await walletClient.sendTransaction({
+ *   to: tx.to,
+ *   data: tx.calldata,
+ * });
+ * ```
+ *
+ * @param params Space ID, edit CID, and space registry address.
+ * @returns Target registry address and encoded calldata.
+ * @throws When the space ID is not a valid UUID or SDK ID.
+ */
+export function encodePublishEditToSpaceCalldata({ spaceId, cid, spaceRegistryAddress, }) {
+    const spaceIdBytes16 = spaceIdToBytes16(spaceId);
+    const encodedCid = encodeAbiParameters([{ type: 'string' }], [cid]);
+    const calldata = encodeFunctionData({
+        abi: SpaceRegistryAbi,
+        functionName: 'enter',
+        args: [spaceIdBytes16, spaceIdBytes16, EDITS_PUBLISHED, EMPTY_TOPIC, encodedCid, EMPTY_SIGNATURE],
+    });
+    return {
+        to: spaceRegistryAddress,
+        calldata,
+    };
+}
+/**
+ * Publishes edit ops to IPFS using the configured Geo API.
+ *
+ * This helper creates a GRC-20 edit payload, uploads it, and returns the edit
+ * CID and generated edit ID. It does not create transaction calldata.
+ *
+ * @example
+ * ```ts
+ * import * as Ops from '@geoprotocol/geo-sdk/ops';
+ *
+ * const { ops } = Ops.entities.create({ name: 'Geo entity' });
+ * const edit = await publish(context, {
+ *   name: 'Create Geo entity',
+ *   author: authorSpaceId,
+ *   ops,
+ * });
+ *
+ * console.log(edit.cid);
+ * ```
+ *
+ * @param context Client context containing API origin and fetch configuration.
+ * @param params Edit name, author space ID, and ops to publish.
+ * @returns Uploaded edit CID and generated edit ID.
+ * @throws When ops are empty, IDs are invalid, fetch is unavailable, upload fails, or the CID response is invalid.
+ */
+export function publish(context, params) {
+    return publishEditCore({
+        ...params,
+        apiOrigin: context.network.apiOrigin,
+        fetch: requireFetch(context, 'Edit publishing'),
+    });
+}
+/**
+ * Publishes edit ops to IPFS and returns calldata for submitting the edit to a personal space.
+ *
+ * This combines {@link publish} and {@link encodePublishEditToSpaceCalldata}
+ * using the space registry address from the configured network.
+ *
+ * @example
+ * ```ts
+ * const tx = await geo.personalSpaces.publishEdit({
+ *   name: 'Create entity',
+ *   spaceId,
+ *   author: spaceId,
+ *   ops,
+ * });
+ *
+ * await walletClient.sendTransaction({
+ *   to: tx.to,
+ *   data: tx.calldata,
+ * });
+ * ```
+ *
+ * @param context Client context containing network, contract, and fetch configuration.
+ * @param params Edit publication params plus the target space ID.
+ * @returns Edit ID, CID, target registry address, and calldata.
+ * @throws When required contract addresses are missing or publish/calldata validation fails.
+ */
+export async function publishToSpace(context, params) {
+    const spaceRegistryAddress = requireGeoContract(context.network, 'SPACE_REGISTRY_ADDRESS');
+    spaceIdToBytes16(String(params.spaceId));
+    const { cid, editId } = await publish(context, params);
+    const { to, calldata } = encodePublishEditToSpaceCalldata({
+        spaceId: params.spaceId,
+        cid,
+        spaceRegistryAddress,
+    });
+    return {
+        editId,
+        cid,
+        to,
+        calldata,
+    };
+}
+//# sourceMappingURL=edits.js.map

package/dist/src/client/edits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edits.js","sourceRoot":"","sources":["../../../src/client/edits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAA0B,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE/F,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAY5C,SAAS,gBAAgB,CAAC,OAAe;IACvC,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,OAAO,KAAK,OAAO,CAAC,WAAW,EAAE,EAAmB,CAAC;IACvD,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,sDAAsD,CAAC,CAAC;AACtG,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,gCAAgC,CAAC,EAC/C,OAAO,EACP,GAAG,EACH,oBAAoB,GACa;IACjC,MAAM,cAAc,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,kBAAkB,CAAC;QAClC,GAAG,EAAE,gBAAgB;QACrB,YAAY,EAAE,OAAO;QACrB,IAAI,EAAE,CAAC,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,CAAC;KAClG,CAAC,CAAC;IAEH,OAAO;QACL,EAAE,EAAE,oBAAoB;QACxB,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,OAAO,CAAC,OAAyB,EAAE,MAAyB;IAC1E,OAAO,eAAe,CAAC;QACrB,GAAG,MAAM;QACT,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS;QACpC,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,iBAAiB,CAAC;KAChD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAyB,EAAE,MAAgC;IAC9F,MAAM,oBAAoB,GAAG,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC;IAC3F,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACzC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvD,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,gCAAgC,CAAC;QACxD,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,GAAG;QACH,oBAAoB;KACrB,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,GAAG;QACH,EAAE;QACF,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/src/client/edits.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=edits.test.d.ts.map

package/dist/src/client/edits.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edits.test.d.ts","sourceRoot":"","sources":["../../../src/client/edits.test.ts"],"names":[],"mappings":""}

package/dist/src/client/edits.test.js

@@ -0,0 +1,98 @@
+import { decodeAbiParameters, decodeFunctionData } from 'viem';
+import { describe, expect, it, vi } from 'vitest';
+import { SpaceRegistryAbi } from '../abis/index.js';
+import { createEntity } from '../graph/create-entity.js';
+import { defineGeoNetworkConfig } from '../networks.js';
+import { EDITS_PUBLISHED, EMPTY_SIGNATURE, EMPTY_TOPIC } from '../personal-space/constants.js';
+import { encodePublishEditToSpaceCalldata, publish, publishToSpace } from './edits.js';
+const CID = 'ipfs://bafkreigwfjixq5cm3s4youhshorkpqh3ykpviyv76c2ei6gaalujtlqz5i';
+const SPACE_ID = '0eed5491b917cf58b33ac81255fe7ae9';
+const AUTHOR_ID = '5cade5757ecd41ae83481b22ffc2f94e';
+const SPACE_REGISTRY_ADDRESS = '0x0000000000000000000000000000000000000001';
+function mockUploadFetch() {
+    return vi.fn().mockResolvedValue(new Response(JSON.stringify({ cid: CID })));
+}
+function testContext(fetch = mockUploadFetch()) {
+    return {
+        network: defineGeoNetworkConfig({
+            id: 'LOCAL',
+            name: 'Local Geo',
+            apiOrigin: 'http://localhost:3000',
+            contracts: {
+                SPACE_REGISTRY_ADDRESS,
+            },
+        }),
+        fetch,
+    };
+}
+function decodePublishEditCalldata(calldata) {
+    const decoded = decodeFunctionData({
+        abi: SpaceRegistryAbi,
+        data: calldata,
+    });
+    expect(decoded.functionName).toBe('enter');
+    const [fromSpaceId, toSpaceId, action, topic, data, signature] = decoded.args;
+    const [cid] = decodeAbiParameters([{ type: 'string' }], data);
+    return {
+        fromSpaceId,
+        toSpaceId,
+        action,
+        topic,
+        cid,
+        signature,
+    };
+}
+describe('client edit helpers', () => {
+    it('encodes personal space publish calldata without context', () => {
+        const { to, calldata } = encodePublishEditToSpaceCalldata({
+            spaceId: SPACE_ID,
+            cid: CID,
+            spaceRegistryAddress: SPACE_REGISTRY_ADDRESS,
+        });
+        const decoded = decodePublishEditCalldata(calldata);
+        expect(to).toBe(SPACE_REGISTRY_ADDRESS);
+        expect(decoded.fromSpaceId).toBe(`0x${SPACE_ID}`);
+        expect(decoded.toSpaceId).toBe(`0x${SPACE_ID}`);
+        expect(decoded.action).toBe(EDITS_PUBLISHED);
+        expect(decoded.topic).toBe(EMPTY_TOPIC);
+        expect(decoded.cid).toBe(CID);
+        expect(decoded.signature).toBe(EMPTY_SIGNATURE);
+    });
+    it('publishes an edit with the configured API origin and fetch implementation', async () => {
+        const fetch = mockUploadFetch();
+        const { ops } = createEntity({ name: 'Test Entity' });
+        const result = await publish(testContext(fetch), {
+            name: 'Test Edit',
+            ops,
+            author: AUTHOR_ID,
+        });
+        expect(result.cid).toBe(CID);
+        expect(result.editId).toHaveLength(32);
+        expect(fetch).toHaveBeenCalledWith('http://localhost:3000/ipfs/upload-edit', expect.objectContaining({ method: 'POST' }));
+    });
+    it('publishes to a personal space and returns transaction data for the configured registry', async () => {
+        const fetch = mockUploadFetch();
+        const { ops } = createEntity({ name: 'Test Entity' });
+        const result = await publishToSpace(testContext(fetch), {
+            name: 'Publish to space',
+            spaceId: SPACE_ID,
+            ops,
+            author: AUTHOR_ID,
+        });
+        expect(result.to).toBe(SPACE_REGISTRY_ADDRESS);
+        expect(result.cid).toBe(CID);
+        expect(decodePublishEditCalldata(result.calldata).cid).toBe(CID);
+    });
+    it('validates the personal space ID before uploading', async () => {
+        const fetch = mockUploadFetch();
+        const { ops } = createEntity({ name: 'Test Entity' });
+        await expect(publishToSpace(testContext(fetch), {
+            name: 'Publish to space',
+            spaceId: 'not-a-space-id',
+            ops,
+            author: AUTHOR_ID,
+        })).rejects.toThrow('Invalid spaceId');
+        expect(fetch).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=edits.test.js.map

package/dist/src/client/edits.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edits.test.js","sourceRoot":"","sources":["../../../src/client/edits.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE/F,OAAO,EAAE,gCAAgC,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEvF,MAAM,GAAG,GAAG,oEAA6E,CAAC;AAC1F,MAAM,QAAQ,GAAG,kCAAkC,CAAC;AACpD,MAAM,SAAS,GAAG,kCAAkC,CAAC;AACrD,MAAM,sBAAsB,GAAG,4CAAqD,CAAC;AAErF,SAAS,eAAe;IACtB,OAAO,EAAE,CAAC,EAAE,EAA2B,CAAC,iBAAiB,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AACxG,CAAC;AAED,SAAS,WAAW,CAAC,QAAiC,eAAe,EAAE;IACrE,OAAO;QACL,OAAO,EAAE,sBAAsB,CAAC;YAC9B,EAAE,EAAE,OAAO;YACX,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,uBAAuB;YAClC,SAAS,EAAE;gBACT,sBAAsB;aACvB;SACF,CAAC;QACF,KAAK;KACN,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,QAAuB;IACxD,MAAM,OAAO,GAAG,kBAAkB,CAAC;QACjC,GAAG,EAAE,gBAAgB;QACrB,IAAI,EAAE,QAAQ;KACf,CAAC,CAAC;IACH,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE3C,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,IAOxE,CAAC;IACF,MAAM,CAAC,GAAG,CAAC,GAAG,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IAE9D,OAAO;QACL,WAAW;QACX,SAAS;QACT,MAAM;QACN,KAAK;QACL,GAAG;QACH,SAAS;KACV,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,gCAAgC,CAAC;YACxD,OAAO,EAAE,QAAQ;YACjB,GAAG,EAAE,GAAG;YACR,oBAAoB,EAAE,sBAAsB;SAC7C,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;QAEpD,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACxC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;QAClD,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;QAChD,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC7C,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;QACzF,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,MAAM,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE;YAC/C,IAAI,EAAE,WAAW;YACjB,GAAG;YACH,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAChC,wCAAwC,EACxC,MAAM,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAC5C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wFAAwF,EAAE,KAAK,IAAI,EAAE;QACtG,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,MAAM,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE;YACtD,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,QAAQ;YACjB,GAAG;YACH,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,CAAC,yBAAyB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,MAAM,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QAEtD,MAAM,MAAM,CACV,cAAc,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE;YACjC,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,gBAAgB;YACzB,GAAG;YACH,MAAM,EAAE,SAAS;SAClB,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAErC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/client/entities.d.ts

@@ -0,0 +1,23 @@
+import type { CreateResult, DeleteEntityParams } from '../types.js';
+import type { GeoClientContext } from './context.js';
+/**
+ * Fetches the current entity values and relations for a space, then builds delete ops.
+ *
+ * Entity deletion requires current graph context so the SDK can unset existing
+ * values and delete existing relations in the target space.
+ *
+ * @example
+ * ```ts
+ * const { ops } = await geo.entities.delete({
+ *   id: entityId,
+ *   spaceId,
+ * });
+ * ```
+ *
+ * @param context Client context containing API origin and fetch configuration.
+ * @param params Entity ID and space ID to delete within.
+ * @returns Entity ID and deletion ops, or no ops when the entity is not found.
+ * @throws When IDs are invalid, fetch is unavailable, GraphQL fails, or the response is malformed.
+ */
+export declare function deleteEntity(context: GeoClientContext, { id, spaceId }: Omit<DeleteEntityParams, 'network'>): Promise<CreateResult>;
+//# sourceMappingURL=entities.d.ts.map

package/dist/src/client/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../../src/client/entities.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAkDrD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC,yBAuCjH"}

package/dist/src/client/entities.js

@@ -0,0 +1,88 @@
+import { deleteRelation as grcDeleteRelation, updateEntity as grcUpdateEntity, } from '@geoprotocol/grc-20';
+import { Id } from '../id.js';
+import { assertValid, toGrcId } from '../id-utils.js';
+import { graphqlData } from './api.js';
+class DeleteEntityError extends Error {
+    _tag = 'DeleteEntityError';
+}
+function createDeleteEntityOps({ id, spaceId, values, relations }) {
+    assertValid(id, '`id` in `deleteEntity`');
+    assertValid(spaceId, '`spaceId` in `deleteEntity`');
+    const normalizedSpaceId = String(spaceId).replaceAll('-', '');
+    const ops = [];
+    const matchingValues = values.filter(v => v.spaceId === normalizedSpaceId);
+    const matchingRelations = relations.filter(r => r.spaceId === normalizedSpaceId);
+    const uniquePropertyIds = [...new Set(matchingValues.map(v => v.propertyId))];
+    if (uniquePropertyIds.length > 0) {
+        const unsetValues = uniquePropertyIds.map(propertyId => ({
+            property: toGrcId(propertyId),
+            language: { type: 'all' },
+        }));
+        ops.push(grcUpdateEntity({
+            id: toGrcId(id),
+            set: [],
+            unset: unsetValues,
+        }));
+    }
+    for (const relation of matchingRelations) {
+        ops.push(grcDeleteRelation(toGrcId(relation.id)));
+    }
+    return { id: Id(id), ops };
+}
+/**
+ * Fetches the current entity values and relations for a space, then builds delete ops.
+ *
+ * Entity deletion requires current graph context so the SDK can unset existing
+ * values and delete existing relations in the target space.
+ *
+ * @example
+ * ```ts
+ * const { ops } = await geo.entities.delete({
+ *   id: entityId,
+ *   spaceId,
+ * });
+ * ```
+ *
+ * @param context Client context containing API origin and fetch configuration.
+ * @param params Entity ID and space ID to delete within.
+ * @returns Entity ID and deletion ops, or no ops when the entity is not found.
+ * @throws When IDs are invalid, fetch is unavailable, GraphQL fails, or the response is malformed.
+ */
+export async function deleteEntity(context, { id, spaceId }) {
+    assertValid(id, '`id` in `deleteEntity`');
+    assertValid(spaceId, '`spaceId` in `deleteEntity`');
+    const normalizedSpaceId = String(spaceId).replaceAll('-', '');
+    const query = `query entity {
+    entity(id: "${id}") {
+      valuesList(filter: { spaceId: { in: [${JSON.stringify(normalizedSpaceId)}] } }) {
+        propertyId
+        spaceId
+      }
+      relationsList(filter: { spaceId: { in: [${JSON.stringify(normalizedSpaceId)}] } }) {
+        id
+        spaceId
+      }
+    }
+  }`;
+    let response;
+    try {
+        response = await graphqlData(context, query);
+    }
+    catch (error) {
+        const message = String(error);
+        if (message.includes('Could not parse GraphQL response')) {
+            throw new DeleteEntityError(`Could not parse GraphQL response for entity ${id}: ${error}`);
+        }
+        throw new DeleteEntityError(`Could not fetch entity data for ${id}: ${error}`);
+    }
+    if (!response.entity) {
+        return { id: Id(id), ops: [] };
+    }
+    return createDeleteEntityOps({
+        id,
+        spaceId,
+        values: response.entity.valuesList,
+        relations: response.entity.relationsList,
+    });
+}
+//# sourceMappingURL=entities.js.map

package/dist/src/client/entities.js.map

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

package/dist/src/client/entity-votes.d.ts

@@ -0,0 +1,141 @@
+import type { Id } from '../id.js';
+import type { GeoClientContext } from './context.js';
+export type ClientEntityVoteParams = {
+    authorSpaceId: Id | string;
+    spaceId: Id | string;
+    entityId: Id | string;
+};
+export type EntityVoteCalldataParams = ClientEntityVoteParams & {
+    spaceRegistryAddress: `0x${string}`;
+};
+/**
+ * Encodes upvote calldata.
+ *
+ * Use this pure helper when you already have the target space registry address.
+ * Use `geo.entityVotes.upvote(...)` when the address should come from the
+ * configured network.
+ *
+ * @example
+ * ```ts
+ * const tx = encodeUpvoteEntityCalldata({
+ *   authorSpaceId,
+ *   spaceId,
+ *   entityId,
+ *   spaceRegistryAddress,
+ * });
+ * ```
+ *
+ * @param params Author space, target space, entity ID, and space registry address.
+ * @returns Target registry address and encoded calldata.
+ * @throws When any supplied ID is invalid.
+ */
+export declare function encodeUpvoteEntityCalldata(params: EntityVoteCalldataParams): {
+    to: `0x${string}`;
+    calldata: `0x${string}`;
+};
+/**
+ * Encodes downvote calldata.
+ *
+ * @example
+ * ```ts
+ * const tx = encodeDownvoteEntityCalldata({
+ *   authorSpaceId,
+ *   spaceId,
+ *   entityId,
+ *   spaceRegistryAddress,
+ * });
+ * ```
+ *
+ * @param params Author space, target space, entity ID, and space registry address.
+ * @returns Target registry address and encoded calldata.
+ * @throws When any supplied ID is invalid.
+ */
+export declare function encodeDownvoteEntityCalldata(params: EntityVoteCalldataParams): {
+    to: `0x${string}`;
+    calldata: `0x${string}`;
+};
+/**
+ * Encodes vote-withdrawal calldata.
+ *
+ * @example
+ * ```ts
+ * const tx = encodeWithdrawEntityVoteCalldata({
+ *   authorSpaceId,
+ *   spaceId,
+ *   entityId,
+ *   spaceRegistryAddress,
+ * });
+ * ```
+ *
+ * @param params Author space, target space, entity ID, and space registry address.
+ * @returns Target registry address and encoded calldata.
+ * @throws When any supplied ID is invalid.
+ */
+export declare function encodeWithdrawEntityVoteCalldata(params: EntityVoteCalldataParams): {
+    to: `0x${string}`;
+    calldata: `0x${string}`;
+};
+/**
+ * Builds calldata for upvoting an entity using the configured space registry.
+ *
+ * @example
+ * ```ts
+ * const tx = geo.entityVotes.upvote({
+ *   authorSpaceId,
+ *   spaceId,
+ *   entityId,
+ * });
+ * ```
+ *
+ * @param context Client context containing the target network configuration.
+ * @param params Author space, target space, and entity ID.
+ * @returns Target registry address and encoded calldata.
+ * @throws When IDs are invalid or the configured network is missing `SPACE_REGISTRY_ADDRESS`.
+ */
+export declare function upvote(context: GeoClientContext, params: ClientEntityVoteParams): {
+    to: `0x${string}`;
+    calldata: `0x${string}`;
+};
+/**
+ * Builds calldata for downvoting an entity using the configured space registry.
+ *
+ * @example
+ * ```ts
+ * const tx = geo.entityVotes.downvote({
+ *   authorSpaceId,
+ *   spaceId,
+ *   entityId,
+ * });
+ * ```
+ *
+ * @param context Client context containing the target network configuration.
+ * @param params Author space, target space, and entity ID.
+ * @returns Target registry address and encoded calldata.
+ * @throws When IDs are invalid or the configured network is missing `SPACE_REGISTRY_ADDRESS`.
+ */
+export declare function downvote(context: GeoClientContext, params: ClientEntityVoteParams): {
+    to: `0x${string}`;
+    calldata: `0x${string}`;
+};
+/**
+ * Builds calldata for withdrawing an entity vote using the configured space registry.
+ *
+ * @example
+ * ```ts
+ * const tx = geo.entityVotes.withdraw({
+ *   authorSpaceId,
+ *   spaceId,
+ *   entityId,
+ * });
+ * ```
+ *
+ * @param context Client context containing the target network configuration.
+ * @param params Author space, target space, and entity ID.
+ * @returns Target registry address and encoded calldata.
+ * @throws When IDs are invalid or the configured network is missing `SPACE_REGISTRY_ADDRESS`.
+ */
+export declare function withdraw(context: GeoClientContext, params: ClientEntityVoteParams): {
+    to: `0x${string}`;
+    calldata: `0x${string}`;
+};
+//# sourceMappingURL=entity-votes.d.ts.map

package/dist/src/client/entity-votes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-votes.d.ts","sourceRoot":"","sources":["../../../src/client/entity-votes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAGnC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAWrD,MAAM,MAAM,sBAAsB,GAAG;IACnC,aAAa,EAAE,EAAE,GAAG,MAAM,CAAC;IAC3B,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC;IACrB,QAAQ,EAAE,EAAE,GAAG,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,sBAAsB,GAAG;IAC9D,oBAAoB,EAAE,KAAK,MAAM,EAAE,CAAC;CACrC,CAAC;AA+CF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,wBAAwB;;;EAE1E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,wBAAwB;;;EAE5E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,wBAAwB;;;EAEhF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,sBAAsB;;;EAE/E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,sBAAsB;;;EAEjF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,sBAAsB;;;EAEjF"}