@hypercerts-org/sdk-core 0.10.0-beta.4 → 0.10.0-beta.6

package/dist/types.d.ts

@@ -1,7 +1,8 @@
 import { OAuthSession, NodeSavedSession, NodeSavedState } from '@atproto/oauth-client-node';
 import { z } from 'zod';
 import { EventEmitter } from 'eventemitter3';
-import { OrgHypercertsClaimEvidence, OrgHypercertsClaimActivity, OrgHypercertsClaimCollection, OrgHypercertsClaimRights, AppCertifiedLocation, OrgHypercertsClaimContribution, OrgHypercertsClaimMeasurement, OrgHypercertsClaimEvaluation, OrgHypercertsDefs } from '@hypercerts-org/lexicon';
+import { OverrideProperties, SetOptional } from 'type-fest';
+import { ComAtprotoRepoStrongRef, AppCertifiedLocation, OrgHypercertsClaimActivity, OrgHypercertsClaimCollection, OrgHypercertsClaimRights, OrgHypercertsClaimContributionDetails, OrgHypercertsClaimContributorInformation, OrgHypercertsClaimMeasurement, OrgHypercertsClaimEvaluation, OrgHypercertsHelperWorkScopeTag, OrgHypercertsClaimEvidence, OrgHypercertsDefs } from '@hypercerts-org/lexicon';
 export { BlobRef, JsonBlobRef } from '@atproto/lexicon';
 
 /**
@@ -738,22 +739,28 @@ interface LoggerInterface {
  * Zod schema for OAuth configuration validation.
  *
  * @remarks
- * All URLs must be valid and use HTTPS in production. The `jwkPrivate` field
- * should contain the private key in JWK (JSON Web Key) format as a string.
+ * All URLs must be valid and use HTTPS in production. For local development,
+ * HTTP loopback URLs (localhost, 127.0.0.1, [::1]) are allowed.
+ * The `jwkPrivate` field should contain the private key in JWK (JSON Web Key) format as a string.
  */
 declare const OAuthConfigSchema: z.ZodObject<{
     /**
      * URL to the OAuth client metadata JSON document.
      * This document describes your application to the authorization server.
      *
+     * For local development, you can use `http://localhost/` as a loopback client.
+     *
      * @see https://atproto.com/specs/oauth#client-metadata
      */
-    clientId: z.ZodString;
+    clientId: z.ZodEffects<z.ZodString, string, string>;
     /**
      * URL where users are redirected after authentication.
      * Must match one of the redirect URIs in your client metadata.
+     *
+     * For local development, you can use HTTP loopback URLs like
+     * `http://127.0.0.1:3000/callback` or `http://localhost:3000/callback`.
      */
-    redirectUri: z.ZodString;
+    redirectUri: z.ZodEffects<z.ZodString, string, string>;
     /**
      * OAuth scopes to request, space-separated.
      *
@@ -787,8 +794,11 @@ declare const OAuthConfigSchema: z.ZodObject<{
     /**
      * URL to your public JWKS (JSON Web Key Set) endpoint.
      * Used by the authorization server to verify your client's signatures.
+     *
+     * For local development, you can serve JWKS from a loopback URL like
+     * `http://127.0.0.1:3000/.well-known/jwks.json`.
      */
-    jwksUri: z.ZodString;
+    jwksUri: z.ZodEffects<z.ZodString, string, string>;
     /**
      * Private JWK (JSON Web Key) as a JSON string.
      * Used for signing DPoP proofs and client assertions.
@@ -798,40 +808,78 @@ declare const OAuthConfigSchema: z.ZodObject<{
      * Typically loaded from environment variables or a secrets manager.
      */
     jwkPrivate: z.ZodString;
+    /**
+     * Enable development mode features (optional).
+     *
+     * When true, suppresses warnings about using HTTP loopback URLs.
+     * Should be set to true for local development to reduce console noise.
+     *
+     * @default false
+     *
+     * @example
+     * ```typescript
+     * oauth: {
+     *   clientId: "http://localhost/",
+     *   redirectUri: "http://127.0.0.1:3000/callback",
+     *   // ... other config
+     *   developmentMode: true, // Suppress loopback warnings
+     * }
+     * ```
+     */
+    developmentMode: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     clientId: string;
     redirectUri: string;
     scope: string;
     jwksUri: string;
     jwkPrivate: string;
+    developmentMode?: boolean | undefined;
 }, {
     clientId: string;
     redirectUri: string;
     scope: string;
     jwksUri: string;
     jwkPrivate: string;
+    developmentMode?: boolean | undefined;
 }>;
 /**
  * Zod schema for server URL configuration.
  *
  * @remarks
  * At least one server (PDS or SDS) should be configured for the SDK to be useful.
+ * For local development, HTTP loopback URLs are allowed.
  */
 declare const ServerConfigSchema: z.ZodObject<{
     /**
      * Personal Data Server URL - the user's own AT Protocol server.
      * This is the primary server for user data operations.
      *
-     * @example "https://bsky.social"
+     * @example Production
+     * ```typescript
+     * pds: "https://bsky.social"
+     * ```
+     *
+     * @example Local development
+     * ```typescript
+     * pds: "http://localhost:2583"
+     * ```
      */
-    pds: z.ZodOptional<z.ZodString>;
+    pds: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     /**
      * Shared Data Server URL - for collaborative data storage.
      * Required for collaborator and organization operations.
      *
-     * @example "https://sds.hypercerts.org"
+     * @example Production
+     * ```typescript
+     * sds: "https://sds.hypercerts.org"
+     * ```
+     *
+     * @example Local development
+     * ```typescript
+     * sds: "http://127.0.0.1:2584"
+     * ```
      */
-    sds: z.ZodOptional<z.ZodString>;
+    sds: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
 }, "strip", z.ZodTypeAny, {
     pds?: string | undefined;
     sds?: string | undefined;
@@ -877,14 +925,19 @@ declare const ATProtoSDKConfigSchema: z.ZodObject<{
          * URL to the OAuth client metadata JSON document.
          * This document describes your application to the authorization server.
          *
+         * For local development, you can use `http://localhost/` as a loopback client.
+         *
          * @see https://atproto.com/specs/oauth#client-metadata
          */
-        clientId: z.ZodString;
+        clientId: z.ZodEffects<z.ZodString, string, string>;
         /**
          * URL where users are redirected after authentication.
          * Must match one of the redirect URIs in your client metadata.
+         *
+         * For local development, you can use HTTP loopback URLs like
+         * `http://127.0.0.1:3000/callback` or `http://localhost:3000/callback`.
          */
-        redirectUri: z.ZodString;
+        redirectUri: z.ZodEffects<z.ZodString, string, string>;
         /**
          * OAuth scopes to request, space-separated.
          *
@@ -918,8 +971,11 @@ declare const ATProtoSDKConfigSchema: z.ZodObject<{
         /**
          * URL to your public JWKS (JSON Web Key Set) endpoint.
          * Used by the authorization server to verify your client's signatures.
+         *
+         * For local development, you can serve JWKS from a loopback URL like
+         * `http://127.0.0.1:3000/.well-known/jwks.json`.
          */
-        jwksUri: z.ZodString;
+        jwksUri: z.ZodEffects<z.ZodString, string, string>;
         /**
          * Private JWK (JSON Web Key) as a JSON string.
          * Used for signing DPoP proofs and client assertions.
@@ -929,34 +985,71 @@ declare const ATProtoSDKConfigSchema: z.ZodObject<{
          * Typically loaded from environment variables or a secrets manager.
          */
         jwkPrivate: z.ZodString;
+        /**
+         * Enable development mode features (optional).
+         *
+         * When true, suppresses warnings about using HTTP loopback URLs.
+         * Should be set to true for local development to reduce console noise.
+         *
+         * @default false
+         *
+         * @example
+         * ```typescript
+         * oauth: {
+         *   clientId: "http://localhost/",
+         *   redirectUri: "http://127.0.0.1:3000/callback",
+         *   // ... other config
+         *   developmentMode: true, // Suppress loopback warnings
+         * }
+         * ```
+         */
+        developmentMode: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         clientId: string;
         redirectUri: string;
         scope: string;
         jwksUri: string;
         jwkPrivate: string;
+        developmentMode?: boolean | undefined;
     }, {
         clientId: string;
         redirectUri: string;
         scope: string;
         jwksUri: string;
         jwkPrivate: string;
+        developmentMode?: boolean | undefined;
     }>;
     servers: z.ZodOptional<z.ZodObject<{
         /**
          * Personal Data Server URL - the user's own AT Protocol server.
          * This is the primary server for user data operations.
          *
-         * @example "https://bsky.social"
+         * @example Production
+         * ```typescript
+         * pds: "https://bsky.social"
+         * ```
+         *
+         * @example Local development
+         * ```typescript
+         * pds: "http://localhost:2583"
+         * ```
          */
-        pds: z.ZodOptional<z.ZodString>;
+        pds: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
         /**
          * Shared Data Server URL - for collaborative data storage.
          * Required for collaborator and organization operations.
          *
-         * @example "https://sds.hypercerts.org"
+         * @example Production
+         * ```typescript
+         * sds: "https://sds.hypercerts.org"
+         * ```
+         *
+         * @example Local development
+         * ```typescript
+         * sds: "http://127.0.0.1:2584"
+         * ```
          */
-        sds: z.ZodOptional<z.ZodString>;
+        sds: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     }, "strip", z.ZodTypeAny, {
         pds?: string | undefined;
         sds?: string | undefined;
@@ -989,6 +1082,7 @@ declare const ATProtoSDKConfigSchema: z.ZodObject<{
         scope: string;
         jwksUri: string;
         jwkPrivate: string;
+        developmentMode?: boolean | undefined;
     };
     servers?: {
         pds?: string | undefined;
@@ -1005,6 +1099,7 @@ declare const ATProtoSDKConfigSchema: z.ZodObject<{
         scope: string;
         jwksUri: string;
         jwkPrivate: string;
+        developmentMode?: boolean | undefined;
     };
     servers?: {
         pds?: string | undefined;
@@ -1240,45 +1335,137 @@ interface ProgressStep {
  * @packageDocumentation
  */
 
+type StrongRef = ComAtprotoRepoStrongRef.Main;
 type HypercertClaim = OrgHypercertsClaimActivity.Main;
 type HypercertRights = OrgHypercertsClaimRights.Main;
-type HypercertContribution = OrgHypercertsClaimContribution.Main;
+type HypercertContributionDetails = OrgHypercertsClaimContributionDetails.Main;
+type HypercertContributorInformation = OrgHypercertsClaimContributorInformation.Main;
+/** Contributor entry in an activity - can be inline or reference external records */
+type HypercertContributor = OrgHypercertsClaimActivity.Contributor;
 type HypercertMeasurement = OrgHypercertsClaimMeasurement.Main;
 type HypercertEvaluation = OrgHypercertsClaimEvaluation.Main;
 type HypercertEvidence = OrgHypercertsClaimEvidence.Main;
 type HypercertCollection = OrgHypercertsClaimCollection.Main;
-type HypercertCollectionClaimItem = OrgHypercertsClaimActivity.ActivityWeight;
+/** Collection item with optional weight */
+type HypercertCollectionItem = OrgHypercertsClaimCollection.Item;
+/** Work scope tag for creating reusable scope atoms */
+type HypercertWorkScopeTag = OrgHypercertsHelperWorkScopeTag.Main;
 type HypercertLocation = AppCertifiedLocation.Main;
 /**
  * Image input for SDK operations.
  *
- * Can be either:
- * - A URI reference (for external images)
- * - A Blob to be uploaded
+ * Accepts either:
+ * - A string URI reference (for external images)
+ * - A Blob to be uploaded (will be converted to SmallImage or LargeImage)
  *
- * The SDK will convert these to the appropriate lexicon types:
- * - OrgHypercertsDefs.Uri
- * - OrgHypercertsDefs.SmallImage
- * - OrgHypercertsDefs.LargeImage
+ * The SDK will convert these inputs to the appropriate lexicon types.
  */
-type HypercertImage = {
-    type: "uri";
-    uri: string;
-} | {
-    type: "blob";
-    blob: Blob;
-};
+type HypercertImage = string | Blob;
 /**
  * Lexicon-defined image types (union of Uri and image blob types).
- * Use this when working with stored records.
+ *
+ * Used when working with stored records. Can be:
+ * - OrgHypercertsDefs.Uri - External image reference
+ * - OrgHypercertsDefs.SmallImage - Uploaded blob for avatars/thumbnails
+ * - OrgHypercertsDefs.LargeImage - Uploaded blob for banners/covers
  */
 type HypercertImageRecord = OrgHypercertsDefs.Uri | OrgHypercertsDefs.SmallImage | OrgHypercertsDefs.LargeImage;
-/** Hypercert with AT Protocol metadata */
-interface HypercertWithMetadata {
+/** Hypercert with resolved metadata */
+type HypercertWithMetadata = HypercertClaim & {
+    resolvedRights?: HypercertRights;
+    resolvedLocation?: HypercertLocation;
+};
+/** Project type alias (collection with type="project") */
+type HypercertProject = HypercertCollection & {
+    type: "project";
+};
+/** Project with resolved metadata */
+type HypercertProjectWithMetadata = HypercertCollection & {
+    resolvedLocation?: HypercertLocation;
+    resolvedActivities?: HypercertClaim[];
+};
+
+type CollectionItemInput = SetOptional<OrgHypercertsClaimCollection.Item, "$type">;
+/**
+ * Parameters for specifying a location in collection/project operations.
+ * Supports three ways to specify location:
+ *
+ * 1. **StrongRef** - Direct reference with uri and cid (no record creation)
+ * 2. **AT-URI string** - Reference to existing location record
+ * 3. **Location object** - Full location data (lpVersion, srs, locationType, location, etc.)
+ *    with optional `$type` and `createdAt` fields
+ *    where-as location field can be a Blob (e.g., GeoJSON) that will be uploaded
+ *
+ * @example Using a StrongRef (no record creation)
+ * ```typescript
+ * const location: AttachLocationParams = { uri: "at://did:plc:test/app.certified.location/abc", cid: "bafyrei..." };
+ * ```
+ *
+ * @example Using an AT-URI (fetches existing record)
+ * ```typescript
+ * const location: AttachLocationParams = "at://did:plc:test/app.certified.location/xyz";
+ * ```
+ *
+ * @example Using a location object
+ * ```typescript
+ * const location: AttachLocationParams = {
+ *   lpVersion: "1.0.0",
+ *   srs: "EPSG:4326",
+ *   locationType: "coordinate-decimal",
+ *   location: "https://locationuri.com",
+ *   name: "San Francisco",
+ * };
+ * ```
+ */
+type CreateLocationParams = OverrideProperties<SetOptional<HypercertLocation, "$type" | "createdAt">, {
+    location: string | Blob | HypercertLocation["location"];
+}>;
+type LocationParams = StrongRef | string | CreateLocationParams;
+/**
+ * SDK input parameters for creating a collection.
+ * Derived from lexicon type with $type and createdAt removed.
+ * avatar/banner accept HypercertImage (string URI or Blob) for user convenience.
+ * Location can be provided inline or via attachLocationToCollection().
+ */
+type CreateCollectionParams = OverrideProperties<SetOptional<OrgHypercertsClaimCollection.Main, "$type" | "createdAt">, {
+    avatar?: HypercertImage;
+    banner?: HypercertImage;
+    items: CollectionItemInput[];
+    /**
+     * Optional location to attach to the collection.
+     * Can be:
+     * - StrongRef to reference existing location (uri + cid)
+     * - string (AT-URI) to reference existing location (CID will be fetched)
+     * - Location object to create a new location record
+     */
+    location?: LocationParams;
+}>;
+/**
+ * SDK input parameters for updating a collection.
+ * All fields are optional.
+ * avatar/banner accept HypercertImage (string URI or Blob), or null to remove.
+ * Location can be updated inline or removed with null.
+ */
+type UpdateCollectionParams = Omit<Partial<CreateCollectionParams>, "avatar" | "banner" | "location"> & {
+    avatar?: HypercertImage | null;
+    banner?: HypercertImage | null;
+    location?: LocationParams | null;
+};
+type CreateCollectionResult = {
     uri: string;
     cid: string;
-    record: HypercertClaim;
-}
+    record: HypercertCollection;
+};
+/**
+ * SDK input parameters for creating a project.
+ * Projects are collections with type="project" (set automatically).
+ */
+type CreateProjectParams = CreateCollectionParams;
+/**
+ * SDK input parameters for updating a project.
+ */
+type UpdateProjectParams = UpdateCollectionParams;
+type CreateProjectResult = CreateCollectionResult;
 
 /**
  * Parameters for creating a new hypercert.
@@ -1360,14 +1547,12 @@ interface CreateHypercertParams {
     description: string;
     /**
      * Scope of work or impact area.
-     * Logical scope of the work using label-based conditions. All labels in `withinAllOf` must apply; at least one label in `withinAnyOf` must apply if provided; no label in `withinNoneOf` may apply.
+     * Logical scope of the work using label-based conditions.
      *
-     * @example "Climate Action", "Education", "Healthcare"
+     * @example WorkScopeAll with atom references
      */
-    workScope?: {
-        withinAllOf?: string[];
-        withinAnyOf?: string[];
-        withinNoneOf?: string[];
+    workScope?: OrgHypercertsDefs.WorkScopeAll | OrgHypercertsDefs.WorkScopeAny | OrgHypercertsDefs.WorkScopeNot | OrgHypercertsDefs.WorkScopeAtom | {
+        $type: string;
     };
     /**
      * Start date of the work period.
@@ -1419,34 +1604,7 @@ interface CreateHypercertParams {
     /**
      * Optional geographic location of the impact.
      */
-    location?: {
-        /**
-         * Location value/address.
-         *
-         * @example "San Francisco, CA, USA"
-         */
-        value: string;
-        /**
-         * Human-readable location name.
-         *
-         * @example "SF Bay Area"
-         */
-        name?: string;
-        /**
-         * Description of the location scope.
-         */
-        description?: string;
-        /**
-         * Spatial Reference System identifier (required if location is provided).
-         *
-         * @example "EPSG:4326" for WGS84
-         */
-        srs: string;
-        /**
-         * GeoJSON file as a Blob for precise boundaries.
-         */
-        geojson?: Blob;
-    };
+    location?: LocationParams;
     /**
      * Optional list of contributions to the impact.
      *
@@ -1471,7 +1629,7 @@ interface CreateHypercertParams {
     /**
      * Optional evidence supporting the impact claim.
      */
-    evidence?: HypercertEvidence[];
+    evidence?: Array<Omit<CreateHypercertEvidenceParams, "subjectUri">>;
     /**
      * Optional callback for progress updates during creation.
      *
@@ -1496,6 +1654,45 @@ interface CreateOrganizationParams {
      */
     description?: string;
 }
+/**
+ * Input params for creating Hypercert evidence.
+ *
+ * Based on `org.hypercerts.claim.evidence` but:
+ * - removes: $type, createdAt, subject, content
+ * - adds: subjectUri, content (string | Blob)
+ */
+interface CreateHypercertEvidenceParams {
+    /**
+     * URI for the subject this evidence is attached to.
+     */
+    subjectUri: string;
+    /**
+     * Evidence content.
+     * - string: should be a URI.
+     * - Blob: binary payload (e.g. image/pdf)
+     */
+    content: string | Blob;
+    /**
+     * Title to describe the nature of the evidence.
+     */
+    title: string;
+    /**
+     * Short description explaining what this evidence shows.
+     */
+    shortDescription?: string;
+    /**
+     * Longer description describing the evidence in more detail.
+     */
+    description?: string;
+    /**
+     * How this evidence relates to the subject.
+     */
+    relationType?: "supports" | "challenges" | "clarifies" | (string & {});
+    /**
+     * Any additional custom fields supported by the record.
+     */
+    [k: string]: unknown;
+}
 /**
  * Result of creating a hypercert.
  *
@@ -1526,6 +1723,10 @@ interface CreateHypercertResult {
      * AT-URIs of contribution records, if contributions were provided.
      */
     contributionUris?: string[];
+    /**
+     * AT-URIs of evidence records, if evidence was provided.
+     */
+    evidenceUris?: string[];
 }
 /**
  * Low-level record operations for AT Protocol CRUD.
@@ -1840,6 +2041,67 @@ interface HypercertEvents {
         uri: string;
         cid: string;
     };
+    /**
+     * Emitted when a collection is updated.
+     */
+    collectionUpdated: {
+        uri: string;
+        cid: string;
+    };
+    /**
+     * Emitted when a collection is deleted.
+     */
+    collectionDeleted: {
+        uri: string;
+    };
+    /**
+     * Emitted when a location is attached to a collection.
+     */
+    locationAttachedToCollection: {
+        uri: string;
+        cid: string;
+        collectionUri: string;
+    };
+    /**
+     * Emitted when a location is removed from a collection.
+     */
+    locationRemovedFromCollection: {
+        collectionUri: string;
+    };
+    /**
+     * Emitted when a project is created.
+     */
+    projectCreated: {
+        uri: string;
+        cid: string;
+    };
+    /**
+     * Emitted when a project is updated.
+     */
+    projectUpdated: {
+        uri: string;
+        cid: string;
+    };
+    /**
+     * Emitted when a project is deleted.
+     */
+    projectDeleted: {
+        uri: string;
+    };
+    /**
+     * Emitted when a location is attached to a project.
+     */
+    locationAttachedToProject: {
+        uri: string;
+        cid: string;
+        projectUri: string;
+    };
+    /**
+     * Emitted when a location is removed from a project.
+     */
+    locationRemovedFromProject: {
+        projectUri: string;
+    };
 }
 /**
  * High-level hypercert operations.
@@ -1895,7 +2157,7 @@ interface HypercertOperations extends EventEmitter<HypercertEvents> {
      */
     update(params: {
         uri: string;
-        updates: Partial<Omit<HypercertClaim, "$type" | "createdAt" | "rights">>;
+        updates: Partial<CreateHypercertParams>;
         image?: Blob | null;
     }): Promise<UpdateResult>;
     /**
@@ -1941,21 +2203,14 @@ interface HypercertOperations extends EventEmitter<HypercertEvents> {
      * @param location.geojson - Optional GeoJSON blob for precise boundaries
      * @returns Promise resolving to location record result
      */
-    attachLocation(uri: string, location: {
-        value: string;
-        name?: string;
-        description?: string;
-        srs: string;
-        geojson?: Blob;
-    }): Promise<CreateResult>;
+    attachLocation(uri: string, location: LocationParams): Promise<CreateResult>;
     /**
      * Adds evidence to an existing hypercert.
      *
-     * @param uri - AT-URI of the hypercert
-     * @param evidence - Array of evidence items to add
+     * @param evidence - Evidence item to add
      * @returns Promise resolving to update result
      */
-    addEvidence(uri: string, evidence: HypercertEvidence[]): Promise<UpdateResult>;
+    addEvidence(evidence: CreateHypercertEvidenceParams): Promise<UpdateResult>;
     /**
      * Creates a contribution record.
      *
@@ -1997,18 +2252,9 @@ interface HypercertOperations extends EventEmitter<HypercertEvents> {
      * Creates a collection of hypercerts.
      *
      * @param params - Collection parameters
-     * @returns Promise resolving to collection record result
-     */
-    createCollection(params: {
-        title: string;
-        claims: Array<{
-            uri: string;
-            cid: string;
-            weight: string;
-        }>;
-        shortDescription?: string;
-        coverPhoto?: Blob;
-    }): Promise<CreateResult>;
+     * @returns Promise resolving to collection record result with optional location URI
+     */
+    createCollection(params: CreateCollectionParams): Promise<CreateCollectionResult>;
     /**
      * Gets a collection by URI.
      *
@@ -2031,6 +2277,101 @@ interface HypercertOperations extends EventEmitter<HypercertEvents> {
         cid: string;
         record: HypercertCollection;
     }>>;
+    /**
+     * Updates a collection.
+     *
+     * @param uri - AT-URI of the collection
+     * @param updates - Fields to update
+     * @returns Promise resolving to update result
+     */
+    updateCollection(uri: string, updates: UpdateCollectionParams): Promise<UpdateResult>;
+    /**
+     * Deletes a collection.
+     *
+     * @param uri - AT-URI of the collection
+     * @returns Promise resolving when deleted
+     */
+    deleteCollection(uri: string): Promise<void>;
+    /**
+     * Attaches a location to a collection.
+     *
+     * @param uri - AT-URI of the collection
+     * @param location - Location data
+     * @returns Promise resolving to location record result
+     */
+    attachLocationToCollection(uri: string, location: LocationParams): Promise<CreateResult>;
+    /**
+     * Removes a location from a collection.
+     *
+     * @param uri - AT-URI of the collection
+     * @returns Promise resolving when location is removed
+     */
+    removeLocationFromCollection(uri: string): Promise<void>;
+    /**
+     * Creates a project.
+     *
+     * A project is a collection with type='project' and optional location sidecar.
+     *
+     * @param params - Project parameters
+     * @returns Promise resolving to project record result with optional location URI
+     */
+    createProject(params: CreateProjectParams): Promise<CreateProjectResult>;
+    /**
+     * Gets a project by URI.
+     *
+     * Projects are collections with type='project'.
+     *
+     * @param uri - AT-URI of the project
+     * @returns Promise resolving to project data (as collection)
+     */
+    getProject(uri: string): Promise<{
+        uri: string;
+        cid: string;
+        record: HypercertCollection;
+    }>;
+    /**
+     * Lists projects with pagination.
+     *
+     * Projects are collections with type='project'.
+     *
+     * @param params - Optional pagination parameters
+     * @returns Promise resolving to paginated list
+     */
+    listProjects(params?: ListParams): Promise<PaginatedList<{
+        uri: string;
+        cid: string;
+        record: HypercertCollection;
+    }>>;
+    /**
+     * Updates a project.
+     *
+     * @param uri - AT-URI of the project
+     * @param updates - Fields to update
+     * @returns Promise resolving to update result
+     */
+    updateProject(uri: string, updates: UpdateProjectParams): Promise<UpdateResult>;
+    /**
+     * Deletes a project.
+     *
+     * @param uri - AT-URI of the project
+     * @returns Promise resolving when deleted
+     */
+    deleteProject(uri: string): Promise<void>;
+    /**
+     * Attaches a location to a project.
+     *
+     * @param uri - AT-URI of the project
+     * @param location - Location data
+     * @returns Promise resolving to location record result
+     */
+    attachLocationToProject(uri: string, location: LocationParams): Promise<CreateResult>;
+    /**
+     * Removes a location from a project.
+     *
+     * @param uri - AT-URI of the project
+     * @returns Promise resolving when location is removed
+     */
+    removeLocationFromProject(uri: string): Promise<void>;
 }
 /**
  * Collaborator operations for SDS access control.
@@ -2250,4 +2591,4 @@ interface AuthorizeOptions {
 }
 
 export { ATProtoSDKConfigSchema, CollaboratorPermissionsSchema, CollaboratorSchema, OAuthConfigSchema, OrganizationSchema, ServerConfigSchema, TimeoutConfigSchema };
-export type { ATProtoSDKConfig, AuthorizeOptions, BlobOperations, CacheInterface, Collaborator, CollaboratorOperations, CollaboratorPermissions, CreateHypercertParams, CreateHypercertResult, CreateResult, DID, HypercertClaim, HypercertCollection, HypercertCollectionClaimItem, HypercertContribution, HypercertEvaluation, HypercertEvents, HypercertEvidence, HypercertImage, HypercertImageRecord, HypercertLocation, HypercertMeasurement, HypercertOperations, HypercertRights, HypercertWithMetadata, ListParams, LoggerInterface, Organization, OrganizationInfo, OrganizationOperations, PaginatedList, ProfileOperations, ProgressStep, RecordOperations, RepositoryAccessGrant, RepositoryOptions, RepositoryRole, Session, SessionStore, StateStore, UpdateResult };
+export type { ATProtoSDKConfig, AuthorizeOptions, BlobOperations, CacheInterface, Collaborator, CollaboratorOperations, CollaboratorPermissions, CreateHypercertParams, CreateHypercertResult, CreateProjectParams, CreateResult, DID, HypercertClaim, HypercertCollection, HypercertCollectionItem, HypercertContributionDetails, HypercertContributor, HypercertContributorInformation, HypercertEvaluation, HypercertEvents, HypercertEvidence, HypercertImage, HypercertImageRecord, HypercertLocation, HypercertMeasurement, HypercertOperations, HypercertProject, HypercertProjectWithMetadata, HypercertRights, HypercertWithMetadata, HypercertWorkScopeTag, ListParams, LoggerInterface, Organization, OrganizationInfo, OrganizationOperations, PaginatedList, ProfileOperations, ProgressStep, RecordOperations, RepositoryAccessGrant, RepositoryOptions, RepositoryRole, Session, SessionStore, StateStore, UpdateProjectParams, UpdateResult };