@stackonward/onex-cms-client 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StackOnward
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,16 @@
+# @stackonward/onex-cms-client
+
+Explicit OneX HTTP adapter for `@stackonward/cms-client`. It owns the
+`X-Product-Code` and `X-Preview-Token` headers and the canonical OneX error
+envelope, keeping those contracts out of the generic CMS client.
+
+```typescript
+import { createOneXCmsClient, createOneXCmsUpstreamHeaders } from "@stackonward/onex-cms-client";
+
+const cms = createOneXCmsClient({
+  baseUrl: "https://platform.example.com/api/v1/cms",
+  productCode: "product_alpha",
+});
+
+const upstreamHeaders = createOneXCmsUpstreamHeaders("product_alpha");
+```

package/dist/index.d.mts

@@ -0,0 +1,16 @@
+import { ErrorNormalizer } from '@stackonward/api-client';
+import { CmsClientConfig, CmsClient } from '@stackonward/cms-client';
+
+interface OneXCmsClientConfig extends Omit<CmsClientConfig, "errorNormalizer" | "headers"> {
+    productCode: string;
+    previewToken?: string;
+    headers?: HeadersInit;
+}
+declare const oneXCmsErrorNormalizer: ErrorNormalizer;
+/** 构建供 CMS Nuxt 上游配置使用的 OneX 产品上下文头。 */
+declare function createOneXCmsUpstreamHeaders(productCode: string): Record<string, string>;
+/** 创建显式绑定 OneX HTTP 合同的 CMS 客户端。 */
+declare function createOneXCmsClient(config: OneXCmsClientConfig): CmsClient;
+
+export { createOneXCmsClient, createOneXCmsUpstreamHeaders, oneXCmsErrorNormalizer };
+export type { OneXCmsClientConfig };

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import { ErrorNormalizer } from '@stackonward/api-client';
+import { CmsClientConfig, CmsClient } from '@stackonward/cms-client';
+
+interface OneXCmsClientConfig extends Omit<CmsClientConfig, "errorNormalizer" | "headers"> {
+    productCode: string;
+    previewToken?: string;
+    headers?: HeadersInit;
+}
+declare const oneXCmsErrorNormalizer: ErrorNormalizer;
+/** 构建供 CMS Nuxt 上游配置使用的 OneX 产品上下文头。 */
+declare function createOneXCmsUpstreamHeaders(productCode: string): Record<string, string>;
+/** 创建显式绑定 OneX HTTP 合同的 CMS 客户端。 */
+declare function createOneXCmsClient(config: OneXCmsClientConfig): CmsClient;
+
+export { createOneXCmsClient, createOneXCmsUpstreamHeaders, oneXCmsErrorNormalizer };
+export type { OneXCmsClientConfig };

package/dist/index.mjs

@@ -0,0 +1,72 @@
+import { ApiHttpError, NormalizedApiError } from '@stackonward/api-client';
+import { CmsApiError, CmsClient } from '@stackonward/cms-client';
+
+function parseErrorEnvelope(body) {
+  if (typeof body !== "object" || body === null || !("error" in body)) {
+    return null;
+  }
+  const error = body.error;
+  if (typeof error !== "object" || error === null || typeof error.code !== "string" || typeof error.message !== "string" || typeof error.type !== "string") {
+    return null;
+  }
+  return error;
+}
+const oneXCmsErrorNormalizer = {
+  normalize(raw) {
+    if (raw instanceof CmsApiError) {
+      return raw;
+    }
+    if (raw instanceof ApiHttpError) {
+      const error = parseErrorEnvelope(raw.data);
+      return new CmsApiError(
+        raw.status,
+        error?.code ?? "UNKNOWN_ERROR",
+        error?.message ?? `OneX CMS request failed with status ${raw.status}`,
+        raw.data
+      );
+    }
+    if (raw instanceof NormalizedApiError) {
+      return new CmsApiError(
+        raw.statusCode ?? 0,
+        String(raw.code ?? raw.kind).toUpperCase(),
+        raw.message,
+        raw.body
+      );
+    }
+    return new CmsApiError(
+      0,
+      "NETWORK_ERROR",
+      raw instanceof Error ? raw.message : "OneX CMS request failed",
+      raw
+    );
+  }
+};
+function assertProductCode(productCode) {
+  if (!/^[a-z][a-z0-9_]{1,49}$/.test(productCode)) {
+    throw new TypeError("OneX productCode must match ^[a-z][a-z0-9_]{1,49}$");
+  }
+}
+function createOneXCmsUpstreamHeaders(productCode) {
+  assertProductCode(productCode);
+  return { "X-Product-Code": productCode };
+}
+function createOneXCmsClient(config) {
+  assertProductCode(config.productCode);
+  const headers = new Headers(config.headers);
+  for (const [name, value] of Object.entries(createOneXCmsUpstreamHeaders(config.productCode))) {
+    headers.set(name, value);
+  }
+  if (config.previewToken) {
+    headers.set("X-Preview-Token", config.previewToken);
+  }
+  return new CmsClient({
+    baseUrl: config.baseUrl,
+    defaultLocale: config.defaultLocale,
+    timeout: config.timeout,
+    fetch: config.fetch,
+    headers,
+    errorNormalizer: oneXCmsErrorNormalizer
+  });
+}
+
+export { createOneXCmsClient, createOneXCmsUpstreamHeaders, oneXCmsErrorNormalizer };

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@stackonward/onex-cms-client",
+  "version": "0.0.1",
+  "description": "OneX HTTP contract adapter for the StackOnward CMS client",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/1yhy/stackonward.git",
+    "directory": "packages/integrations/onex/cms-client"
+  },
+  "dependencies": {
+    "@stackonward/cms-client": "0.0.1",
+    "@stackonward/api-client": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "unbuild": "^3.5.0",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "unbuild",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}