@feelflow/ffid-sdk 0.1.0

package/dist/legal/index.js

@@ -0,0 +1,176 @@
+// src/constants.ts
+var DEFAULT_API_BASE_URL = "https://id.feelflow.co.jp";
+
+// src/legal/ffid-legal-client.ts
+var API_PREFIX = "/api/v1/legal/ext";
+var SDK_LOG_PREFIX = "[FFID Legal SDK]";
+var NO_CONTENT_STATUS = 204;
+var FFID_LEGAL_ERROR_CODES = {
+  /** API key is missing */
+  MISSING_API_KEY: "MISSING_API_KEY",
+  /** Network request failed (fetch threw) */
+  NETWORK_ERROR: "NETWORK_ERROR",
+  /** Server returned non-JSON response */
+  PARSE_ERROR: "PARSE_ERROR",
+  /** Server returned error without structured error body */
+  UNKNOWN_ERROR: "UNKNOWN_ERROR",
+  /** Input validation failed (empty required parameters) */
+  VALIDATION_ERROR: "VALIDATION_ERROR"
+};
+var noopLogger = {
+  debug: () => {
+  },
+  info: () => {
+  },
+  warn: () => {
+  },
+  error: (...args) => console.error(SDK_LOG_PREFIX, ...args)
+};
+var consoleLogger = {
+  debug: (...args) => console.debug(SDK_LOG_PREFIX, ...args),
+  info: (...args) => console.info(SDK_LOG_PREFIX, ...args),
+  warn: (...args) => console.warn(SDK_LOG_PREFIX, ...args),
+  error: (...args) => console.error(SDK_LOG_PREFIX, ...args)
+};
+function createFFIDLegalClient(config) {
+  if (!config.apiKey) {
+    throw new Error("FFID Legal Client: apiKey \u304C\u672A\u8A2D\u5B9A\u3067\u3059");
+  }
+  const baseUrl = config.apiBaseUrl ?? DEFAULT_API_BASE_URL;
+  const logger = config.logger ?? (config.debug ? consoleLogger : noopLogger);
+  async function fetchWithApiKey(endpoint, options = {}) {
+    const url = `${baseUrl}${API_PREFIX}${endpoint}`;
+    logger.debug("Fetching:", url);
+    let response;
+    try {
+      response = await fetch(url, {
+        ...options,
+        headers: {
+          "Content-Type": "application/json",
+          "X-Service-Api-Key": config.apiKey,
+          ...options.headers
+        }
+      });
+    } catch (error) {
+      logger.error("Network error:", { url, error });
+      return {
+        error: {
+          code: FFID_LEGAL_ERROR_CODES.NETWORK_ERROR,
+          message: error instanceof Error ? error.message : "\u30CD\u30C3\u30C8\u30EF\u30FC\u30AF\u30A8\u30E9\u30FC\u304C\u767A\u751F\u3057\u307E\u3057\u305F"
+        }
+      };
+    }
+    if (response.status === NO_CONTENT_STATUS) {
+      logger.debug("Response: 204 No Content (unexpected)", { url });
+      return {
+        error: {
+          code: FFID_LEGAL_ERROR_CODES.UNKNOWN_ERROR,
+          message: "\u4E88\u671F\u3057\u306A\u3044\u30EC\u30B9\u30DD\u30F3\u30B9: \u30B5\u30FC\u30D0\u30FC\u304B\u3089\u30B3\u30F3\u30C6\u30F3\u30C4\u304C\u8FD4\u3055\u308C\u307E\u305B\u3093\u3067\u3057\u305F"
+        }
+      };
+    }
+    let data;
+    try {
+      data = await response.json();
+    } catch (parseError) {
+      logger.error("Parse error:", { url, status: response.status, parseError });
+      return {
+        error: {
+          code: FFID_LEGAL_ERROR_CODES.PARSE_ERROR,
+          message: `\u30B5\u30FC\u30D0\u30FC\u304B\u3089\u4E0D\u6B63\u306A\u30EC\u30B9\u30DD\u30F3\u30B9\u3092\u53D7\u4FE1\u3057\u307E\u3057\u305F (status: ${response.status})`
+        }
+      };
+    }
+    logger.debug("Response:", response.status, data);
+    if (!response.ok || !data.success) {
+      return {
+        error: data.error ?? {
+          code: FFID_LEGAL_ERROR_CODES.UNKNOWN_ERROR,
+          message: "\u4E0D\u660E\u306A\u30A8\u30E9\u30FC\u304C\u767A\u751F\u3057\u307E\u3057\u305F"
+        }
+      };
+    }
+    if (data.data === void 0) {
+      return {
+        error: {
+          code: FFID_LEGAL_ERROR_CODES.UNKNOWN_ERROR,
+          message: "\u30B5\u30FC\u30D0\u30FC\u304B\u3089\u30C7\u30FC\u30BF\u304C\u8FD4\u3055\u308C\u307E\u305B\u3093\u3067\u3057\u305F"
+        }
+      };
+    }
+    return { data: data.data };
+  }
+  async function getDocuments() {
+    return fetchWithApiKey("/documents");
+  }
+  async function getDocument(documentId) {
+    if (!documentId) {
+      return {
+        error: {
+          code: FFID_LEGAL_ERROR_CODES.VALIDATION_ERROR,
+          message: "documentId is required"
+        }
+      };
+    }
+    return fetchWithApiKey(`/documents/${encodeURIComponent(documentId)}`);
+  }
+  async function recordAgreement(request) {
+    if (!request.externalUserId || !request.documentId) {
+      return {
+        error: {
+          code: FFID_LEGAL_ERROR_CODES.VALIDATION_ERROR,
+          message: "externalUserId and documentId are required"
+        }
+      };
+    }
+    return fetchWithApiKey("/agreements", {
+      method: "POST",
+      body: JSON.stringify(request)
+    });
+  }
+  async function checkAgreement(externalUserId, documentId) {
+    if (!externalUserId || !documentId) {
+      return {
+        error: {
+          code: FFID_LEGAL_ERROR_CODES.VALIDATION_ERROR,
+          message: "externalUserId and documentId are required"
+        }
+      };
+    }
+    const params = new URLSearchParams({
+      externalUserId,
+      documentId
+    });
+    return fetchWithApiKey(`/agreements/check?${params.toString()}`);
+  }
+  async function getPendingAgreements(externalUserId) {
+    if (!externalUserId) {
+      return {
+        error: {
+          code: FFID_LEGAL_ERROR_CODES.VALIDATION_ERROR,
+          message: "externalUserId is required"
+        }
+      };
+    }
+    const params = new URLSearchParams({ externalUserId });
+    return fetchWithApiKey(`/agreements/pending?${params.toString()}`);
+  }
+  return {
+    /** Get all legal documents available to this service */
+    getDocuments,
+    /** Get a specific legal document by ID */
+    getDocument,
+    /** Record a user's agreement to a legal document */
+    recordAgreement,
+    /** Check if a user has agreed to a specific document */
+    checkAgreement,
+    /** Get all documents that a user has not yet agreed to */
+    getPendingAgreements,
+    /** Resolved logger instance */
+    logger,
+    /** API base URL */
+    baseUrl
+  };
+}
+
+export { DEFAULT_API_BASE_URL, FFID_LEGAL_ERROR_CODES, createFFIDLegalClient };

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@feelflow/ffid-sdk",
+  "version": "0.1.0",
+  "description": "FeelFlow ID Platform SDK for React/Next.js applications",
+  "keywords": ["feelflow", "ffid", "sdk", "react", "nextjs", "authentication"],
+  "author": "FeelFlow <dev@feelflow.co.jp>",
+  "license": "MIT",
+  "homepage": "https://github.com/feel-flow/feelflow-id-platform/tree/develop/sdk/typescript#readme",
+  "bugs": {
+    "url": "https://github.com/feel-flow/feelflow-id-platform/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/feel-flow/feelflow-id-platform.git",
+    "directory": "sdk/typescript"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./components": {
+      "types": "./dist/components/index.d.ts",
+      "import": "./dist/components/index.js",
+      "require": "./dist/components/index.cjs"
+    },
+    "./legal": {
+      "types": "./dist/legal/index.d.ts",
+      "import": "./dist/legal/index.js",
+      "require": "./dist/legal/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "rm -rf dist && tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.0.0",
+    "@testing-library/react": "^16.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "jsdom": "^27.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}