@geoprotocol/geo-sdk 0.18.3 → 0.19.0

package/dist/src/client.js

@@ -0,0 +1,452 @@
+import * as Api from './client/api.js';
+import * as Comments from './client/comments.js';
+import * as DaoSpaces from './client/dao-spaces.js';
+import { deleteEntity } from './client/entities.js';
+import * as EntityVotes from './client/entity-votes.js';
+import * as PersonalSpaces from './client/personal-spaces.js';
+import { defineGeoNetworkConfig } from './networks.js';
+/**
+ * Creates a configured Geo SDK client.
+ *
+ * The client groups the SDK into namespaces by workflow:
+ * - `api`, `storage`, `images`, `comments`, and delete helpers use the
+ *   configured API origin and fetch implementation.
+ * - transaction/calldata helpers use contract addresses from the configured
+ *   network.
+ *
+ * @example
+ * ```ts
+ * import { createGeoClient, GeoTestnetConfig } from '@geoprotocol/geo-sdk';
+ * import * as Ops from '@geoprotocol/geo-sdk/ops';
+ *
+ * const geo = createGeoClient({ network: GeoTestnetConfig });
+ * const { ops } = Ops.entities.create({ name: 'Geo entity' });
+ * const edit = await geo.personalSpaces.publishEdit({
+ *   name: 'Create entity',
+ *   spaceId,
+ *   author,
+ *   ops,
+ * });
+ * ```
+ *
+ * @example
+ * Create a client for a custom deployment.
+ *
+ * ```ts
+ * import { createGeoClient, defineGeoNetworkConfig } from '@geoprotocol/geo-sdk';
+ *
+ * const local = defineGeoNetworkConfig({
+ *   id: 'LOCAL',
+ *   name: 'Local Geo',
+ *   apiOrigin: 'http://localhost:3000',
+ *   chain: { id: 31337, name: 'Anvil', rpcUrl: 'http://localhost:8545' },
+ *   contracts: {
+ *     SPACE_REGISTRY_ADDRESS: '0x...',
+ *     DAO_SPACE_FACTORY_ADDRESS: '0x...',
+ *   },
+ * });
+ *
+ * const geo = createGeoClient({ network: local });
+ * ```
+ *
+ * @param params Network and fetch configuration for context-aware helpers.
+ * @returns A configured client with API helpers and transaction workflows.
+ */
+export function createGeoClient(params) {
+    if (!params?.network) {
+        throw new Error('createGeoClient requires a Geo network config. Pass GeoTestnetConfig or defineGeoNetworkConfig().');
+    }
+    if (typeof params.network === 'string') {
+        throw new Error('createGeoClient requires a full Geo network config. Pass GeoTestnetConfig or defineGeoNetworkConfig().');
+    }
+    const fetchFn = params.fetch ?? globalThis.fetch;
+    const context = {
+        network: defineGeoNetworkConfig(params.network),
+        fetch: fetchFn,
+    };
+    return {
+        /** The resolved network configuration used by this client. */
+        network: context.network,
+        /** Low-level API helpers that use the configured API origin. */
+        api: {
+            /**
+             * Sends a GraphQL request to the configured Geo API.
+             *
+             * This returns the raw GraphQL envelope so callers can inspect `errors`
+             * when they want custom error handling.
+             *
+             * @example
+             * ```ts
+             * const response = await geo.api.graphql<{
+             *   entity: { id: string } | null;
+             * }>(`
+             *   query {
+             *     entity(id: "3af3e22d21694a078681516710b7ecf1") {
+             *       id
+             *     }
+             *   }
+             * `);
+             * ```
+             */
+            async graphql(query) {
+                return Api.graphqlRequest(context, query);
+            },
+            /**
+             * Requests edit calldata from the configured Geo API for a published edit CID.
+             *
+             * @example
+             * ```ts
+             * const { to, data } = await geo.api.getEditCalldata({
+             *   spaceId,
+             *   cid: 'ipfs://baf...',
+             * });
+             * ```
+             */
+            async getEditCalldata(params) {
+                return Api.getEditCalldata(context, params);
+            },
+        },
+        /** IPFS upload helpers for files and CSV data. */
+        storage: {
+            /**
+             * Uploads an image file or URL and returns the uploaded CID plus image dimensions when detected.
+             *
+             * @example
+             * ```ts
+             * const uploaded = await geo.storage.uploadImage({
+             *   url: 'https://example.com/photo.png',
+             * });
+             *
+             * console.log(uploaded.cid, uploaded.dimensions);
+             * ```
+             */
+            async uploadImage(params) {
+                const { uploadImage } = await import('./client/storage.js');
+                return uploadImage(context, params);
+            },
+            /**
+             * Compresses and uploads CSV content, returning the uploaded IPFS URI.
+             *
+             * @example
+             * ```ts
+             * const cid = await geo.storage.uploadCSV('name,score\nAlice,10');
+             * ```
+             */
+            async uploadCSV(csvString) {
+                const { uploadCSV } = await import('./client/storage.js');
+                return uploadCSV(context, csvString);
+            },
+        },
+        /** Entity helpers that need graph context from the configured API. */
+        entities: {
+            /**
+             * Fetches current entity values and relations from the configured API, then builds delete ops.
+             *
+             * @example
+             * ```ts
+             * const { ops } = await geo.entities.delete({
+             *   id: entityId,
+             *   spaceId,
+             * });
+             * ```
+             */
+            delete: (params) => deleteEntity(context, params),
+        },
+        /** Image workflow helpers. */
+        images: {
+            /**
+             * Uploads an image, detects dimensions when possible, and builds image entity ops.
+             *
+             * @example
+             * ```ts
+             * const image = await geo.images.create({
+             *   url: 'https://example.com/cover.png',
+             *   name: 'Cover image',
+             * });
+             * ```
+             */
+            async create(params) {
+                const { create } = await import('./client/images.js');
+                return create(context, params);
+            },
+        },
+        /** Comment operation helpers. */
+        comments: {
+            /**
+             * Fetches reply-to context for the target entity and builds comment creation ops.
+             *
+             * @example
+             * ```ts
+             * const comment = await geo.comments.create({
+             *   content: 'Looks good to me',
+             *   replyTo: { entityId, spaceId },
+             * });
+             * ```
+             */
+            create: (params) => Comments.create(context, params),
+            /**
+             * Builds update-comment ops.
+             *
+             * @example
+             * ```ts
+             * const { ops } = geo.comments.update({
+             *   id: commentId,
+             *   resolved: true,
+             * });
+             * ```
+             */
+            update: Comments.update,
+        },
+        /** Personal-space transaction helpers. */
+        personalSpaces: {
+            /**
+             * Returns calldata for creating a personal space with the configured registry.
+             *
+             * @example
+             * ```ts
+             * const { to, calldata, ops } = geo.personalSpaces.create({
+             *   name: 'Alice',
+             *   accountAddress: account.address,
+             * });
+             *
+             * await walletClient.sendTransaction({ to, data: calldata });
+             * ```
+             */
+            create: (params) => PersonalSpaces.create(context, params),
+            /**
+             * Returns calldata for setting a personal space topic.
+             *
+             * @example
+             * ```ts
+             * const topicTx = geo.personalSpaces.setTopic({
+             *   spaceId,
+             *   topicId: createSpace.spaceEntityId,
+             * });
+             * ```
+             */
+            setTopic: (params) => PersonalSpaces.setTopic(context, params),
+            /**
+             * Checks whether an address already has a personal space.
+             *
+             * @example
+             * ```ts
+             * const hasExistingSpace = await geo.personalSpaces.hasSpace({
+             *   address: account.address,
+             * });
+             * ```
+             */
+            hasSpace: (params) => PersonalSpaces.hasSpace(context, params),
+            /**
+             * Publishes an edit and returns calldata for submitting it to a personal space.
+             *
+             * @example
+             * ```ts
+             * const tx = await geo.personalSpaces.publishEdit({
+             *   name: 'Create entity',
+             *   spaceId,
+             *   author: spaceId,
+             *   ops,
+             * });
+             * ```
+             */
+            publishEdit: (params) => PersonalSpaces.publishEdit(context, params),
+        },
+        /** DAO-space transaction helpers. */
+        daoSpaces: {
+            /**
+             * Publishes the initial DAO edit and returns calldata for creating a DAO space.
+             *
+             * @example
+             * ```ts
+             * const tx = await geo.daoSpaces.create({
+             *   name: 'Research DAO',
+             *   author: authorSpaceId,
+             *   initialEditorSpaceIds: [authorSpaceId],
+             *   votingSettings: {
+             *     slowPathPercentageThreshold: 50,
+             *     fastPathFlatThreshold: 1,
+             *     quorum: 1,
+             *     durationInDays: 2,
+             *   },
+             * });
+             * ```
+             */
+            create: (params) => DaoSpaces.create(context, params),
+            /**
+             * Publishes an edit and wraps it in a DAO-space proposal action.
+             *
+             * @example
+             * ```ts
+             * const proposal = await geo.daoSpaces.proposeEdit({
+             *   name: 'Publish edit',
+             *   ops,
+             *   author: authorSpaceId,
+             *   daoSpaceAddress,
+             *   callerSpaceId: authorSpaceId,
+             *   daoSpaceId,
+             * });
+             * ```
+             */
+            proposeEdit: (params) => DaoSpaces.proposeEdit(context, params),
+            /**
+             * Builds calldata for a DAO proposal that adds a member.
+             *
+             * @example
+             * ```ts
+             * const tx = geo.daoSpaces.proposeAddMember({
+             *   authorSpaceId,
+             *   spaceId: daoSpaceId,
+             *   daoSpaceAddress,
+             *   newMemberSpaceId: memberSpaceId,
+             * });
+             * ```
+             */
+            proposeAddMember: (params) => DaoSpaces.proposeAddMember(context, params),
+            /**
+             * Builds calldata for a DAO proposal that removes a member.
+             *
+             * @example
+             * ```ts
+             * const tx = geo.daoSpaces.proposeRemoveMember({
+             *   authorSpaceId,
+             *   spaceId: daoSpaceId,
+             *   daoSpaceAddress,
+             *   memberToRemoveSpaceId,
+             * });
+             * ```
+             */
+            proposeRemoveMember: (params) => DaoSpaces.proposeRemoveMember(context, params),
+            /**
+             * Builds calldata for a DAO proposal that adds an editor.
+             *
+             * @example
+             * ```ts
+             * const tx = geo.daoSpaces.proposeAddEditor({
+             *   authorSpaceId,
+             *   spaceId: daoSpaceId,
+             *   daoSpaceAddress,
+             *   newEditorSpaceId: editorSpaceId,
+             * });
+             * ```
+             */
+            proposeAddEditor: (params) => DaoSpaces.proposeAddEditor(context, params),
+            /**
+             * Builds calldata for a DAO proposal that removes an editor.
+             *
+             * @example
+             * ```ts
+             * const tx = geo.daoSpaces.proposeRemoveEditor({
+             *   authorSpaceId,
+             *   spaceId: daoSpaceId,
+             *   daoSpaceAddress,
+             *   editorToRemoveSpaceId,
+             * });
+             * ```
+             */
+            proposeRemoveEditor: (params) => DaoSpaces.proposeRemoveEditor(context, params),
+            /**
+             * Builds calldata for requesting membership in a DAO space.
+             *
+             * @example
+             * ```ts
+             * const tx = geo.daoSpaces.proposeRequestMembership({
+             *   authorSpaceId: requesterSpaceId,
+             *   spaceId: daoSpaceId,
+             * });
+             * ```
+             */
+            proposeRequestMembership: (params) => DaoSpaces.proposeRequestMembership(context, params),
+            /** DAO-scoped low-level proposal helpers. */
+            proposals: {
+                /**
+                 * Builds calldata for creating a DAO proposal from prebuilt actions.
+                 *
+                 * @example
+                 * ```ts
+                 * const action = geo.daoSpaces.proposals.actions.addMember(daoSpaceAddress, memberSpaceId);
+                 * const tx = geo.daoSpaces.proposals.create({
+                 *   fromSpaceId: authorSpaceId,
+                 *   daoSpaceId,
+                 *   actions: [action],
+                 * });
+                 * ```
+                 */
+                create: (params) => DaoSpaces.createProposal(context, params),
+                /**
+                 * Builds calldata for voting on a DAO proposal.
+                 *
+                 * @example
+                 * ```ts
+                 * const tx = geo.daoSpaces.proposals.vote({
+                 *   authorSpaceId,
+                 *   spaceId: daoSpaceId,
+                 *   proposalId,
+                 *   vote: 'YES',
+                 * });
+                 * ```
+                 */
+                vote: (params) => DaoSpaces.voteProposal(context, params),
+                /**
+                 * Builds calldata for executing a passed DAO proposal.
+                 *
+                 * @example
+                 * ```ts
+                 * const tx = geo.daoSpaces.proposals.execute({
+                 *   authorSpaceId,
+                 *   spaceId: daoSpaceId,
+                 *   proposalId,
+                 * });
+                 * ```
+                 */
+                execute: (params) => DaoSpaces.executeProposal(context, params),
+                /**
+                 * Helpers for constructing DAO proposal actions.
+                 *
+                 * @example
+                 * ```ts
+                 * const actions = [
+                 *   geo.daoSpaces.proposals.actions.addEditor(daoSpaceAddress, editorSpaceId),
+                 *   geo.daoSpaces.proposals.actions.updateVotingSettings(daoSpaceAddress, votingSettings),
+                 * ];
+                 * ```
+                 */
+                actions: DaoSpaces.actions,
+            },
+        },
+        /** Entity vote transaction helpers. */
+        entityVotes: {
+            /**
+             * Builds calldata for upvoting an entity.
+             *
+             * @example
+             * ```ts
+             * const tx = geo.entityVotes.upvote({
+             *   authorSpaceId,
+             *   spaceId,
+             *   entityId,
+             * });
+             * ```
+             */
+            upvote: (params) => EntityVotes.upvote(context, params),
+            /**
+             * Builds calldata for downvoting an entity.
+             *
+             * @example
+             * ```ts
+             * const tx = geo.entityVotes.downvote({ authorSpaceId, spaceId, entityId });
+             * ```
+             */
+            downvote: (params) => EntityVotes.downvote(context, params),
+            /**
+             * Builds calldata for withdrawing an entity vote.
+             *
+             * @example
+             * ```ts
+             * const tx = geo.entityVotes.withdraw({ authorSpaceId, spaceId, entityId });
+             * ```
+             */
+            withdraw: (params) => EntityVotes.withdraw(context, params),
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/src/client.js.map

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

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

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

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

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

package/dist/src/client.test.js

@@ -0,0 +1,120 @@
+import { describe, expect, it, vi } from 'vitest';
+import { createGeoClient } from './client.js';
+import { defineGeoNetworkConfig, GeoTestnetConfig } from './networks.js';
+import * as Ops from './ops/index.js';
+describe('createGeoClient', () => {
+    const customNetwork = () => defineGeoNetworkConfig({
+        id: 'LOCAL',
+        name: 'Local Geo',
+        apiOrigin: 'http://localhost:3000',
+        contracts: {
+            SPACE_REGISTRY_ADDRESS: '0x0000000000000000000000000000000000000001',
+            DAO_SPACE_FACTORY_ADDRESS: '0x0000000000000000000000000000000000000002',
+        },
+    });
+    it('accepts the built-in TESTNET config', () => {
+        const geo = createGeoClient({ network: GeoTestnetConfig });
+        expect(geo.network.id).toBe('TESTNET');
+        expect(geo.network.apiOrigin).toBe(GeoTestnetConfig.apiOrigin);
+    });
+    it('accepts custom network configs', () => {
+        const fetch = vi.fn();
+        const local = customNetwork();
+        const geo = createGeoClient({ network: local, fetch });
+        expect(geo.network.id).toBe('LOCAL');
+        expect(geo.network.contracts?.SPACE_REGISTRY_ADDRESS).toBe('0x0000000000000000000000000000000000000001');
+    });
+    it('only exposes graph-context entity helpers on the client', () => {
+        const geo = createGeoClient({ network: customNetwork() });
+        expect(Object.keys(geo.entities)).toEqual(['delete']);
+    });
+    it('scopes proposal helpers under daoSpaces', () => {
+        const geo = createGeoClient({ network: customNetwork() });
+        expect('edits' in geo).toBe(false);
+        expect('proposals' in geo).toBe(false);
+        expect(Object.keys(geo.daoSpaces)).toEqual([
+            'create',
+            'proposeEdit',
+            'proposeAddMember',
+            'proposeRemoveMember',
+            'proposeAddEditor',
+            'proposeRemoveEditor',
+            'proposeRequestMembership',
+            'proposals',
+        ]);
+    });
+    it('requires an explicit network config', () => {
+        expect(() => createGeoClient(undefined)).toThrow('requires a Geo network config');
+    });
+    it('rejects string network IDs', () => {
+        expect(() => createGeoClient({ network: 'TESTNET' })).toThrow('requires a full Geo network config');
+    });
+    it('allows sync calldata helpers without global fetch', () => {
+        const originalFetch = globalThis.fetch;
+        vi.stubGlobal('fetch', undefined);
+        try {
+            const geo = createGeoClient({ network: GeoTestnetConfig });
+            const result = geo.personalSpaces.create({
+                name: 'Test Space',
+                accountAddress: '0x1234567890123456789012345678901234567890',
+            });
+            expect(result.calldata).toMatch(/^0x/);
+        }
+        finally {
+            vi.stubGlobal('fetch', originalFetch);
+        }
+    });
+    it('validates required contracts before upload-backed workflows', async () => {
+        const fetch = vi.fn();
+        const geo = createGeoClient({
+            network: defineGeoNetworkConfig({
+                id: 'LOCAL',
+                name: 'Local Geo',
+                apiOrigin: 'http://localhost:3000',
+                contracts: {
+                    SPACE_REGISTRY_ADDRESS: '0x0000000000000000000000000000000000000001',
+                },
+            }),
+            fetch,
+        });
+        await expect(geo.daoSpaces.create({
+            name: 'Test DAO',
+            author: '5cade5757ecd41ae83481b22ffc2f94e',
+            votingSettings: {
+                slowPathPercentageThreshold: 50,
+                fastPathFlatThreshold: 1,
+                quorum: 1,
+                durationInDays: 2,
+            },
+            initialEditorSpaceIds: ['0x11111111111111111111111111111111'],
+        })).rejects.toThrow('DAO_SPACE_FACTORY_ADDRESS');
+        expect(fetch).not.toHaveBeenCalled();
+    });
+    it('uses configured fetch and registry address for personal space edit publishing', async () => {
+        const fetch = vi
+            .fn()
+            .mockResolvedValue(new Response(JSON.stringify({ cid: 'ipfs://bafkreigwfjixq5cm3s4youhshorkpqh3ykpviyv76c2ei6gaalujtlqz5i' })));
+        const geo = createGeoClient({ network: customNetwork(), fetch });
+        const { ops } = Ops.entities.create({ name: 'Test Entity' });
+        const result = await geo.personalSpaces.publishEdit({
+            name: 'Test Edit',
+            spaceId: '0eed5491b917cf58b33ac81255fe7ae9',
+            ops,
+            author: '5cade5757ecd41ae83481b22ffc2f94e',
+        });
+        expect(result.to).toBe('0x0000000000000000000000000000000000000001');
+        expect(result.cid).toBe('ipfs://bafkreigwfjixq5cm3s4youhshorkpqh3ykpviyv76c2ei6gaalujtlqz5i');
+        expect(fetch).toHaveBeenCalledWith('http://localhost:3000/ipfs/upload-edit', expect.objectContaining({ method: 'POST' }));
+    });
+    it('uses configured registry address for entity votes without fetch', () => {
+        const geo = createGeoClient({ network: customNetwork() });
+        const result = geo.entityVotes.upvote({
+            authorSpaceId: '0eed5491b917cf58b33ac81255fe7ae9',
+            spaceId: 'abcdef12345678901234567890abcdef',
+            entityId: '11111111111111111111111111111111',
+        });
+        expect(result.to).toBe('0x0000000000000000000000000000000000000001');
+        expect(result.calldata).toMatch(/^0x/);
+    });
+});
+//# sourceMappingURL=client.test.js.map

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

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