somark-js 0.1.0

package/LICENSE

@@ -0,0 +1,156 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and
+distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright
+owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities
+that control, are controlled by, or are under common control with that entity.
+For the purposes of this definition, "control" means (i) the power, direct or
+indirect, to cause the direction or management of such entity, whether by
+contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising
+permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications, including
+but not limited to software source code, documentation source, and configuration
+files.
+
+"Object" form shall mean any form resulting from mechanical transformation or
+translation of a Source form, including but not limited to compiled object code,
+generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form, made
+available under the License, as indicated by a copyright notice that is included
+in or attached to the work.
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that
+is based on or derived from the Work and for which the editorial revisions,
+annotations, elaborations, or other modifications represent, as a whole, an
+original work of authorship. For the purposes of this License, Derivative Works
+shall not include works that remain separable from, or merely link (or bind by
+name) to the interfaces of, the Work.
+
+"Contribution" shall mean any work of authorship, including the original version
+of the Work and any modifications or additions to that Work or Derivative Works,
+that is intentionally submitted to Licensor for inclusion in the Work by the
+copyright owner or by an individual or Legal Entity authorized to submit on
+behalf of the copyright owner. For the purposes of this definition, "submitted"
+means any form of electronic, verbal, or written communication sent to the
+Licensor or its representatives, including but not limited to communication on
+electronic mailing lists, source code control systems, and issue tracking
+systems that are managed by, or on behalf of, the Licensor for the purpose of
+discussing and improving the Work, but excluding communication that is
+conspicuously marked or otherwise designated in writing by the copyright owner
+as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf
+of whom a Contribution has been received by Licensor and subsequently
+incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of this
+License, each Contributor hereby grants to You a perpetual, worldwide,
+non-exclusive, no-charge, royalty-free, irrevocable copyright license to
+reproduce, prepare Derivative Works of, publicly display, publicly perform,
+sublicense, and distribute the Work and such Derivative Works in Source or
+Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of this License,
+each Contributor hereby grants to You a perpetual, worldwide, non-exclusive,
+no-charge, royalty-free, irrevocable patent license to make, have made, use,
+offer to sell, sell, import, and otherwise transfer the Work, where such license
+applies only to those patent claims licensable by such Contributor that are
+necessarily infringed by their Contribution(s) alone or by combination of their
+Contribution(s) with the Work to which such Contribution(s) was submitted. If
+You institute patent litigation against any entity alleging that the Work or a
+Contribution incorporated within the Work constitutes direct or contributory
+patent infringement, then any patent licenses granted to You under this License
+for that Work shall terminate as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the Work or
+Derivative Works in any medium, with or without modifications, and in Source or
+Object form, provided that You meet the following conditions:
+
+(a) You must give any other recipients of the Work or Derivative Works a copy of
+this License; and
+
+(b) You must cause any modified files to carry prominent notices stating that You
+changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works that You
+distribute, all copyright, patent, trademark, and attribution notices from the
+Source form of the Work, excluding those notices that do not pertain to any part
+of the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its distribution, then
+any Derivative Works that You distribute must include a readable copy of the
+attribution notices contained within such NOTICE file, excluding those notices
+that do not pertain to any part of the Derivative Works, in at least one of the
+following places: within a NOTICE text file distributed as part of the Derivative
+Works; within the Source form or documentation, if provided along with the
+Derivative Works; or within a display generated by the Derivative Works, if and
+wherever such third-party notices normally appear. The contents of the NOTICE
+file are for informational purposes only and do not modify the License. You may
+add Your own attribution notices within Derivative Works that You distribute,
+alongside or as an addendum to the NOTICE text from the Work, provided that such
+additional attribution notices cannot be construed as modifying the License.
+
+You may add Your own copyright statement to Your modifications and may provide
+additional or different license terms and conditions for use, reproduction, or
+distribution of Your modifications, or for any such Derivative Works as a whole,
+provided Your use, reproduction, and distribution of the Work otherwise complies
+with the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise, any
+Contribution intentionally submitted for inclusion in the Work by You to the
+Licensor shall be under the terms and conditions of this License, without any
+additional terms or conditions. Notwithstanding the above, nothing herein shall
+supersede or modify the terms of any separate license agreement you may have
+executed with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade names,
+trademarks, service marks, or product names of the Licensor, except as required
+for reasonable and customary use in describing the origin of the Work and
+reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to in
+writing, Licensor provides the Work (and each Contributor provides its
+Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+either express or implied, including, without limitation, any warranties or
+conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any risks
+associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory, whether in
+tort (including negligence), contract, or otherwise, unless required by
+applicable law (such as deliberate and grossly negligent acts) or agreed to in
+writing, shall any Contributor be liable to You for damages, including any
+direct, indirect, special, incidental, or consequential damages of any character
+arising as a result of this License or out of the use or inability to use the
+Work (including but not limited to damages for loss of goodwill, work stoppage,
+computer failure or malfunction, or any and all other commercial damages or
+losses), even if such Contributor has been advised of the possibility of such
+damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing the Work or
+Derivative Works thereof, You may choose to offer, and charge a fee for,
+acceptance of support, warranty, indemnity, or other liability obligations and/or
+rights consistent with this License. However, in accepting such obligations, You
+may act only on Your own behalf and on Your sole responsibility, not on behalf
+of any other Contributor, and only if You agree to indemnify, defend, and hold
+each Contributor harmless for any liability incurred by, or claims asserted
+against, such Contributor by reason of your accepting any such warranty or
+additional liability.
+
+END OF TERMS AND CONDITIONS

package/README.md

@@ -0,0 +1,32 @@
+# somark-js
+
+[![Node >=18](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org/)
+[![License: Apache 2.0](https://img.shields.io/badge/license-Apache%202.0-blue)](./LICENSE)
+[![npm version](https://img.shields.io/npm/v/somark-js)](https://www.npmjs.com/package/somark-js)
+
+The official JavaScript/TypeScript SDK and CLI for [SoMark](https://somark.ai).
+
+This repository is the JavaScript/TypeScript implementation of the shared SoMark SDK + CLI contract. The Python implementation lives in [`somark-py`](https://github.com/SoMarkAI/somark-py). Same product, different runtime.
+
+## Install
+
+```bash
+npm install somark-js
+```
+
+## Documentation
+
+Read the official documentation at [docs.somark.tech/documentation](https://docs.somark.tech/open-source-tools).
+
+The docs cover authentication, CLI usage, SDK examples, async tasks, local preview, PDF utilities, API parameters, and error handling. This README stays intentionally short so it does not become a second, worse documentation site.
+
+## Requirements
+
+- Node.js 18+
+- A SoMark API key for remote parsing and usage queries
+- No API key required for local PDF utilities or SoMarkDown preview
+- Docker/Ubuntu Python PDF rendering may require system libraries: `apt-get install -y --no-install-recommends libxcb1 libgl1 libglib2.0-0`
+
+## License
+
+Apache-2.0

package/README_CN.md

@@ -0,0 +1,31 @@
+# somark-js
+
+[![Node >=18](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org/)
+[![License: Apache 2.0](https://img.shields.io/badge/license-Apache%202.0-blue)](./LICENSE)
+[![npm version](https://img.shields.io/npm/v/somark-js)](https://www.npmjs.com/package/somark-js)
+
+[SoMark](https://somark.ai) 官方 JavaScript/TypeScript SDK 与命令行工具。
+
+这个仓库是 SoMark SDK + CLI 统一规范的 JavaScript/TypeScript 实现。Python 实现在 [`somark-py`](https://github.com/SoMarkAI/somark-py)。同一个产品目标，两种语言生态。
+
+## 安装
+
+```bash
+npm install somark-js
+```
+
+## 文档
+
+官方文档请阅读：[docs.somark.tech/documentation](https://docs.somark.tech/open-source-tools)。
+
+认证、CLI、SDK 示例、异步任务、本地预览、PDF 工具、API 参数和错误处理都在那里。README 只保留入口信息，避免长成另一份更难维护的文档。
+
+## 环境要求
+
+- Node.js 18+
+- 远程解析和用量查询需要 SoMark API Key
+- 本地 PDF 工具与 SoMarkDown 预览不需要 API Key
+
+## 许可证
+
+Apache-2.0

package/dist/chunk-RWOUZTFQ.mjs

@@ -0,0 +1,236 @@
+// src/config.ts
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+var DEFAULT_BASE_URL = "https://somark.tech/api/v1";
+var DEFAULT_TIMEOUT = 60;
+var DEFAULT_MAX_RETRIES = 2;
+var CONFIG_FILE = path.join(os.homedir(), ".somark", "config.toml");
+var VALID_CONFIG_KEYS = ["api_key", "base_url", "timeout", "max_retries"];
+function parseOptionalString(value) {
+  return value === void 0 || value === null ? void 0 : String(value);
+}
+function parseString(value) {
+  return String(value);
+}
+function parseNumber(value) {
+  return Number(value);
+}
+function parseInteger(value) {
+  return Number.parseInt(String(value), 10);
+}
+function validateAny(_key, _value) {
+}
+function validateBaseUrl(key, value) {
+  if (!/^https?:\/\//i.test(String(value))) {
+    throw new Error(`Invalid ${key} "${value}". Must start with http:// or https://`);
+  }
+}
+function maskIdentity(value) {
+  return value;
+}
+function maskApiKey(value) {
+  return value.length > 8 ? `${value.slice(0, 4)}...${value.slice(-4)}` : "***";
+}
+function formatValue(value) {
+  return String(value);
+}
+var CONFIG_SCHEMA = [
+  {
+    key: "api_key",
+    envVar: "SOMARK_API_KEY",
+    optionKey: "apiKey",
+    defaultValue: void 0,
+    parse: parseOptionalString,
+    validate: validateAny,
+    mask: maskApiKey,
+    format: formatValue,
+    showWhenUnset: false
+  },
+  {
+    key: "base_url",
+    envVar: "SOMARK_BASE_URL",
+    optionKey: "baseUrl",
+    defaultValue: DEFAULT_BASE_URL,
+    parse: parseString,
+    validate: validateBaseUrl,
+    mask: maskIdentity,
+    format: formatValue,
+    showWhenUnset: true
+  },
+  {
+    key: "timeout",
+    envVar: "SOMARK_TIMEOUT",
+    optionKey: "timeout",
+    defaultValue: DEFAULT_TIMEOUT,
+    parse: parseNumber,
+    validate: validateAny,
+    mask: maskIdentity,
+    format: formatValue,
+    showWhenUnset: true
+  },
+  {
+    key: "max_retries",
+    envVar: "SOMARK_MAX_RETRIES",
+    optionKey: "maxRetries",
+    defaultValue: DEFAULT_MAX_RETRIES,
+    parse: parseInteger,
+    validate: validateAny,
+    mask: maskIdentity,
+    format: formatValue,
+    showWhenUnset: true
+  }
+];
+var CONFIG_SCHEMA_BY_KEY = new Map(
+  CONFIG_SCHEMA.map((entry) => [entry.key, entry])
+);
+function stripTomlComment(line) {
+  let quote;
+  let escaping = false;
+  for (let i = 0; i < line.length; i += 1) {
+    const char = line[i];
+    if (quote === '"') {
+      if (escaping) {
+        escaping = false;
+      } else if (char === "\\") {
+        escaping = true;
+      } else if (char === quote) {
+        quote = void 0;
+      }
+    } else if (quote === "'") {
+      if (char === quote) quote = void 0;
+    } else if (char === '"' || char === "'") {
+      quote = char;
+    } else if (char === "#") {
+      return line.slice(0, i);
+    }
+  }
+  return line;
+}
+function parseTomlValue(rawValue) {
+  const value = stripTomlComment(rawValue).trim();
+  if (value.startsWith('"') && value.endsWith('"')) {
+    return JSON.parse(value);
+  }
+  if (value.startsWith("'") && value.endsWith("'")) {
+    return value.slice(1, -1);
+  }
+  if (/^[+-]?(?:\d+\.?\d*|\.\d+)$/.test(value)) {
+    return Number(value);
+  }
+  return value;
+}
+function loadTomlConfig() {
+  if (!fs.existsSync(CONFIG_FILE)) return {};
+  try {
+    const content = fs.readFileSync(CONFIG_FILE, "utf-8");
+    const result = {};
+    for (const line of content.split("\n")) {
+      const trimmed = stripTomlComment(line).trim();
+      if (!trimmed || trimmed.startsWith("[")) continue;
+      const separatorIndex = trimmed.indexOf("=");
+      if (separatorIndex === -1) continue;
+      const key = trimmed.slice(0, separatorIndex).trim();
+      if (!VALID_CONFIG_KEYS.includes(key)) continue;
+      result[key] = parseTomlValue(trimmed.slice(separatorIndex + 1));
+    }
+    return result;
+  } catch {
+    return {};
+  }
+}
+function hasFileValue(file, key) {
+  const value = file[key];
+  return value !== void 0 && value !== null && value !== "";
+}
+function resolveSchemaEntry(entry, opts, file) {
+  let rawValue;
+  let source;
+  if (opts[entry.optionKey] !== void 0) {
+    rawValue = opts[entry.optionKey];
+    source = "explicit";
+  } else if (process.env[entry.envVar]) {
+    rawValue = process.env[entry.envVar];
+    source = "env";
+  } else if (hasFileValue(file, entry.key)) {
+    rawValue = file[entry.key];
+    source = "file";
+  } else {
+    rawValue = entry.defaultValue;
+    source = "default";
+  }
+  const value = entry.parse(rawValue);
+  entry.validate(entry.key, value);
+  return { value, source };
+}
+function resolveSchema(opts = {}) {
+  const file = loadTomlConfig();
+  return Object.fromEntries(
+    CONFIG_SCHEMA.map((entry) => [entry.key, resolveSchemaEntry(entry, opts, file)])
+  );
+}
+function resolveConfig(opts = {}) {
+  const resolved = resolveSchema(opts);
+  return {
+    apiKey: resolved.api_key.value,
+    baseUrl: resolved.base_url.value,
+    timeout: resolved.timeout.value,
+    maxRetries: resolved.max_retries.value
+  };
+}
+function saveConfig(values) {
+  for (const key of Object.keys(values)) {
+    const entry = CONFIG_SCHEMA_BY_KEY.get(key);
+    if (!entry) {
+      throw new Error(`Unknown config key "${key}". Valid keys: ${VALID_CONFIG_KEYS.join(", ")}`);
+    }
+    const parsedValue = entry.parse(values[key]);
+    entry.validate(key, parsedValue);
+  }
+  const dir = path.dirname(CONFIG_FILE);
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+  const existing = loadTomlConfig();
+  const merged = { ...existing, ...values };
+  const lines = Object.entries(merged).map(([k, v]) => `${k} = "${v}"`);
+  fs.writeFileSync(CONFIG_FILE, lines.join("\n") + "\n", "utf-8");
+  try {
+    fs.chmodSync(CONFIG_FILE, 384);
+  } catch {
+  }
+}
+function getConfigValue(key) {
+  const value = loadTomlConfig()[key];
+  return value === void 0 ? void 0 : String(value);
+}
+function maskConfigValue(key, value) {
+  return CONFIG_SCHEMA_BY_KEY.get(key)?.mask(value) ?? value;
+}
+function listConfig() {
+  return Object.fromEntries(
+    Object.entries(loadTomlConfig()).map(([key, value]) => [key, String(value)])
+  );
+}
+function listResolvedConfig() {
+  const result = {};
+  const resolved = resolveSchema();
+  for (const entry of CONFIG_SCHEMA) {
+    const { value, source } = resolved[entry.key];
+    if (value === void 0 && !entry.showWhenUnset) continue;
+    result[entry.key] = { value: entry.format(value), source };
+  }
+  return result;
+}
+
+export {
+  DEFAULT_BASE_URL,
+  DEFAULT_TIMEOUT,
+  DEFAULT_MAX_RETRIES,
+  CONFIG_FILE,
+  VALID_CONFIG_KEYS,
+  resolveConfig,
+  saveConfig,
+  getConfigValue,
+  maskConfigValue,
+  listConfig,
+  listResolvedConfig
+};