@geoprotocol/geo-sdk 0.18.2 → 0.19.0

package/dist/src/ipfs.js

@@ -4,190 +4,47 @@
  *
  * @since 0.1.1
  */
-import { encodeEdit, randomId } from '@geoprotocol/grc-20';
-import { Micro } from 'effect';
-import { gzipSync } from 'fflate';
-import { imageSize } from 'image-size';
-import { getApiOrigin } from './graph/constants.js';
-import { assertValid, fromBytes, toGrcId } from './id-utils.js';
-class IpfsUploadError extends Error {
-    _tag = 'IpfsUploadError';
-}
+import { publishEditCore, uploadCSVCore, uploadImageCore } from './ipfs-core.js';
+import { resolveGeoNetwork } from './networks.js';
 /**
  * Generates correct GRC-20 v2 binary encoding for an Edit and uploads it to IPFS.
  *
- * @example
- * ```ts
- * import { IPFS } from '@geoprotocol/geo-sdk';
- *
- * const { cid, editId } = await IPFS.publishEdit({
- *   name: 'Edit name',
- *   ops: ops,
- *   author: 'your-personal-space-id',
- * });
- * ```
- *
- * @param args arguments for publishing an edit to IPFS {@link PublishEditProposalParams}
- * @returns - {@link PublishEditResult}
+ * @deprecated Use `createGeoClient({ network }).personalSpaces.publishEdit(...)` or
+ * `createGeoClient({ network }).daoSpaces.proposeEdit(...)`.
  */
 export async function publishEdit(args) {
-    const { name, ops, author, network = 'TESTNET' } = args;
-    if (ops.length === 0) {
-        throw new Error('`ops` in `publishEdit` must not be empty');
-    }
-    assertValid(author, '`author` in `publishEdit`');
-    // Generate a new edit ID
-    const editId = randomId();
-    // Build the GRC-20 v2 Edit structure
-    const grcEdit = {
-        id: editId,
-        name,
-        authors: [toGrcId(author)],
-        createdAt: BigInt(Date.now()) * 1000n, // Convert to microseconds
-        ops,
-    };
-    // Encode to binary format
-    const binary = encodeEdit(grcEdit);
-    const MAX_EDIT_SIZE = 10 * 1024 * 1024; // 10MB
-    if (binary.byteLength > MAX_EDIT_SIZE) {
-        throw new Error(`Edit size (${(binary.byteLength / 1024 / 1024).toFixed(2)}MB) exceeds the ${MAX_EDIT_SIZE / 1024 / 1024}MB limit. Reduce the number of ops or split into multiple edits.`);
-    }
-    // Create a copy to ensure we have a regular ArrayBuffer for Blob compatibility
-    const binaryArray = new Uint8Array(binary);
-    const blob = new Blob([binaryArray], { type: 'application/octet-stream' });
-    const formData = new FormData();
-    formData.append('file', blob);
-    const cid = await Micro.runPromise(uploadBinary(formData, network));
-    // Convert the GrcId back to a grc-20-ts Id string
-    const editIdString = fromBytes(editId);
-    return { cid, editId: editIdString };
+    const { network = 'TESTNET', ...params } = args;
+    const config = resolveGeoNetwork(network);
+    return publishEditCore({
+        ...params,
+        apiOrigin: config.apiOrigin,
+        fetch: globalThis.fetch,
+    });
 }
+/**
+ * @deprecated Use `createGeoClient({ network }).storage.uploadImage(...)`.
+ */
 export async function uploadImage(params, network, alternativeGateway) {
-    const formData = new FormData();
-    let blob;
-    if ('blob' in params) {
-        blob = params.blob;
-    }
-    else {
-        // fetch the image and upload it to IPFS
-        const response = await fetch(params.url);
-        blob = await response.blob();
-    }
-    formData.append('file', blob);
-    const buffer = new Uint8Array(await blob.arrayBuffer());
-    let dimensions;
-    try {
-        dimensions = imageSize(buffer);
-    }
-    catch (_error) { }
-    const cid = await Micro.runPromise(uploadFile(formData, network, alternativeGateway));
-    if (dimensions) {
-        return {
-            cid,
-            dimensions: {
-                width: dimensions.width,
-                height: dimensions.height,
-            },
-        };
-    }
-    return {
-        cid,
-    };
+    const config = resolveGeoNetwork(network);
+    return uploadImageCore({
+        ...params,
+        apiOrigin: config.apiOrigin,
+        fetch: globalThis.fetch,
+        alternativeGateway,
+    });
 }
 /**
  * Uploads a CSV file to IPFS and returns the CID. This CSV
  * file will be compressed using gzip before being uploaded.
  *
- * @example
- * ```ts
- * const file = Bun.file('cities.csv');
- * const fileText = await file.text();
- *
- * const cid = await Ipfs.uploadCSV(fileText);
- * ```
- *
- * @example
- * ```ts
- * import { Csv } from '@geoprotocol/geo-sdk';
- *
- * const csvString = Csv.stringify({
- *   data: Array.from({ length: 151_000 }, (_, i: number) => [i.toString(), (i * 2).toString(), (i * 3).toString()]),
- *   metadata: {
- *     filetype: 'CSV',
- *     columns: [
- *       {
- *         id: 'foo',
- *         type: 'TEXT',
- *       },
- *       {
- *         id: 'bar',
- *         type: 'NUMBER',
- *       },
- *       {
- *         id: 'baz',
- *         type: 'TEXT',
- *       },
- *     ],
- *   },
- * })
- *
- * const cid = await Ipfs.uploadCSV(csvString);
- * ```
- *
- * @param csvString The CSV to upload as a string
- * @returns IPFS CID representing the uploaded file prefixed with `ipfs://`
+ * @deprecated Use `createGeoClient({ network }).storage.uploadCSV(...)`.
  */
 export async function uploadCSV(csvString, network) {
-    const encoder = new TextEncoder();
-    const csvStringBytes = encoder.encode(csvString);
-    const blob = await gzipSync(csvStringBytes);
-    const formData = new FormData();
-    // @ts-expect-error - this is a type missmatch which is fine
-    formData.append('file', new Blob([blob], { type: 'text/csv' }));
-    return await Micro.runPromise(uploadBinary(formData, network));
-}
-function uploadBinary(formData, network = 'TESTNET') {
-    return Micro.gen(function* () {
-        const result = yield* Micro.tryPromise({
-            try: () => fetch(`${getApiOrigin(network)}/ipfs/upload-edit`, {
-                method: 'POST',
-                body: formData,
-            }),
-            catch: error => new IpfsUploadError(`Could not upload data to IPFS: ${error}`),
-        });
-        const maybeCid = yield* Micro.tryPromise({
-            try: async () => {
-                const { cid } = await result.json();
-                return cid;
-            },
-            catch: error => new IpfsUploadError(`Could not parse response from IPFS: ${error}`),
-        });
-        return maybeCid;
-    });
-}
-function uploadFile(formData, network = 'TESTNET', alternativeGateway) {
-    return Micro.gen(function* () {
-        let apiUrl = `${getApiOrigin(network)}/ipfs/upload-file`;
-        if (alternativeGateway) {
-            apiUrl = `${getApiOrigin('TESTNET')}/ipfs/upload-file-alternative-gateway`;
-        }
-        const result = yield* Micro.tryPromise({
-            try: () => fetch(apiUrl, {
-                method: 'POST',
-                body: formData,
-            }),
-            catch: error => {
-                return new IpfsUploadError(`Could not upload file to IPFS: ${error}`);
-            },
-        });
-        const maybeCid = yield* Micro.tryPromise({
-            try: async () => {
-                const { cid } = await result.json();
-                return cid;
-            },
-            catch: error => new IpfsUploadError(`Could not parse response from IPFS: ${error}`),
-        });
-        return maybeCid;
+    const config = resolveGeoNetwork(network);
+    return uploadCSVCore({
+        csvString,
+        apiOrigin: config.apiOrigin,
+        fetch: globalThis.fetch,
     });
 }
 //# sourceMappingURL=ipfs.js.map

package/dist/src/ipfs.js.map

@@ -1 +1 @@
-{"version":3,"file":"ipfs.js","sourceRoot":"","sources":["../../src/ipfs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ipfs.js","sourceRoot":"","sources":["../../src/ipfs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAkBlD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAA+B;IAC/D,MAAM,EAAE,OAAO,GAAG,SAAS,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IAChD,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,eAAe,CAAC;QACrB,GAAG,MAAM;QACT,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,UAAU,CAAC,KAAK;KACxB,CAAC,CAAC;AACL,CAAC;AAUD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAA0B,EAAE,OAAiB,EAAE,kBAA4B;IAC3G,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,eAAe,CAAC;QACrB,GAAG,MAAM;QACT,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,kBAAkB;KACnB,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAiB,EAAE,OAAiB;IAClE,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,aAAa,CAAC;QACnB,SAAS;QACT,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,UAAU,CAAC,KAAK;KACxB,CAAC,CAAC;AACL,CAAC"}

package/dist/src/networks.d.ts

@@ -0,0 +1,46 @@
+import type { GeoContractAddresses, GeoNetworkConfig, Networkish } from './types.js';
+export declare const TESTNET_API_ORIGIN = "https://testnet-api.geobrowser.io";
+/**
+ * Defines a Geo network configuration for `createGeoClient`.
+ *
+ * Use this for local contract deployments, private testnets, or any environment
+ * that is not covered by the built-in `GeoTestnetConfig`.
+ *
+ * @example
+ * ```ts
+ * import { createGeoClient, defineGeoNetworkConfig } from '@geoprotocol/geo-sdk';
+ *
+ * const localGeo = defineGeoNetworkConfig({
+ *   id: 'LOCAL',
+ *   name: 'Local Geo',
+ *   apiOrigin: 'http://localhost:3000',
+ *   chain: {
+ *     id: 31337,
+ *     name: 'Anvil',
+ *     rpcUrl: 'http://localhost:8545',
+ *   },
+ *   contracts: {
+ *     SPACE_REGISTRY_ADDRESS: '0x0000000000000000000000000000000000000000',
+ *     DAO_SPACE_FACTORY_ADDRESS: '0x0000000000000000000000000000000000000000',
+ *   },
+ * });
+ *
+ * const geo = createGeoClient({ network: localGeo });
+ * ```
+ */
+export declare function defineGeoNetworkConfig(config: GeoNetworkConfig): GeoNetworkConfig;
+/**
+ * Built-in Geo testnet configuration.
+ *
+ * @example
+ * ```ts
+ * import { createGeoClient, GeoTestnetConfig } from '@geoprotocol/geo-sdk';
+ *
+ * const geo = createGeoClient({ network: GeoTestnetConfig });
+ * ```
+ */
+export declare const GeoTestnetConfig: GeoNetworkConfig;
+export declare function resolveGeoNetwork(network?: Networkish): GeoNetworkConfig;
+export declare function requireGeoContract(network: GeoNetworkConfig, name: keyof GeoContractAddresses): `0x${string}`;
+export declare function getApiOrigin(network?: Networkish): string;
+//# sourceMappingURL=networks.d.ts.map

package/dist/src/networks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.d.ts","sourceRoot":"","sources":["../../src/networks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAErF,eAAO,MAAM,kBAAkB,sCAAsC,CAAC;AAQtE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAejF;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,kBAU3B,CAAC;AAEH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,UAAsB,GAAG,gBAAgB,CASnF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,oBAAoB,GAAG,KAAK,MAAM,EAAE,CAO7G;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,UAAsB,GAAG,MAAM,CAEpE"}

package/dist/src/networks.js

@@ -0,0 +1,90 @@
+import { TESTNET } from '../contracts.js';
+export const TESTNET_API_ORIGIN = 'https://testnet-api.geobrowser.io';
+const GEO_TESTNET_RPC_URL = 'https://rpc-geo-test-zc16z3tcvf.t.conduit.xyz';
+function asContractAddresses(contracts) {
+    return contracts;
+}
+/**
+ * Defines a Geo network configuration for `createGeoClient`.
+ *
+ * Use this for local contract deployments, private testnets, or any environment
+ * that is not covered by the built-in `GeoTestnetConfig`.
+ *
+ * @example
+ * ```ts
+ * import { createGeoClient, defineGeoNetworkConfig } from '@geoprotocol/geo-sdk';
+ *
+ * const localGeo = defineGeoNetworkConfig({
+ *   id: 'LOCAL',
+ *   name: 'Local Geo',
+ *   apiOrigin: 'http://localhost:3000',
+ *   chain: {
+ *     id: 31337,
+ *     name: 'Anvil',
+ *     rpcUrl: 'http://localhost:8545',
+ *   },
+ *   contracts: {
+ *     SPACE_REGISTRY_ADDRESS: '0x0000000000000000000000000000000000000000',
+ *     DAO_SPACE_FACTORY_ADDRESS: '0x0000000000000000000000000000000000000000',
+ *   },
+ * });
+ *
+ * const geo = createGeoClient({ network: localGeo });
+ * ```
+ */
+export function defineGeoNetworkConfig(config) {
+    if (!config.id) {
+        throw new Error('Geo network config requires an `id`');
+    }
+    if (!config.name) {
+        throw new Error('Geo network config requires a `name`');
+    }
+    if (!config.apiOrigin) {
+        throw new Error('Geo network config requires an `apiOrigin`');
+    }
+    return {
+        ...config,
+        contracts: config.contracts ?? {},
+    };
+}
+/**
+ * Built-in Geo testnet configuration.
+ *
+ * @example
+ * ```ts
+ * import { createGeoClient, GeoTestnetConfig } from '@geoprotocol/geo-sdk';
+ *
+ * const geo = createGeoClient({ network: GeoTestnetConfig });
+ * ```
+ */
+export const GeoTestnetConfig = defineGeoNetworkConfig({
+    id: 'TESTNET',
+    name: 'Geo Testnet',
+    apiOrigin: TESTNET_API_ORIGIN,
+    chain: {
+        id: 19411,
+        name: 'Geo Testnet',
+        rpcUrl: GEO_TESTNET_RPC_URL,
+    },
+    contracts: asContractAddresses(TESTNET),
+});
+export function resolveGeoNetwork(network = 'TESTNET') {
+    if (network === 'TESTNET') {
+        return GeoTestnetConfig;
+    }
+    if (typeof network === 'string') {
+        throw new Error(`Unknown Geo network "${network}". Use GeoTestnetConfig or defineGeoNetworkConfig().`);
+    }
+    return defineGeoNetworkConfig(network);
+}
+export function requireGeoContract(network, name) {
+    const address = network.contracts?.[name];
+    if (!address) {
+        throw new Error(`Geo network "${network.name}" is missing required contract address ${name}`);
+    }
+    return address;
+}
+export function getApiOrigin(network = 'TESTNET') {
+    return resolveGeoNetwork(network).apiOrigin;
+}
+//# sourceMappingURL=networks.js.map

package/dist/src/networks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.js","sourceRoot":"","sources":["../../src/networks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,mCAAmC,CAAC;AAEtE,MAAM,mBAAmB,GAAG,+CAA+C,CAAC;AAE5E,SAAS,mBAAmB,CAAC,SAA6C;IACxE,OAAO,SAAiC,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAwB;IAC7D,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,OAAO;QACL,GAAG,MAAM;QACT,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;KAClC,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;IACrD,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,aAAa;IACnB,SAAS,EAAE,kBAAkB;IAC7B,KAAK,EAAE;QACL,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,mBAAmB;KAC5B;IACD,SAAS,EAAE,mBAAmB,CAAC,OAAO,CAAC;CACxC,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB,CAAC,UAAsB,SAAS;IAC/D,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,sDAAsD,CAAC,CAAC;IACzG,CAAC;IAED,OAAO,sBAAsB,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAyB,EAAE,IAAgC;IAC5F,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,gBAAgB,OAAO,CAAC,IAAI,0CAA0C,IAAI,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,UAAsB,SAAS;IAC1D,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC"}

package/dist/src/ops/comments.d.ts

@@ -0,0 +1,80 @@
+import type { Id as IdType } from '../id.js';
+import type { CreateResult, UpdateCommentParams } from '../types.js';
+export type ReplyToContext = {
+    /** Ancestor entity ID from an existing reply-to relation. */
+    entityId: string;
+    /** Space ID associated with the ancestor reply target. */
+    spaceId: string;
+    /** Existing reply-to relation position used for parent-to-root ordering. */
+    position: string | null;
+};
+export type CreateCommentOpsParams = {
+    id?: IdType | string;
+    content: string;
+    replyTo: {
+        entityId: IdType | string;
+        spaceId: IdType | string;
+    };
+    resolved?: boolean;
+    replyToRelations?: ReplyToContext[];
+};
+/**
+ * Builds create-comment ops.
+ *
+ * The direct `replyTo` target is always included. If `replyToRelations` are
+ * provided, they are sorted by position and appended after the direct parent so
+ * nested comments preserve a parent-to-root reply chain.
+ *
+ * @example
+ * Create a comment on an entity.
+ *
+ * ```ts
+ * import { comments } from '@geoprotocol/geo-sdk/ops';
+ *
+ * const { id, ops } = comments.create({
+ *   content: 'Looks good to me',
+ *   replyTo: { entityId, spaceId },
+ * });
+ * ```
+ *
+ * @example
+ * Create a nested comment when reply context is already available.
+ *
+ * ```ts
+ * const { ops } = comments.create({
+ *   content: 'Replying to the parent comment',
+ *   replyTo: { entityId: parentCommentId, spaceId },
+ *   replyToRelations: [
+ *     { entityId: rootEntityId, spaceId, position: 'a0' },
+ *   ],
+ * });
+ * ```
+ *
+ * @param params Comment content, reply target, optional ID, resolved state, and optional ancestor reply context.
+ * @returns Comment entity ID and create ops.
+ * @throws When the comment ID or reply target IDs are invalid.
+ */
+export declare const create: ({ id: providedId, content, replyTo, resolved, replyToRelations, }: CreateCommentOpsParams) => CreateResult;
+/**
+ * Builds update-comment ops.
+ *
+ * If `content` is supplied, both markdown content and the derived comment name
+ * are updated. If `resolved` is supplied, the resolved property is updated.
+ *
+ * @example
+ * ```ts
+ * import { comments } from '@geoprotocol/geo-sdk/ops';
+ *
+ * const { ops } = comments.update({
+ *   id: commentId,
+ *   content: 'Updated comment text',
+ *   resolved: true,
+ * });
+ * ```
+ *
+ * @param params Comment ID plus content and/or resolved state to update.
+ * @returns Comment entity ID and update ops.
+ * @throws When the comment ID is invalid.
+ */
+export declare const update: ({ id, content, resolved }: UpdateCommentParams) => CreateResult;
+//# sourceMappingURL=comments.d.ts.map

package/dist/src/ops/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../../src/ops/comments.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,KAAK,EAAE,YAAY,EAAmB,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGtF,MAAM,MAAM,cAAc,GAAG;IAC3B,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;QAC1B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;KAC1B,CAAC;IACF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,cAAc,EAAE,CAAC;CACrC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,MAAM,GAAI,mEAMpB,sBAAsB,KAAG,YAqD3B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,MAAM,GAAI,2BAA2B,mBAAmB,KAAG,YA0BvE,CAAC"}

package/dist/src/ops/comments.js

@@ -0,0 +1,142 @@
+import { COMMENT_TYPE } from '../core/ids/content.js';
+import { MARKDOWN_CONTENT, REPLY_TO_PROPERTY, RESOLVED_PROPERTY } from '../core/ids/system.js';
+import { generateBetween } from '../core/position.js';
+import { deriveCommentName } from '../graph/comment-utils.js';
+import { Id } from '../id.js';
+import { assertValid, generate } from '../id-utils.js';
+import { create as createEntity, update as updateEntity } from './entities.js';
+/**
+ * Builds create-comment ops.
+ *
+ * The direct `replyTo` target is always included. If `replyToRelations` are
+ * provided, they are sorted by position and appended after the direct parent so
+ * nested comments preserve a parent-to-root reply chain.
+ *
+ * @example
+ * Create a comment on an entity.
+ *
+ * ```ts
+ * import { comments } from '@geoprotocol/geo-sdk/ops';
+ *
+ * const { id, ops } = comments.create({
+ *   content: 'Looks good to me',
+ *   replyTo: { entityId, spaceId },
+ * });
+ * ```
+ *
+ * @example
+ * Create a nested comment when reply context is already available.
+ *
+ * ```ts
+ * const { ops } = comments.create({
+ *   content: 'Replying to the parent comment',
+ *   replyTo: { entityId: parentCommentId, spaceId },
+ *   replyToRelations: [
+ *     { entityId: rootEntityId, spaceId, position: 'a0' },
+ *   ],
+ * });
+ * ```
+ *
+ * @param params Comment content, reply target, optional ID, resolved state, and optional ancestor reply context.
+ * @returns Comment entity ID and create ops.
+ * @throws When the comment ID or reply target IDs are invalid.
+ */
+export const create = ({ id: providedId, content, replyTo, resolved = false, replyToRelations = [], }) => {
+    if (providedId)
+        assertValid(providedId, '`id` in `Ops.comments.create`');
+    assertValid(replyTo.entityId, '`replyTo.entityId` in `Ops.comments.create`');
+    assertValid(replyTo.spaceId, '`replyTo.spaceId` in `Ops.comments.create`');
+    const id = providedId ?? generate();
+    const orderedTargets = [];
+    if (replyToRelations.length > 0) {
+        orderedTargets.push({ toEntity: replyTo.entityId, toSpace: replyTo.spaceId });
+        const sorted = [...replyToRelations].sort((a, b) => {
+            if (a.position === null && b.position === null)
+                return 0;
+            if (a.position === null)
+                return 1;
+            if (b.position === null)
+                return -1;
+            return a.position.localeCompare(b.position);
+        });
+        for (const relation of sorted) {
+            orderedTargets.push({ toEntity: relation.entityId, toSpace: relation.spaceId });
+        }
+    }
+    else {
+        orderedTargets.push({ toEntity: replyTo.entityId, toSpace: replyTo.spaceId });
+    }
+    let lastPosition = null;
+    const replyToRelationEntries = [];
+    for (const target of orderedTargets) {
+        const position = generateBetween(lastPosition, null);
+        replyToRelationEntries.push({ ...target, position });
+        lastPosition = position;
+    }
+    const result = createEntity({
+        id,
+        name: deriveCommentName(content),
+        types: [COMMENT_TYPE],
+        values: [
+            {
+                property: MARKDOWN_CONTENT,
+                type: 'text',
+                value: content,
+            },
+            {
+                property: RESOLVED_PROPERTY,
+                type: 'boolean',
+                value: resolved,
+            },
+        ],
+        relations: {
+            [REPLY_TO_PROPERTY]: replyToRelationEntries,
+        },
+    });
+    return { id: Id(id), ops: result.ops };
+};
+/**
+ * Builds update-comment ops.
+ *
+ * If `content` is supplied, both markdown content and the derived comment name
+ * are updated. If `resolved` is supplied, the resolved property is updated.
+ *
+ * @example
+ * ```ts
+ * import { comments } from '@geoprotocol/geo-sdk/ops';
+ *
+ * const { ops } = comments.update({
+ *   id: commentId,
+ *   content: 'Updated comment text',
+ *   resolved: true,
+ * });
+ * ```
+ *
+ * @param params Comment ID plus content and/or resolved state to update.
+ * @returns Comment entity ID and update ops.
+ * @throws When the comment ID is invalid.
+ */
+export const update = ({ id, content, resolved }) => {
+    assertValid(id, '`id` in `Ops.comments.update`');
+    const values = [];
+    if (content !== undefined) {
+        values.push({
+            property: MARKDOWN_CONTENT,
+            type: 'text',
+            value: content,
+        });
+    }
+    if (resolved !== undefined) {
+        values.push({
+            property: RESOLVED_PROPERTY,
+            type: 'boolean',
+            value: resolved,
+        });
+    }
+    return updateEntity({
+        id,
+        name: content !== undefined ? deriveCommentName(content) : undefined,
+        values,
+    });
+};
+//# sourceMappingURL=comments.js.map

package/dist/src/ops/comments.js.map

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

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

@@ -0,0 +1,50 @@
+import type { CreateResult, EntityParams, UpdateEntityParams } from '../types.js';
+/**
+ * Builds create-entity ops.
+ *
+ * This is the pure version of entity creation. It validates supplied IDs and
+ * encodes the same operation shape as the legacy `createEntity(...)` helper.
+ *
+ * @example
+ * ```ts
+ * import { entities } from '@geoprotocol/geo-sdk/ops';
+ *
+ * const { id, ops } = entities.create({
+ *   name: 'Restaurant',
+ *   description: 'A neighborhood restaurant',
+ *   types: [restaurantTypeId],
+ *   values: [
+ *     {
+ *       property: websitePropertyId,
+ *       type: 'text',
+ *       value: 'https://example.com',
+ *     },
+ *   ],
+ * });
+ * ```
+ *
+ * @param params Entity fields, values, relations, and types to encode.
+ * @returns Generated or supplied entity ID and create ops.
+ * @throws When any supplied ID is invalid.
+ */
+export declare const create: (params: EntityParams) => CreateResult;
+/**
+ * Builds update-entity ops.
+ *
+ * @example
+ * ```ts
+ * import { entities } from '@geoprotocol/geo-sdk/ops';
+ *
+ * const { ops } = entities.update({
+ *   id: entityId,
+ *   name: 'Updated restaurant name',
+ *   unset: [{ property: oldDescriptionPropertyId }],
+ * });
+ * ```
+ *
+ * @param params Entity ID and values/properties to update or unset.
+ * @returns Entity ID and update ops.
+ * @throws When any supplied ID is invalid.
+ */
+export declare const update: (params: UpdateEntityParams) => CreateResult;
+//# sourceMappingURL=entities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../../src/ops/entities.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAElF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ,YAAY,KAAG,YAAoC,CAAC;AAEnF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ,kBAAkB,KAAG,YAAoC,CAAC"}