@oxy.so/mention-sdk 0.0.0-stage → 0.1.2

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import { MentionPublishInput } from '@oxy.so/mention-contracts';
+export declare class MentionPublishingError extends Error {
+    readonly status: number;
+    readonly unknownOutcome: boolean;
+    constructor(status: number, unknownOutcome: boolean);
+}
+/** A resource-scoped Oxy MCP OAuth token, never an ordinary Oxy human session. */
+export declare class MentionPublishingClient {
+    private readonly options;
+    constructor(options: {
+        accessToken: string;
+        apiOrigin?: string;
+        publicOrigin?: string;
+        fetch?: typeof fetch;
+    });
+    private request;
+    identity(): Promise<{
+        oxyUserId: string;
+        handle: string;
+        displayName: string;
+    }>;
+    /** The key is persisted by the caller before dispatch; Mention reserves it durably. */
+    publish(input: MentionPublishInput, effectKey: string): Promise<{
+        id: string;
+        url: string;
+    }>;
+}

package/dist/index.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MentionPublishingClient = exports.MentionPublishingError = void 0;
+const mention_contracts_1 = require("@oxy.so/mention-contracts");
+class MentionPublishingError extends Error {
+    status;
+    unknownOutcome;
+    constructor(status, unknownOutcome) {
+        super(unknownOutcome
+            ? 'Mention delivery outcome is unknown; do not issue a new effect key'
+            : 'Mention refused the request');
+        this.status = status;
+        this.unknownOutcome = unknownOutcome;
+    }
+}
+exports.MentionPublishingError = MentionPublishingError;
+/** A resource-scoped Oxy MCP OAuth token, never an ordinary Oxy human session. */
+class MentionPublishingClient {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async request(path, init) {
+        const origin = this.options.apiOrigin ?? 'https://api.mention.earth';
+        const response = await (this.options.fetch ?? fetch)(new URL(path, origin), {
+            ...init,
+            redirect: 'error',
+            signal: AbortSignal.timeout(20000),
+            headers: { Authorization: `Bearer ${this.options.accessToken}`, ...init?.headers },
+        });
+        if (!response.ok)
+            throw new MentionPublishingError(response.status, init?.method === 'POST' && (response.status >= 500 || response.status === 409));
+        return response.json();
+    }
+    async identity() {
+        return mention_contracts_1.MentionIdentity.parse(await this.request('/mcp/bundles/me'));
+    }
+    /** The key is persisted by the caller before dispatch; Mention reserves it durably. */
+    async publish(input, effectKey) {
+        if (!/^mcp:[a-f0-9]{64}$/.test(effectKey))
+            throw new Error('Invalid Mention effect key');
+        const body = mention_contracts_1.MentionPublishInput.parse(input);
+        const result = mention_contracts_1.MentionPublishResponse.parse(await this.request('/posts', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Idempotency-Key': effectKey,
+                'X-Oxy-MCP-Tool': 'create-post',
+            },
+            body: JSON.stringify(body),
+        }));
+        return {
+            id: result.post.id,
+            url: new URL(`/p/${encodeURIComponent(result.post.id)}`, this.options.publicOrigin ?? 'https://mention.earth').href,
+        };
+    }
+}
+exports.MentionPublishingClient = MentionPublishingClient;

package/package.json

@@ -1,6 +1,23 @@
 {
   "name": "@oxy.so/mention-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.2",
+  "type": "commonjs",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "bun test src"
+  },
+  "dependencies": {
+    "@oxy.so/mention-contracts": "0.1.2"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.