@geoprotocol/geo-sdk 0.18.3 → 0.19.0

package/dist/src/client/dao-spaces.test.js

@@ -0,0 +1,263 @@
+import { decodeAbiParameters, decodeFunctionData, encodeAbiParameters } from 'viem';
+import { describe, expect, it, vi } from 'vitest';
+import { DaoSpaceAbi, SpaceRegistryAbi } from '../abis/index.js';
+import { createGeoClient } from '../client.js';
+import { bytes16ToBytes32LeftAligned, EMPTY_SIGNATURE, EMPTY_TOPIC, MEMBERSHIP_REQUESTED_ACTION, PROPOSAL_CREATED_ACTION, PROPOSAL_EXECUTED_ACTION, PROPOSAL_VOTED_ACTION, VOTE_OPTION_VALUES, } from '../dao-space/constants.js';
+import { defineGeoNetworkConfig } from '../networks.js';
+import * as Ops from '../ops/index.js';
+const CID = 'ipfs://bafkreigwfjixq5cm3s4youhshorkpqh3ykpviyv76c2ei6gaalujtlqz5i';
+const AUTHOR_ID = '5cade5757ecd41ae83481b22ffc2f94e';
+const CALLER_SPACE_ID = '0x0eed5491b917cf58b33ac81255fe7ae9';
+const DAO_SPACE_ID = '0xabcdef12345678901234567890abcdef';
+const MEMBER_SPACE_ID = '0x22222222222222222222222222222222';
+const PROPOSAL_ID = '0x11111111111111111111111111111111';
+const DAO_SPACE_ADDRESS = '0x1234567890123456789012345678901234567890';
+const SPACE_REGISTRY_ADDRESS = '0x0000000000000000000000000000000000000001';
+function customNetwork() {
+    return defineGeoNetworkConfig({
+        id: 'LOCAL',
+        name: 'Local Geo',
+        apiOrigin: 'http://localhost:3000',
+        contracts: {
+            SPACE_REGISTRY_ADDRESS,
+        },
+    });
+}
+function mockUploadFetch() {
+    return vi.fn().mockResolvedValue(new Response(JSON.stringify({ cid: CID })));
+}
+function decodeEnter(calldata) {
+    const decoded = decodeFunctionData({
+        abi: SpaceRegistryAbi,
+        data: calldata,
+    });
+    expect(decoded.functionName).toBe('enter');
+    const [fromSpaceId, toSpaceId, action, topic, data, signature] = decoded.args;
+    return {
+        fromSpaceId,
+        toSpaceId,
+        action,
+        topic,
+        data,
+        signature,
+    };
+}
+describe('geo DAO proposal client', () => {
+    it('creates proposal calldata for supplied actions without uploading', () => {
+        const geo = createGeoClient({ network: customNetwork() });
+        const action = geo.daoSpaces.proposals.actions.addMember(DAO_SPACE_ADDRESS, MEMBER_SPACE_ID);
+        const result = geo.daoSpaces.proposals.create({
+            fromSpaceId: CALLER_SPACE_ID,
+            daoSpaceId: DAO_SPACE_ID,
+            proposalId: PROPOSAL_ID,
+            votingMode: 'SLOW',
+            actions: [action],
+        });
+        const decoded = decodeEnter(result.calldata);
+        const [proposalId, votingMode, actions] = decodeAbiParameters([
+            { type: 'bytes16', name: 'proposalId' },
+            { type: 'uint8', name: 'votingMode' },
+            {
+                type: 'tuple[]',
+                name: 'actions',
+                components: [
+                    { type: 'address', name: 'to' },
+                    { type: 'uint256', name: 'value' },
+                    { type: 'bytes', name: 'data' },
+                ],
+            },
+        ], decoded.data);
+        expect(result.to).toBe(SPACE_REGISTRY_ADDRESS);
+        expect(result.proposalId).toBe(PROPOSAL_ID);
+        expect(decoded.fromSpaceId).toBe(CALLER_SPACE_ID);
+        expect(decoded.toSpaceId).toBe(DAO_SPACE_ID);
+        expect(decoded.action).toBe(PROPOSAL_CREATED_ACTION);
+        expect(decoded.topic).toBe(bytes16ToBytes32LeftAligned(PROPOSAL_ID));
+        expect(decoded.signature).toBe(EMPTY_SIGNATURE);
+        expect(proposalId).toBe(PROPOSAL_ID);
+        expect(votingMode).toBe(0);
+        expect(actions).toHaveLength(1);
+        expect(actions[0]?.to).toBe(DAO_SPACE_ADDRESS);
+        expect(actions[0]?.value).toBe(0n);
+    });
+    it('encodes proposal vote and execute calldata for the configured registry', () => {
+        const geo = createGeoClient({ network: customNetwork() });
+        const vote = geo.daoSpaces.proposals.vote({
+            authorSpaceId: CALLER_SPACE_ID,
+            spaceId: DAO_SPACE_ID,
+            proposalId: PROPOSAL_ID,
+            vote: 'NO',
+        });
+        const execute = geo.daoSpaces.proposals.execute({
+            authorSpaceId: CALLER_SPACE_ID,
+            spaceId: DAO_SPACE_ID,
+            proposalId: PROPOSAL_ID,
+        });
+        const decodedVote = decodeEnter(vote.calldata);
+        const decodedExecute = decodeEnter(execute.calldata);
+        const [, voteOption] = decodeAbiParameters([
+            { type: 'bytes16', name: 'proposalId' },
+            { type: 'uint8', name: 'voteOption' },
+        ], decodedVote.data);
+        expect(vote.to).toBe(SPACE_REGISTRY_ADDRESS);
+        expect(execute.to).toBe(SPACE_REGISTRY_ADDRESS);
+        expect(decodedVote.action).toBe(PROPOSAL_VOTED_ACTION);
+        expect(decodedVote.topic).toBe(bytes16ToBytes32LeftAligned(PROPOSAL_ID));
+        expect(voteOption).toBe(VOTE_OPTION_VALUES.NO);
+        expect(decodedExecute.action).toBe(PROPOSAL_EXECUTED_ACTION);
+        expect(decodedExecute.topic).toBe(bytes16ToBytes32LeftAligned(PROPOSAL_ID));
+    });
+    it('publishes an edit and wraps it as a DAO proposal action', async () => {
+        const fetch = mockUploadFetch();
+        const geo = createGeoClient({ network: customNetwork(), fetch });
+        const { ops } = Ops.entities.create({ name: 'Test Entity' });
+        const result = await geo.daoSpaces.proposeEdit({
+            name: 'Test Edit',
+            ops,
+            author: AUTHOR_ID,
+            daoSpaceAddress: DAO_SPACE_ADDRESS,
+            callerSpaceId: CALLER_SPACE_ID,
+            daoSpaceId: DAO_SPACE_ID,
+            proposalId: PROPOSAL_ID,
+        });
+        const decoded = decodeEnter(result.calldata);
+        const [, , actions] = decodeAbiParameters([
+            { type: 'bytes16', name: 'proposalId' },
+            { type: 'uint8', name: 'votingMode' },
+            {
+                type: 'tuple[]',
+                name: 'actions',
+                components: [
+                    { type: 'address', name: 'to' },
+                    { type: 'uint256', name: 'value' },
+                    { type: 'bytes', name: 'data' },
+                ],
+            },
+        ], decoded.data);
+        const publishAction = actions[0];
+        expect(publishAction).toBeDefined();
+        if (!publishAction) {
+            throw new Error('Expected a publish action');
+        }
+        const publishCall = decodeFunctionData({
+            abi: DaoSpaceAbi,
+            data: publishAction.data,
+        });
+        expect(result.to).toBe(SPACE_REGISTRY_ADDRESS);
+        expect(result.cid).toBe(CID);
+        expect(result.proposalId).toBe(PROPOSAL_ID);
+        expect(publishAction.to).toBe(DAO_SPACE_ADDRESS);
+        expect(publishCall.functionName).toBe('publish');
+        expect(publishCall.args?.[1]).toBe(encodeAbiParameters([{ type: 'string' }], [CID]));
+        expect(fetch).toHaveBeenCalledWith('http://localhost:3000/ipfs/upload-edit', expect.objectContaining({ method: 'POST' }));
+    });
+    it('creates member and editor role proposals from daoSpaces', () => {
+        const geo = createGeoClient({ network: customNetwork() });
+        const addMember = geo.daoSpaces.proposeAddMember({
+            authorSpaceId: CALLER_SPACE_ID,
+            spaceId: DAO_SPACE_ID,
+            daoSpaceAddress: DAO_SPACE_ADDRESS,
+            newMemberSpaceId: MEMBER_SPACE_ID,
+            proposalId: PROPOSAL_ID,
+        });
+        const addEditor = geo.daoSpaces.proposeAddEditor({
+            authorSpaceId: CALLER_SPACE_ID,
+            spaceId: DAO_SPACE_ID,
+            daoSpaceAddress: DAO_SPACE_ADDRESS,
+            newEditorSpaceId: MEMBER_SPACE_ID,
+            proposalId: PROPOSAL_ID,
+        });
+        const decodedAddMember = decodeEnter(addMember.calldata);
+        const [, memberVotingMode, memberActions] = decodeAbiParameters([
+            { type: 'bytes16', name: 'proposalId' },
+            { type: 'uint8', name: 'votingMode' },
+            {
+                type: 'tuple[]',
+                name: 'actions',
+                components: [
+                    { type: 'address', name: 'to' },
+                    { type: 'uint256', name: 'value' },
+                    { type: 'bytes', name: 'data' },
+                ],
+            },
+        ], decodedAddMember.data);
+        const [, editorVotingMode] = decodeAbiParameters([
+            { type: 'bytes16', name: 'proposalId' },
+            { type: 'uint8', name: 'votingMode' },
+            {
+                type: 'tuple[]',
+                name: 'actions',
+                components: [
+                    { type: 'address', name: 'to' },
+                    { type: 'uint256', name: 'value' },
+                    { type: 'bytes', name: 'data' },
+                ],
+            },
+        ], decodeEnter(addEditor.calldata).data);
+        const addMemberAction = memberActions[0];
+        expect(addMemberAction).toBeDefined();
+        if (!addMemberAction) {
+            throw new Error('Expected addMember action');
+        }
+        const addMemberCall = decodeFunctionData({
+            abi: DaoSpaceAbi,
+            data: addMemberAction.data,
+        });
+        expect(addMember.to).toBe(SPACE_REGISTRY_ADDRESS);
+        expect(addMemberAction.to).toBe(DAO_SPACE_ADDRESS);
+        expect(addMemberCall.functionName).toBe('addMember');
+        expect(addMemberCall.args?.[0]).toBe(MEMBER_SPACE_ID);
+        expect(memberVotingMode).toBe(0);
+        expect(editorVotingMode).toBe(0);
+    });
+    it('restricts editor role proposals to SLOW voting', () => {
+        const geo = createGeoClient({ network: customNetwork() });
+        expect(() => geo.daoSpaces.proposeAddEditor({
+            authorSpaceId: CALLER_SPACE_ID,
+            spaceId: DAO_SPACE_ID,
+            daoSpaceAddress: DAO_SPACE_ADDRESS,
+            newEditorSpaceId: MEMBER_SPACE_ID,
+            votingMode: 'FAST',
+        })).toThrow('proposeAddEditor only supports SLOW voting mode');
+    });
+    it('requires daoSpaceAddress for DAO role proposal actions', () => {
+        const geo = createGeoClient({ network: customNetwork() });
+        expect(() => geo.daoSpaces.proposeAddMember({
+            authorSpaceId: CALLER_SPACE_ID,
+            spaceId: DAO_SPACE_ID,
+            newMemberSpaceId: MEMBER_SPACE_ID,
+            proposalId: PROPOSAL_ID,
+        })).toThrow('daoSpaceAddress is required');
+    });
+    it('rejects unknown voting modes at runtime', () => {
+        const geo = createGeoClient({ network: customNetwork() });
+        const action = geo.daoSpaces.proposals.actions.addMember(DAO_SPACE_ADDRESS, MEMBER_SPACE_ID);
+        expect(() => geo.daoSpaces.proposals.create({
+            fromSpaceId: CALLER_SPACE_ID,
+            daoSpaceId: DAO_SPACE_ID,
+            proposalId: PROPOSAL_ID,
+            votingMode: 'MAYBE',
+            actions: [action],
+        })).toThrow('votingMode must be "FAST" or "SLOW"');
+    });
+    it('creates membership request calldata from daoSpaces', () => {
+        const geo = createGeoClient({ network: customNetwork() });
+        const result = geo.daoSpaces.proposeRequestMembership({
+            authorSpaceId: CALLER_SPACE_ID,
+            spaceId: DAO_SPACE_ID,
+            proposalId: PROPOSAL_ID,
+        });
+        const decoded = decodeEnter(result.calldata);
+        const [proposalId, newMemberSpaceId] = decodeAbiParameters([
+            { type: 'bytes16', name: 'proposalId' },
+            { type: 'bytes16', name: 'newMemberSpaceId' },
+        ], decoded.data);
+        expect(result.to).toBe(SPACE_REGISTRY_ADDRESS);
+        expect(result.proposalId).toBe(PROPOSAL_ID);
+        expect(decoded.action).toBe(MEMBERSHIP_REQUESTED_ACTION);
+        expect(decoded.topic).toBe(EMPTY_TOPIC);
+        expect(proposalId).toBe(PROPOSAL_ID);
+        expect(newMemberSpaceId).toBe(CALLER_SPACE_ID);
+    });
+});
+//# sourceMappingURL=dao-spaces.test.js.map

package/dist/src/client/dao-spaces.test.js.map

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

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

@@ -0,0 +1,100 @@
+import type { Id } from '../id.js';
+import { type PublishEditParams } from '../ipfs-core.js';
+import type { GeoClientContext } from './context.js';
+type PublishEditToSpaceParams = PublishEditParams & {
+    spaceId: Id | string;
+};
+export type PublishEditToSpaceCalldataParams = {
+    spaceId: Id | string;
+    cid: `ipfs://${string}`;
+    spaceRegistryAddress: `0x${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 declare function encodePublishEditToSpaceCalldata({ spaceId, cid, spaceRegistryAddress, }: PublishEditToSpaceCalldataParams): {
+    to: `0x${string}`;
+    calldata: `0x${string}`;
+};
+/**
+ * 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 declare function publish(context: GeoClientContext, params: PublishEditParams): Promise<import("../ipfs-core.js").PublishEditResult>;
+/**
+ * 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 declare function publishToSpace(context: GeoClientContext, params: PublishEditToSpaceParams): Promise<{
+    editId: Id;
+    cid: `ipfs://${string}`;
+    to: `0x${string}`;
+    calldata: `0x${string}`;
+}>;
+export {};
+//# sourceMappingURL=edits.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edits.d.ts","sourceRoot":"","sources":["../../../src/client/edits.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAInC,OAAO,EAAE,KAAK,iBAAiB,EAAmB,MAAM,iBAAiB,CAAC;AAG1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD,KAAK,wBAAwB,GAAG,iBAAiB,GAAG;IAClD,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC;IACrB,GAAG,EAAE,UAAU,MAAM,EAAE,CAAC;IACxB,oBAAoB,EAAE,KAAK,MAAM,EAAE,CAAC;CACrC,CAAC;AAcF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gCAAgC,CAAC,EAC/C,OAAO,EACP,GAAG,EACH,oBAAoB,GACrB,EAAE,gCAAgC;;;EAalC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,iBAAiB,wDAM3E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,wBAAwB;;;;;GAgB/F"}

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