@geoprotocol/geo-sdk 0.18.3 → 0.19.1

package/dist/src/client/entity-votes.js

@@ -0,0 +1,168 @@
+import { encodeAbiParameters, encodeFunctionData, keccak256, toHex } from 'viem';
+import { SpaceRegistryAbi } from '../abis/index.js';
+import { assertValid } from '../id-utils.js';
+import { requireGeoContract } from '../networks.js';
+const EMPTY_SIGNATURE = '0x';
+const ENTITY_OBJECT_TYPE = '00000000';
+const ENTITY_VOTE_VERSION = 0;
+const UPVOTED_ACTION = keccak256(toHex('PERMISSIONLESS.UPVOTED'));
+const DOWNVOTED_ACTION = keccak256(toHex('PERMISSIONLESS.DOWNVOTED'));
+const UNVOTED_ACTION = keccak256(toHex('PERMISSIONLESS.UNVOTED'));
+function idToBytes16(id, sourceHint) {
+    const normalized = id.startsWith('0x') ? id.slice(2) : id.replaceAll('-', '');
+    assertValid(normalized, sourceHint);
+    return `0x${normalized.toLowerCase()}`;
+}
+function encodeEntityVoteTopic(entityId) {
+    const normalizedEntityId = idToBytes16(entityId, '`entityId` in entity vote').slice(2);
+    return `0x${ENTITY_OBJECT_TYPE}${normalizedEntityId}${'0'.repeat(24)}`;
+}
+function encodeEntityVoteData(authorSpaceId, spaceId) {
+    return encodeAbiParameters([{ type: 'uint16' }, { type: 'bytes16' }, { type: 'bytes16' }], [ENTITY_VOTE_VERSION, authorSpaceId, spaceId]);
+}
+function encodeEntityVoteCalldata(params, action) {
+    const authorSpaceId = idToBytes16(params.authorSpaceId, '`authorSpaceId` in entity vote');
+    const spaceId = idToBytes16(params.spaceId, '`spaceId` in entity vote');
+    const topic = encodeEntityVoteTopic(params.entityId);
+    const data = encodeEntityVoteData(authorSpaceId, spaceId);
+    const calldata = encodeFunctionData({
+        abi: SpaceRegistryAbi,
+        functionName: 'enter',
+        args: [authorSpaceId, spaceId, action, topic, data, EMPTY_SIGNATURE],
+    });
+    return {
+        to: params.spaceRegistryAddress,
+        calldata,
+    };
+}
+function withSpaceRegistry(context, params) {
+    return {
+        ...params,
+        spaceRegistryAddress: requireGeoContract(context.network, 'SPACE_REGISTRY_ADDRESS'),
+    };
+}
+/**
+ * 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 function encodeUpvoteEntityCalldata(params) {
+    return encodeEntityVoteCalldata(params, UPVOTED_ACTION);
+}
+/**
+ * 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 function encodeDownvoteEntityCalldata(params) {
+    return encodeEntityVoteCalldata(params, DOWNVOTED_ACTION);
+}
+/**
+ * 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 function encodeWithdrawEntityVoteCalldata(params) {
+    return encodeEntityVoteCalldata(params, UNVOTED_ACTION);
+}
+/**
+ * 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 function upvote(context, params) {
+    return encodeUpvoteEntityCalldata(withSpaceRegistry(context, params));
+}
+/**
+ * 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 function downvote(context, params) {
+    return encodeDownvoteEntityCalldata(withSpaceRegistry(context, params));
+}
+/**
+ * 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 function withdraw(context, params) {
+    return encodeWithdrawEntityVoteCalldata(withSpaceRegistry(context, params));
+}
+//# sourceMappingURL=entity-votes.js.map

package/dist/src/client/entity-votes.js.map

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

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

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

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

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

package/dist/src/client/entity-votes.test.js

@@ -0,0 +1,93 @@
+import { decodeAbiParameters, decodeFunctionData } from 'viem';
+import { describe, expect, it } from 'vitest';
+import { SpaceRegistryAbi } from '../abis/index.js';
+import { defineGeoNetworkConfig } from '../networks.js';
+import { downvote, encodeDownvoteEntityCalldata, encodeUpvoteEntityCalldata, encodeWithdrawEntityVoteCalldata, upvote, withdraw, } from './entity-votes.js';
+const AUTHOR_SPACE_ID = '0eed5491b917cf58b33ac81255fe7ae9';
+const SPACE_ID = 'abcdef12345678901234567890abcdef';
+const ENTITY_ID = '11111111111111111111111111111111';
+const SPACE_REGISTRY_ADDRESS = '0x0000000000000000000000000000000000000001';
+const UPVOTED_ACTION = '0x1fc04a8d9387c7bd1199a2a77c8e531a7a7b11991df5dcc8c9acb6abcb481725';
+const DOWNVOTED_ACTION = '0xde8b897ce7cc541dacb388d5aabb3dc0fb7856920284f41582c15b5fc31a8662';
+const UNVOTED_ACTION = '0x3bd4c337382f79aa5007a91169bb57723b5dd59e6b4bb60d20362bcc0d9d998b';
+function testContext() {
+    return {
+        network: defineGeoNetworkConfig({
+            id: 'LOCAL',
+            name: 'Local Geo',
+            apiOrigin: 'http://localhost:3000',
+            contracts: {
+                SPACE_REGISTRY_ADDRESS,
+            },
+        }),
+    };
+}
+function decodeEntityVote(calldata) {
+    const decoded = decodeFunctionData({
+        abi: SpaceRegistryAbi,
+        data: calldata,
+    });
+    expect(decoded.functionName).toBe('enter');
+    const [fromSpaceId, toSpaceId, action, topic, data, signature] = decoded.args;
+    const [version, authorSpaceId, spaceId] = decodeAbiParameters([{ type: 'uint16' }, { type: 'bytes16' }, { type: 'bytes16' }], data);
+    return {
+        fromSpaceId,
+        toSpaceId,
+        action,
+        topic,
+        signature,
+        version,
+        authorSpaceId,
+        spaceId,
+    };
+}
+describe('client entity vote helpers', () => {
+    it('encodes an upvote without context', () => {
+        const result = encodeUpvoteEntityCalldata({
+            authorSpaceId: AUTHOR_SPACE_ID,
+            spaceId: SPACE_ID,
+            entityId: ENTITY_ID,
+            spaceRegistryAddress: SPACE_REGISTRY_ADDRESS,
+        });
+        const decoded = decodeEntityVote(result.calldata);
+        expect(result.to).toBe(SPACE_REGISTRY_ADDRESS);
+        expect(decoded.fromSpaceId).toBe(`0x${AUTHOR_SPACE_ID}`);
+        expect(decoded.toSpaceId).toBe(`0x${SPACE_ID}`);
+        expect(decoded.action).toBe(UPVOTED_ACTION);
+        expect(decoded.topic).toBe(`0x00000000${ENTITY_ID}${'0'.repeat(24)}`);
+        expect(decoded.signature).toBe('0x');
+        expect(decoded.version).toBe(0);
+        expect(decoded.authorSpaceId).toBe(`0x${AUTHOR_SPACE_ID}`);
+        expect(decoded.spaceId).toBe(`0x${SPACE_ID}`);
+    });
+    it('encodes downvote and withdraw variants without context', () => {
+        const base = {
+            authorSpaceId: AUTHOR_SPACE_ID,
+            spaceId: SPACE_ID,
+            entityId: ENTITY_ID,
+            spaceRegistryAddress: SPACE_REGISTRY_ADDRESS,
+        };
+        expect(decodeEntityVote(encodeDownvoteEntityCalldata(base).calldata).action).toBe(DOWNVOTED_ACTION);
+        expect(decodeEntityVote(encodeWithdrawEntityVoteCalldata(base).calldata).action).toBe(UNVOTED_ACTION);
+    });
+    it('uses the configured registry address for context-aware helpers', () => {
+        const context = testContext();
+        const params = {
+            authorSpaceId: AUTHOR_SPACE_ID,
+            spaceId: SPACE_ID,
+            entityId: ENTITY_ID,
+        };
+        expect(upvote(context, params).to).toBe(SPACE_REGISTRY_ADDRESS);
+        expect(decodeEntityVote(downvote(context, params).calldata).action).toBe(DOWNVOTED_ACTION);
+        expect(decodeEntityVote(withdraw(context, params).calldata).action).toBe(UNVOTED_ACTION);
+    });
+    it('throws for invalid ids before encoding', () => {
+        expect(() => encodeUpvoteEntityCalldata({
+            authorSpaceId: 'invalid',
+            spaceId: SPACE_ID,
+            entityId: ENTITY_ID,
+            spaceRegistryAddress: SPACE_REGISTRY_ADDRESS,
+        })).toThrow('Invalid id: "invalid" for `authorSpaceId` in entity vote');
+    });
+});
+//# sourceMappingURL=entity-votes.test.js.map

package/dist/src/client/entity-votes.test.js.map

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

package/dist/src/client/graph-workflows.test.d.ts

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

package/dist/src/client/graph-workflows.test.d.ts.map

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

package/dist/src/client/graph-workflows.test.js

@@ -0,0 +1,83 @@
+import { describe, expect, it, vi } from 'vitest';
+import { createGeoClient } from '../client.js';
+import { REPLY_TO_PROPERTY } from '../core/ids/system.js';
+import { toGrcId } from '../id-utils.js';
+import { defineGeoNetworkConfig } from '../networks.js';
+const ENTITY_ID = '3af3e22d21694a078681516710b7ecf1';
+const SPACE_ID = 'd4bc2f205e2d415e971eb0b9fbf6b6fc';
+const COMMENT_A_ID = 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa';
+const ROOT_ENTITY_ID = 'bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb';
+const ROOT_SPACE_ID = 'cccccccccccccccccccccccccccccccc';
+const PROPERTY_ID = 'dddddddddddddddddddddddddddddddd';
+const RELATION_ID = 'eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee';
+function customNetwork() {
+    return defineGeoNetworkConfig({
+        id: 'LOCAL',
+        name: 'Local Geo',
+        apiOrigin: 'http://localhost:3000',
+    });
+}
+function replyToRelations(ops) {
+    return ops.filter((op) => op.type === 'createRelation' &&
+        op.relationType.every((byte, index) => byte === toGrcId(REPLY_TO_PROPERTY)[index]));
+}
+describe('geo graph workflow clients', () => {
+    it('creates comment reply chains from fetched parent context', async () => {
+        const fetch = vi.fn().mockResolvedValue(new Response(JSON.stringify({
+            data: {
+                entity: {
+                    relationsList: [
+                        {
+                            toEntity: { id: ROOT_ENTITY_ID },
+                            toSpace: { id: ROOT_SPACE_ID },
+                            position: 'a1',
+                        },
+                        {
+                            toEntity: { id: COMMENT_A_ID },
+                            toSpace: { id: SPACE_ID },
+                            position: 'a0',
+                        },
+                    ],
+                },
+            },
+        })));
+        const geo = createGeoClient({ network: customNetwork(), fetch });
+        const result = await geo.comments.create({
+            id: 'ffffffffffffffffffffffffffffffff',
+            content: 'Deep reply',
+            replyTo: { entityId: ENTITY_ID, spaceId: SPACE_ID },
+        });
+        const relations = replyToRelations(result.ops);
+        expect(relations).toHaveLength(3);
+        expect(relations[0]?.to).toEqual(toGrcId(ENTITY_ID));
+        expect(relations[1]?.to).toEqual(toGrcId(COMMENT_A_ID));
+        expect(relations[2]?.to).toEqual(toGrcId(ROOT_ENTITY_ID));
+        expect(relations[0]?.toSpace).toEqual(toGrcId(SPACE_ID));
+        expect(relations[2]?.toSpace).toEqual(toGrcId(ROOT_SPACE_ID));
+        expect(fetch).toHaveBeenCalledWith('http://localhost:3000/graphql', expect.objectContaining({ method: 'POST' }));
+    });
+    it('deletes an entity using fetched values and relations for the requested space', async () => {
+        const fetch = vi.fn().mockResolvedValue(new Response(JSON.stringify({
+            data: {
+                entity: {
+                    valuesList: [
+                        { propertyId: PROPERTY_ID, spaceId: SPACE_ID },
+                        { propertyId: PROPERTY_ID, spaceId: SPACE_ID },
+                        { propertyId: ROOT_ENTITY_ID, spaceId: ROOT_SPACE_ID },
+                    ],
+                    relationsList: [
+                        { id: RELATION_ID, spaceId: SPACE_ID },
+                        { id: COMMENT_A_ID, spaceId: ROOT_SPACE_ID },
+                    ],
+                },
+            },
+        })));
+        const geo = createGeoClient({ network: customNetwork(), fetch });
+        const result = await geo.entities.delete({ id: ENTITY_ID, spaceId: SPACE_ID });
+        expect(result.id).toBe(ENTITY_ID);
+        expect(result.ops.map(op => op.type)).toEqual(['updateEntity', 'deleteRelation']);
+        expect(result.ops[0].unset).toHaveLength(1);
+        expect(fetch).toHaveBeenCalledWith('http://localhost:3000/graphql', expect.objectContaining({ method: 'POST' }));
+    });
+});
+//# sourceMappingURL=graph-workflows.test.js.map

package/dist/src/client/graph-workflows.test.js.map

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

package/dist/src/client/images-storage.test.d.ts

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

package/dist/src/client/images-storage.test.d.ts.map

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

package/dist/src/client/images-storage.test.js

@@ -0,0 +1,52 @@
+import { describe, expect, it, vi } from 'vitest';
+import { createGeoClient } from '../client.js';
+import { IMAGE_URL_PROPERTY } from '../core/ids/system.js';
+import { toGrcId } from '../id-utils.js';
+import { defineGeoNetworkConfig } from '../networks.js';
+const CID = 'ipfs://bafkreigwfjixq5cm3s4youhshorkpqh3ykpviyv76c2ei6gaalujtlqz5i';
+const IMAGE_ID = '3af3e22d21694a078681516710b7ecf1';
+function customNetwork() {
+    return defineGeoNetworkConfig({
+        id: 'LOCAL',
+        name: 'Local Geo',
+        apiOrigin: 'http://localhost:3000',
+    });
+}
+function mockUploadFetch() {
+    return vi.fn().mockImplementation(async () => new Response(JSON.stringify({ cid: CID })));
+}
+function imageUrlValue(entityOp) {
+    return entityOp.values.find(value => value.property.every((byte, index) => byte === toGrcId(IMAGE_URL_PROPERTY)[index]));
+}
+describe('geo image and storage clients', () => {
+    it('uploads an image through the configured API origin before creating image ops', async () => {
+        const fetch = mockUploadFetch();
+        const geo = createGeoClient({ network: customNetwork(), fetch });
+        const result = await geo.images.create({
+            id: IMAGE_ID,
+            name: 'Test image',
+            blob: new Blob([new Uint8Array([0, 0, 0, 0])], { type: 'image/png' }),
+        });
+        const entityOp = result.ops[0];
+        const urlValue = imageUrlValue(entityOp);
+        expect(result.id).toBe(IMAGE_ID);
+        expect(result.cid).toBe(CID);
+        expect(urlValue?.value.type).toBe('text');
+        if (urlValue?.value.type === 'text') {
+            expect(urlValue.value.value).toBe(CID);
+        }
+        expect(fetch).toHaveBeenCalledWith('http://localhost:3000/ipfs/upload-file', expect.objectContaining({ method: 'POST' }));
+    });
+    it('uses configured upload routes for storage helpers', async () => {
+        const fetch = mockUploadFetch();
+        const geo = createGeoClient({ network: customNetwork(), fetch });
+        await expect(geo.storage.uploadImage({
+            blob: new Blob([new Uint8Array([0, 0, 0, 0])], { type: 'image/png' }),
+            alternativeGateway: true,
+        })).resolves.toEqual({ cid: CID });
+        await expect(geo.storage.uploadCSV('a,b\n1,2')).resolves.toBe(CID);
+        expect(fetch).toHaveBeenNthCalledWith(1, 'http://localhost:3000/ipfs/upload-file-alternative-gateway', expect.objectContaining({ method: 'POST' }));
+        expect(fetch).toHaveBeenNthCalledWith(2, 'http://localhost:3000/ipfs/upload-edit', expect.objectContaining({ method: 'POST' }));
+    });
+});
+//# sourceMappingURL=images-storage.test.js.map

package/dist/src/client/images-storage.test.js.map

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

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

@@ -0,0 +1,35 @@
+import { Id } from '../id.js';
+import { type PublishImageParams } from '../ipfs-core.js';
+import type { CreateImageResult } from '../types.js';
+import type { GeoClientContext } from './context.js';
+export type CreateImageParams = PublishImageParams & {
+    name?: string;
+    description?: string;
+    id?: Id | string;
+    alternativeGateway?: boolean;
+};
+/**
+ * Uploads an image and builds the corresponding image entity ops.
+ *
+ * This is the context-aware image workflow used by `geo.images.create(...)`.
+ * It uploads the image through the configured API origin, attempts to read
+ * image dimensions, then creates image entity ops.
+ *
+ * @example
+ * ```ts
+ * const { id, cid, dimensions, ops } = await geo.images.create({
+ *   url: 'https://example.com/cover.png',
+ *   name: 'Cover image',
+ *   description: 'Image used as the space cover.',
+ * });
+ *
+ * console.log(id, cid, dimensions);
+ * ```
+ *
+ * @param context Client context containing network and fetch configuration.
+ * @param params Image source plus optional entity metadata.
+ * @returns Created image entity ID, uploaded CID, dimensions when detected, and ops.
+ * @throws When the optional ID is invalid, fetch is unavailable, upload fails, or the CID response is invalid.
+ */
+export declare function create(context: GeoClientContext, params: CreateImageParams): Promise<CreateImageResult>;
+//# sourceMappingURL=images.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../../src/client/images.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAE9B,OAAO,EAAE,KAAK,kBAAkB,EAAmB,MAAM,iBAAiB,CAAC;AAE3E,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,aAAa,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,GAAG;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,iBAAiB,8BAgBhF"}

package/dist/src/client/images.js

@@ -0,0 +1,90 @@
+import { createRelation as grcCreateRelation } from '@geoprotocol/grc-20';
+import { IMAGE_HEIGHT_PROPERTY, IMAGE_TYPE, IMAGE_URL_PROPERTY, IMAGE_WIDTH_PROPERTY, TYPES_PROPERTY, } from '../core/ids/system.js';
+import { Id } from '../id.js';
+import { assertValid, generate, toGrcId } from '../id-utils.js';
+import { uploadImageCore } from '../ipfs-core.js';
+import { create as createEntity } from '../ops/entities.js';
+import { requireFetch } from './context.js';
+/**
+ * Uploads an image and builds the corresponding image entity ops.
+ *
+ * This is the context-aware image workflow used by `geo.images.create(...)`.
+ * It uploads the image through the configured API origin, attempts to read
+ * image dimensions, then creates image entity ops.
+ *
+ * @example
+ * ```ts
+ * const { id, cid, dimensions, ops } = await geo.images.create({
+ *   url: 'https://example.com/cover.png',
+ *   name: 'Cover image',
+ *   description: 'Image used as the space cover.',
+ * });
+ *
+ * console.log(id, cid, dimensions);
+ * ```
+ *
+ * @param context Client context containing network and fetch configuration.
+ * @param params Image source plus optional entity metadata.
+ * @returns Created image entity ID, uploaded CID, dimensions when detected, and ops.
+ * @throws When the optional ID is invalid, fetch is unavailable, upload fails, or the CID response is invalid.
+ */
+export async function create(context, params) {
+    if (params.id)
+        assertValid(params.id, '`id` in `createImage`');
+    const { cid, dimensions } = await uploadImageCore({
+        ...params,
+        apiOrigin: context.network.apiOrigin,
+        fetch: requireFetch(context, 'Image creation'),
+    });
+    return createImageOps({
+        id: params.id,
+        name: params.name,
+        description: params.description,
+        cid,
+        dimensions,
+    });
+}
+function createImageOps({ cid, dimensions, name, description, id: providedId, }) {
+    const id = providedId ?? generate();
+    const values = [
+        {
+            property: IMAGE_URL_PROPERTY,
+            type: 'text',
+            value: cid,
+        },
+    ];
+    if (dimensions?.height) {
+        values.push({
+            property: IMAGE_HEIGHT_PROPERTY,
+            type: 'float',
+            value: dimensions.height,
+        });
+    }
+    if (dimensions?.width) {
+        values.push({
+            property: IMAGE_WIDTH_PROPERTY,
+            type: 'float',
+            value: dimensions.width,
+        });
+    }
+    const result = createEntity({
+        id,
+        name,
+        description,
+        values,
+    });
+    result.ops.push(grcCreateRelation({
+        id: toGrcId(generate()),
+        entity: toGrcId(generate()),
+        from: toGrcId(id),
+        to: toGrcId(IMAGE_TYPE),
+        relationType: toGrcId(TYPES_PROPERTY),
+    }));
+    return {
+        id: Id(id),
+        cid,
+        dimensions,
+        ops: result.ops,
+    };
+}
+//# sourceMappingURL=images.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","sourceRoot":"","sources":["../../../src/client/images.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAA2B,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG5D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAS5C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAyB,EAAE,MAAyB;IAC/E,IAAI,MAAM,CAAC,EAAE;QAAE,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,uBAAuB,CAAC,CAAC;IAE/D,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,MAAM,eAAe,CAAC;QAChD,GAAG,MAAM;QACT,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS;QACpC,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,gBAAgB,CAAC;KAC/C,CAAC,CAAC;IAEH,OAAO,cAAc,CAAC;QACpB,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,GAAG;QACH,UAAU;KACX,CAAC,CAAC;AACL,CAAC;AAUD,SAAS,cAAc,CAAC,EACtB,GAAG,EACH,UAAU,EACV,IAAI,EACJ,WAAW,EACX,EAAE,EAAE,UAAU,GACO;IACrB,MAAM,EAAE,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC;IACpC,MAAM,MAAM,GAAoB;QAC9B;YACE,QAAQ,EAAE,kBAAkB;YAC5B,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,GAAG;SACX;KACF,CAAC;IAEF,IAAI,UAAU,EAAE,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC;YACV,QAAQ,EAAE,qBAAqB;YAC/B,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,UAAU,CAAC,MAAM;SACzB,CAAC,CAAC;IACL,CAAC;IACD,IAAI,UAAU,EAAE,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC;YACV,QAAQ,EAAE,oBAAoB;YAC9B,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,UAAU,CAAC,KAAK;SACxB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,EAAE;QACF,IAAI;QACJ,WAAW;QACX,MAAM;KACP,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,IAAI,CACb,iBAAiB,CAAC;QAChB,EAAE,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC3B,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;QACjB,EAAE,EAAE,OAAO,CAAC,UAAU,CAAC;QACvB,YAAY,EAAE,OAAO,CAAC,cAAc,CAAC;KACtC,CAAC,CACH,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QACV,GAAG;QACH,UAAU;QACV,GAAG,EAAE,MAAM,CAAC,GAAG;KAChB,CAAC;AACJ,CAAC"}