@gyldendalas/gyldendal-divine-api

中文文档
2.4.0发布于 2026/11/04MITTypeScriptESM + CJS构建来源已验证近 30 天下载 5818
中文使用文档
文档目录5 节
  1. 环境
  2. 当地服务
  3. 管理当地和托管服务
  4. 在不碰应用程序的情况下覆盖
  5. 每一次都报告过

Gyldendal 神灵API

Gyldendal的GU-D部门的API客户端集.

环境

每个服务都从 environment 传到 构造器( installationpurpose tYPO3装置,除非 serviceUrl 被明确给予.

环境决定:
production生产服务
development, (中文(简体) ), testing中转服务
local本机运行的服务,见下表:
testplaywright 模拟服务器 https://localhost:3010/services/<name>

当地服务

local 是在开发的同时自己管理服务。 服务就位 在一个预留的4110 -4180块, 相隔10个, 所以一个服务 和它自己的 依赖关系(DynamoDB local, 其管理UI) 在一起, 没有任何碰撞 前端( 3000- 3002 nuxt, 3010 模拟服务器), macOS AirPlay 接收器(5000,700),容器默认服务本身使用 8000,8001,5432,8983)或麻黄(49152和上)范围. 每个服务 docker-compose仅发布于127.0.0.1上的端口,下面的URL表示: 127.0.0.1 而不是当地东道主,原因如下:当地东道主决心 首先在 macOS 上, 仅一个 IPv4 的映射没有在听 。 这个 test 环境保存本地主机, 因为 Playwright 模拟服务器的证书 为这个名称而发布.

服务当地 URL端口来源
用户设置http://127.0.0.1:4110user_settings_service docker-company (DynamoDB 4111, admin 4112) (英语)
突出显示http://127.0.0.1:4120systime_highlight_server docker-compose-development (DynamoDB 4121, admin 4122, pgvector 4123) (美国英语)
pdf 生成器http://127.0.0.1:4130pdf_generation_service 嵌入式编组开发
写入任务http://127.0.0.1:4140stepwise_task_server docker-compose-development (DynamoDB 4141, admin 4142) (英语)
solr 代理服务器http://127.0.0.1:4150solr-proxy docker-compose-development (soler本身 4151) (英语)
标记http://127.0.0.1:4160此处保留; repo 尚未开发
AI 机器人http://127.0.0.1:4170此处保留; ai-bot-service 默认值为 3100
饼干同意记录http://127.0.0.1:4180此处保留; cookie_consent_service 默认值为 1337
花粉http://127.0.0.1:3200systime-appear-polly docker-compose-development;其集装箱端口3000由nuxt dev取出. 合成需要AWS证书,集装箱的CORS预飞目前拒绝 Authorization sDK 发送的页眉
考试(Gale CMS)https://galecms.test.tibalo.dk/api没有本地 Gale, 共享测试实例

盖尔也有一个QA安装,这不是它自己的环境—— quiz 唯一的服务是有一个。 它导出为 GALE_QA_URL 财务报告和审定财务报表 应用为覆盖, 因此 URL 保留在这个软件包中 :

import { GALE_QA_URL } from '@gyldendalas/gyldendal-divine-api';

environmentOverrides: { quiz: GALE_QA_URL }

TYPO3通过网站查询 site.sso.sso_overrides.galeQaEndpointEnabled。 。 。 . 这是一种测试安排,所以由打电话者决定是否遵守:a 生产中也应用了构造器重置,不同于环境 见下文.

管理当地和托管服务

environment 选择一个环境为一切, 这很少是什么 本地开发想要: 通常有一个服务运行在您的机器和 休息应该来自中转. environmentOverrides 说哪个环境 单个服务在其中解决,按下服务名称键 src/services/service_urls.ts数字 :

const divine = {
  environment,          // the installationpurpose, as always
  myAccountId,
  environmentOverrides: { highlight: 'local' }
};

new HighlightService(divine);   // http://127.0.0.1:4120
new TaggingService(divine);     // https://staging-tagging.services.systime.dk

在应用程序启动时将对象建构,并将同一对象交给 每一个服务, 所以混合生活在一个地方.

注意它命名为 环境,而不是一个 URL。 超常读取 因此,一个可以移动的服务,包括当地港口 服务您所超越的 —— 仍然为您在下一个版本上移动 软件包。 这就是保持 URL在这里的全部要点, 一个呼叫者 谁写一个URL 已经退出了.

对于终点,表格无法知道——非标准服务 端口、隧道、同事的分支部署—— 超接可能是 URL 相反:

environmentOverrides: { highlight: 'http://127.0.0.1:9999' }

serviceUrl 仍然工作, 仍然比其他一切。 这是正确的 此软件包完全不知道服务的工具, 而错误的软件包 当地的发展,它默默地选择你 不再做任何未来的改变 那个服务地址.

在不碰应用程序的情况下覆盖

超接也可以来自机器 而不是代码,它 把它完全置入仓库 每一次服务,无论是:

  • 环境变量 DIVINE_ENV_<SERVICE> —— 说 DIVINE_ENV_HIGHLIGHT, (中文(简体) ), DIVINE_ENV_PDF_GENERATOR,等等;
  • globalThis.__divineEnvironmentOverrides,由一个仅由 Nuxt 插件或 插入的脚本,这是其中唯一一个到达 浏览器捆绑 .

两者都采用与 environmentOverrides。一个 environmentOverrides 代码中的条目击败他们,环境变量击败他们 globalThis, (中文(简体) ), 也没有读过 environment 实值 production: 配置 离开乐队 是一个危险在那里 不管它碰巧说.

每一次都报告过

一种适用的取消——从四个机制中的任何一种, serviceUrl 包括——在第一次解决时写出这样的一行:

[gyldendal-divine-api] highlight is overridden: resolved to http://127.0.0.1:4120 instead of its "development" endpoint (source: environmentOverrides).

失败模式 这一切都是一个被遗忘的覆盖: 3周前和3周后出口的变量 忘记了 所以,通知不是沉默 在生产,它很重要 大部分,它命名源,因为"高光在127.0.0.1上"是一个 单凭自己就拼出谜题,一旦说出是谁的把手就不再是一个.

每个程序都写过一次 而不是每次请求, 因为每个电话上的警告都是没人读的警告 过 onOverride 改为 送别的地方去 console.warn,此软件包将写给 无他处:

new HighlightService({ ...divine, onOverride: ({ message }) => logger.warn(message) });

版本与发布记录

@gyldendalas/gyldendal-divine-api 共发布 68 个版本,首次发布于 2025/02/17;过去 12 个月发布了 41 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.4.0latest2026/11/0412 天前
2.3.02026/10/2720 天前
2.0.02026/09/241 个月前
2.0.0-rc.4next2026/09/221 个月前
1.2.02026/09/211 个月前
1.1.92026/09/152 个月前

关于 @gyldendalas/gyldendal-divine-api 的常见问题

如何安装 @gyldendalas/gyldendal-divine-api?

在项目目录运行 npm install @gyldendalas/gyldendal-divine-api,或使用 pnpm add / yarn add / bun add。

@gyldendalas/gyldendal-divine-api 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@gyldendalas/gyldendal-divine-api 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@gyldendalas/gyldendal-divine-api 可以商用吗?

@gyldendalas/gyldendal-divine-api 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gyldendalas/gyldendal-divine-api 的下载量有多少?

根据 npm 官方下载统计,@gyldendalas/gyldendal-divine-api 在 2026/10/17 – 2026/11/15 这 30 天内被下载 5,818 次,日均约 194 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gyldendalas/gyldendal-divine-api 还在维护吗?

最新版本 2.4.0 发布于 2026/11/04(12 天前);至今共发布 68 个版本,其中过去 12 个月发布了 41 个;首次发布于 2025/02/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。