@atproto/api 0.10.5-next.0 → 0.11.0-next

package/definitions/proposed-labels.json

@@ -1,326 +0,0 @@
-[
-  {
-    "id": "system",
-    "configurable": false,
-    "labels": [
-      {
-        "id": "!hide",
-        "preferences": ["hide"],
-        "flags": ["no-override"],
-        "onwarn": "blur"
-      },
-      {
-        "id": "!no-promote",
-        "preferences": ["hide"],
-        "flags": [],
-        "onwarn": null
-      },
-      {
-        "id": "!warn",
-        "preferences": ["warn"],
-        "flags": [],
-        "onwarn": "blur"
-      }
-    ]
-  },
-  {
-    "id": "legal",
-    "configurable": false,
-    "labels": [
-      {
-        "id": "nudity-nonconsensual",
-        "preferences": ["hide"],
-        "flags": ["no-override"],
-        "onwarn": "blur"
-      },
-      {
-        "id": "dmca-violation",
-        "preferences": ["hide"],
-        "flags": ["no-override"],
-        "onwarn": "blur"
-      },
-      {
-        "id": "doxxing",
-        "preferences": ["hide"],
-        "flags": ["no-override"],
-        "onwarn": "blur"
-      }
-    ]
-  },
-  {
-    "id": "sexual",
-    "configurable": true,
-    "labels": [
-      {
-        "id": "porn",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": ["adult"],
-        "onwarn": "blur-media"
-      },
-      {
-        "id": "sexual",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": ["adult"],
-        "onwarn": "blur-media"
-      },
-      {
-        "id": "nudity",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": ["adult"],
-        "onwarn": "blur-media"
-      }
-    ]
-  },
-  {
-    "id": "violence",
-    "configurable": true,
-    "labels": [
-      {
-        "id": "nsfl",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": ["adult"],
-        "onwarn": "blur-media"
-      },
-      {
-        "id": "corpse",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": ["adult"],
-        "onwarn": "blur-media"
-      },
-      {
-        "id": "gore",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": ["adult"],
-        "onwarn": "blur-media"
-      },
-      {
-        "id": "torture",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": ["adult"],
-        "onwarn": "blur"
-      },
-      {
-        "id": "self-harm",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": ["adult"],
-        "onwarn": "blur-media"
-      }
-    ]
-  },
-  {
-    "id": "intolerance",
-    "configurable": true,
-    "labels": [
-      {
-        "id": "intolerant-race",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "intolerant-gender",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "intolerant-sexual-orientation",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "intolerant-religion",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "intolerant",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "icon-intolerant",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur-media"
-      }
-    ]
-  },
-  {
-    "id": "rude",
-    "configurable": true,
-    "labels": [
-      {
-        "id": "trolling",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "harassment",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "bullying",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "threat",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      }
-    ]
-  },
-  {
-    "id": "curation",
-    "configurable": true,
-    "labels": [
-      {
-        "id": "disgusting",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "upsetting",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "profane",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "politics",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "troubling",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "negative",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "discourse",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "spoiler",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      }
-    ]
-  },
-  {
-    "id": "spam",
-    "configurable": true,
-    "labels": [
-      {
-        "id": "spam",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "clickbait",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "shill",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "promotion",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      }
-    ]
-  },
-  {
-    "id": "misinfo",
-    "configurable": true,
-    "labels": [
-      {
-        "id": "account-security",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "net-abuse",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "blur"
-      },
-      {
-        "id": "impersonation",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "alert"
-      },
-      {
-        "id": "scam",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "alert"
-      },
-      {
-        "id": "misinformation",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "alert"
-      },
-      {
-        "id": "unverified",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "alert"
-      },
-      {
-        "id": "manipulated",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "alert"
-      },
-      {
-        "id": "fringe",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "alert"
-      },
-      {
-        "id": "bullshit",
-        "preferences": ["ignore", "warn", "hide"],
-        "flags": [],
-        "onwarn": "alert"
-      }
-    ]
-  }
-]

package/dist/agent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,gBAAgB,EAChB,6BAA6B,EAC7B,6BAA6B,EAC7B,0BAA0B,EAE3B,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EAEpB,kBAAkB,EAClB,wBAAwB,EACxB,YAAY,EACb,MAAM,SAAS,CAAA;AAIhB;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,EAAE,GAAG,CAAA;IACZ,GAAG,EAAE,gBAAgB,CAAA;IACrB,OAAO,CAAC,EAAE,cAAc,CAAA;IAExB;;OAEG;IACH,MAAM,EAAE,GAAG,GAAG,SAAS,CAAA;IAEvB,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,eAAe,CAAC,CAA0B;IAClD,OAAO,CAAC,sBAAsB,CAA2B;IAEzD,IAAI,GAAG,6BAEN;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,SAAS,CAAsB;IAEpE;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,kBAAkB;gBAI7B,IAAI,EAAE,YAAY;IAW9B;;OAEG;IACH,IAAI,UAAU,YAEb;IAED;;;OAGG;IACH,wBAAwB,CAAC,OAAO,CAAC,EAAE,wBAAwB;IAI3D;;OAEG;IACG,aAAa,CACjB,IAAI,EAAE,6BAA6B,CAAC,WAAW,GAC9C,OAAO,CAAC,6BAA6B,CAAC,QAAQ,CAAC;IAyBlD;;OAEG;IACG,KAAK,CACT,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,6BAA6B,CAAC,QAAQ,CAAC;IA4BlD;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,0BAA0B,CAAC,QAAQ,CAAC;IA0C/C;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;YACW,MAAM;IAsCpB;;;;OAIG;IACG,cAAc;IAYpB;;OAEG;YACW,oBAAoB;IAyClC;;OAEG;IACH,UAAU,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CACL;IAElD;;OAEG;IACH,aAAa,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAGH;IAE9D;;OAEG;IACH,YAAY,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAGJ;IAE3D;;OAEG;IACH,sBAAsB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CACD;IAE1E;;;;;;;;;OASG;IACH,OAAO,CAAC,kBAAkB;CAO3B"}

package/dist/agent.js

@@ -1,363 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AtpAgent = void 0;
-const xrpc_1 = require("@atproto/xrpc");
-const xrpc_2 = require("@atproto/xrpc");
-const common_web_1 = require("@atproto/common-web");
-const client_1 = require("./client");
-const REFRESH_SESSION = 'com.atproto.server.refreshSession';
-/**
- * An ATP "Agent"
- * Manages session token lifecycles and provides convenience methods.
- */
-class AtpAgent {
-    get com() {
-        return this.api.com;
-    }
-    /**
-     * Configures the API globally.
-     */
-    static configure(opts) {
-        AtpAgent.fetch = opts.fetch;
-    }
-    constructor(opts) {
-        Object.defineProperty(this, "service", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "api", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "session", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        /**
-         * The PDS URL, driven by the did doc. May be undefined.
-         */
-        Object.defineProperty(this, "pdsUrl", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_baseClient", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_persistSession", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_refreshSessionPromise", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        /**
-         * Upload a binary blob to the server
-         */
-        Object.defineProperty(this, "uploadBlob", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: (data, opts) => this.api.com.atproto.repo.uploadBlob(data, opts)
-        });
-        /**
-         * Resolve a handle to a DID
-         */
-        Object.defineProperty(this, "resolveHandle", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: (params, opts) => this.api.com.atproto.identity.resolveHandle(params, opts)
-        });
-        /**
-         * Change the user's handle
-         */
-        Object.defineProperty(this, "updateHandle", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: (data, opts) => this.api.com.atproto.identity.updateHandle(data, opts)
-        });
-        /**
-         * Create a moderation report
-         */
-        Object.defineProperty(this, "createModerationReport", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: (data, opts) => this.api.com.atproto.moderation.createReport(data, opts)
-        });
-        this.service =
-            opts.service instanceof URL ? opts.service : new URL(opts.service);
-        this._persistSession = opts.persistSession;
-        // create an ATP client instance for this agent
-        this._baseClient = new client_1.AtpBaseClient();
-        this._baseClient.xrpc.fetch = this._fetch.bind(this); // patch its fetch implementation
-        this.api = this._baseClient.service(opts.service);
-    }
-    /**
-     * Is there any active session?
-     */
-    get hasSession() {
-        return !!this.session;
-    }
-    /**
-     * Sets the "Persist Session" method which can be used to store access tokens
-     * as they change.
-     */
-    setPersistSessionHandler(handler) {
-        this._persistSession = handler;
-    }
-    /**
-     * Create a new account and hydrate its session in this agent.
-     */
-    async createAccount(opts) {
-        try {
-            const res = await this.api.com.atproto.server.createAccount(opts);
-            this.session = {
-                accessJwt: res.data.accessJwt,
-                refreshJwt: res.data.refreshJwt,
-                handle: res.data.handle,
-                did: res.data.did,
-                email: opts.email,
-                emailConfirmed: false,
-            };
-            this._updateApiEndpoint(res.data.didDoc);
-            return res;
-        }
-        catch (e) {
-            this.session = undefined;
-            throw e;
-        }
-        finally {
-            if (this.session) {
-                this._persistSession?.('create', this.session);
-            }
-            else {
-                this._persistSession?.('create-failed', undefined);
-            }
-        }
-    }
-    /**
-     * Start a new session with this agent.
-     */
-    async login(opts) {
-        try {
-            const res = await this.api.com.atproto.server.createSession({
-                identifier: opts.identifier,
-                password: opts.password,
-            });
-            this.session = {
-                accessJwt: res.data.accessJwt,
-                refreshJwt: res.data.refreshJwt,
-                handle: res.data.handle,
-                did: res.data.did,
-                email: res.data.email,
-                emailConfirmed: res.data.emailConfirmed,
-            };
-            this._updateApiEndpoint(res.data.didDoc);
-            return res;
-        }
-        catch (e) {
-            this.session = undefined;
-            throw e;
-        }
-        finally {
-            if (this.session) {
-                this._persistSession?.('create', this.session);
-            }
-            else {
-                this._persistSession?.('create-failed', undefined);
-            }
-        }
-    }
-    /**
-     * Resume a pre-existing session with this agent.
-     */
-    async resumeSession(session) {
-        try {
-            this.session = session;
-            const res = await this.api.com.atproto.server.getSession();
-            if (res.data.did !== this.session.did) {
-                throw new xrpc_2.XRPCError(xrpc_2.ResponseType.InvalidRequest, 'Invalid session', 'InvalidDID');
-            }
-            this.session.email = res.data.email;
-            this.session.handle = res.data.handle;
-            this.session.emailConfirmed = res.data.emailConfirmed;
-            this._updateApiEndpoint(res.data.didDoc);
-            this._persistSession?.('update', this.session);
-            return res;
-        }
-        catch (e) {
-            this.session = undefined;
-            if (e instanceof xrpc_2.XRPCError) {
-                /*
-                 * `ExpiredToken` and `InvalidToken` are handled in
-                 * `this_refreshSession`, and emit an `expired` event there.
-                 *
-                 * Everything else is handled here.
-                 */
-                if ([1, 408, 425, 429, 500, 502, 503, 504, 522, 524].includes(e.status)) {
-                    this._persistSession?.('network-error', undefined);
-                }
-                else {
-                    this._persistSession?.('expired', undefined);
-                }
-            }
-            else {
-                this._persistSession?.('network-error', undefined);
-            }
-            throw e;
-        }
-    }
-    /**
-     * Internal helper to add authorization headers to requests.
-     */
-    _addAuthHeader(reqHeaders) {
-        if (!reqHeaders.authorization && this.session?.accessJwt) {
-            return {
-                ...reqHeaders,
-                authorization: `Bearer ${this.session.accessJwt}`,
-            };
-        }
-        return reqHeaders;
-    }
-    /**
-     * Internal fetch handler which adds access-token management
-     */
-    async _fetch(reqUri, reqMethod, reqHeaders, reqBody) {
-        if (!AtpAgent.fetch) {
-            throw new Error('AtpAgent fetch() method not configured');
-        }
-        // wait for any active session-refreshes to finish
-        await this._refreshSessionPromise;
-        // send the request
-        let res = await AtpAgent.fetch(reqUri, reqMethod, this._addAuthHeader(reqHeaders), reqBody);
-        // handle session-refreshes as needed
-        if (isErrorResponse(res, ['ExpiredToken']) && this.session?.refreshJwt) {
-            // attempt refresh
-            await this.refreshSession();
-            // resend the request with the new access token
-            res = await AtpAgent.fetch(reqUri, reqMethod, this._addAuthHeader(reqHeaders), reqBody);
-        }
-        return res;
-    }
-    /**
-     * Internal helper to refresh sessions
-     * - Wraps the actual implementation in a promise-guard to ensure only
-     *   one refresh is attempted at a time.
-     */
-    async refreshSession() {
-        if (this._refreshSessionPromise) {
-            return this._refreshSessionPromise;
-        }
-        this._refreshSessionPromise = this._refreshSessionInner();
-        try {
-            await this._refreshSessionPromise;
-        }
-        finally {
-            this._refreshSessionPromise = undefined;
-        }
-    }
-    /**
-     * Internal helper to refresh sessions (actual behavior)
-     */
-    async _refreshSessionInner() {
-        if (!AtpAgent.fetch) {
-            throw new Error('AtpAgent fetch() method not configured');
-        }
-        if (!this.session?.refreshJwt) {
-            return;
-        }
-        // send the refresh request
-        const url = new URL((this.pdsUrl || this.service).origin);
-        url.pathname = `/xrpc/${REFRESH_SESSION}`;
-        const res = await AtpAgent.fetch(url.toString(), 'POST', {
-            authorization: `Bearer ${this.session.refreshJwt}`,
-        }, undefined);
-        if (isErrorResponse(res, ['ExpiredToken', 'InvalidToken'])) {
-            // failed due to a bad refresh token
-            this.session = undefined;
-            this._persistSession?.('expired', undefined);
-        }
-        else if (isNewSessionObject(this._baseClient, res.body)) {
-            // succeeded, update the session
-            this.session = {
-                ...(this.session || {}),
-                accessJwt: res.body.accessJwt,
-                refreshJwt: res.body.refreshJwt,
-                handle: res.body.handle,
-                did: res.body.did,
-            };
-            this._updateApiEndpoint(res.body.didDoc);
-            this._persistSession?.('update', this.session);
-        }
-        // else: other failures should be ignored - the issue will
-        // propagate in the _fetch() handler's second attempt to run
-        // the request
-    }
-    /**
-     * Helper to update the pds endpoint dynamically.
-     *
-     * The session methods (create, resume, refresh) may respond with the user's
-     * did document which contains the user's canonical PDS endpoint. That endpoint
-     * may differ from the endpoint used to contact the server. We capture that
-     * PDS endpoint and update the client to use that given endpoint for future
-     * requests. (This helps ensure smooth migrations between PDSes, especially
-     * when the PDSes are operated by a single org.)
-     */
-    _updateApiEndpoint(didDoc) {
-        if ((0, common_web_1.isValidDidDoc)(didDoc)) {
-            const endpoint = (0, common_web_1.getPdsEndpoint)(didDoc);
-            this.pdsUrl = endpoint ? new URL(endpoint) : undefined;
-        }
-        this.api.xrpc.uri = this.pdsUrl || this.service;
-    }
-}
-exports.AtpAgent = AtpAgent;
-/**
- * The `fetch` implementation; must be implemented for your platform.
- */
-Object.defineProperty(AtpAgent, "fetch", {
-    enumerable: true,
-    configurable: true,
-    writable: true,
-    value: xrpc_2.defaultFetchHandler
-});
-function isErrorObject(v) {
-    return xrpc_1.errorResponseBody.safeParse(v).success;
-}
-function isErrorResponse(res, errorNames) {
-    if (res.status !== 400) {
-        return false;
-    }
-    if (!isErrorObject(res.body)) {
-        return false;
-    }
-    return (typeof res.body.error === 'string' && errorNames.includes(res.body.error));
-}
-function isNewSessionObject(client, v) {
-    try {
-        client.xrpc.lex.assertValidXrpcOutput('com.atproto.server.refreshSession', v);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-//# sourceMappingURL=agent.js.map