---
title: SDK の概要
description: Cozeni の公式 SDK（JavaScript / TypeScript）。
---

Cozeni の公式 SDK はサーバーで動く JavaScript / TypeScript のパッケージです。お客様の権利の確認、商品の管理、機能フラグ、Next.js 用のヘルパー、CLI を含みます。購入者限定ページを組み込むだけなら、お客様の権利を確かめる `createCustomerClient`（Next.js では `@nulogic/cozeni-sdk/next` の関数）で足ります。

## パッケージ

- パッケージ名は `@nulogic/cozeni-sdk` です。npm で公開しています。ソースも [GitHub](https://github.com/nulogic-jp/cozeni-sdk) で公開しています。
- バージョンは固定して入れてください。例：`@nulogic/cozeni-sdk@0.8.0`
- Node.js 20 以上で動きます。標準の `fetch` を持つサーバー環境で使います。
- Next.js は `@nulogic/cozeni-sdk/next` を使うときだけ必要です。対応するバージョンは 15 と 16 です。

:::note
ブラウザで動かすコードには使えません。API キーを含むため、サーバーの中だけで使ってください。
:::

## 含まれるもの

| 名前 | 用途 |
| --- | --- |
| `@nulogic/cozeni-sdk` | お客様の権利の確認（`createCustomerClient`）と、商品の管理（`createManagementClient`）です。フレームワークに依存しません。 |
| `@nulogic/cozeni-sdk/next` | Next.js（App Router）用です。ハンドオフ、ページの認可、Route Handler、機能フラグを扱います。 |
| `cozeni`（CLI） | 商品の作成、購入リンクの取得、販売状態の確認、テスト購入を、ターミナルや AI エージェントから行います。 |
| 導入用の skill | AI エージェント向けの手順書です。`init` がプロジェクトに置きます。 |

## どれを使うか

| 作りたいもの | 使うもの |
| --- | --- |
| Next.js（App Router）の購入者限定ページ | [Next.js](/integrate/sdk/nextjs) の `@nulogic/cozeni-sdk/next` |
| Express、Hono など、ほかのサーバー | [JavaScript / TypeScript](/integrate/sdk/javascript) の `createCustomerClient` |
| 商品をプログラムから作る、更新する | [JavaScript / TypeScript](/integrate/sdk/javascript) の `createManagementClient` |
| 商品をターミナルや AI エージェントから作る | [CLI](/integrate/cli) の `cozeni` |

## 導入例

SDK のリポジトリに、そのまま動かせる導入例があります。

- [Next.js の導入例（`examples/nextjs`）](https://github.com/nulogic-jp/cozeni-sdk/tree/main/examples/nextjs)：買い切りの商品1つと、限定ページ1つの構成です。Next.js 16 で書かれています。
- [JavaScript サーバーの導入例（`examples/javascript-server`）](https://github.com/nulogic-jp/cozeni-sdk/tree/main/examples/javascript-server)：Web 標準の `Request` と `Response` で、限定ページ、限定の API、コードの交換を書いた例です。Node.js の HTTP サーバーで動かす例も含みます。

## 次に読むページ

**[JavaScript / TypeScript](/integrate/sdk/javascript)**

サーバーで使う関数と、接続先の選び方を説明します。

**[Next.js](/integrate/sdk/nextjs)**

proxy、ページの認可、機能フラグの関数を説明します。

**[Next.js に組み込む](/integrate/guides/nextjs)**

購入リンクと限定ページを、手順に沿って組み込みます。

**[CLI の概要](/integrate/cli)**

`cozeni` コマンドの使い方を説明します。
