A TypeScript coding guide for Medusa v2, an e-commerce framework. It covers strict typing, generated model types, service generics, dependency-container types, utility types, and module interfaces.

Use it when writing or reviewing TypeScript in a Medusa v2 project, especially service code, modules, and dependency injection.

It helps avoid type errors and mismatches when adding or changing Medusa services and modules. It also explains the project-specific rules that ordinary TypeScript knowledge may not cover.

ts-modern — Skill for Claude Code by OrcaQubits

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add OrcaQubits/agentic-commerce-skills-plugins --skill ts-modern

Clone the repo

git clone --depth 1 https://github.com/OrcaQubits/agentic-commerce-skills-plugins

Made for: Claude Code.

Or install medusa-commerce, the plugin that ships this one along with the rest of its 19 skills, 1 agent.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/orcaqubits/agentic-commerce-skills-plugins/ts-modern/github.svg)](https://agentmods.dev/skills/orcaqubits/agentic-commerce-skills-plugins/ts-modern)

Your own site

<a href="https://agentmods.dev/skills/orcaqubits/agentic-commerce-skills-plugins/ts-modern"><img src="https://agentmods.dev/badge/skills/orcaqubits/agentic-commerce-skills-plugins/ts-modern/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/orcaqubits/agentic-commerce-skills-plugins/ts-modern"><img src="https://agentmods.dev/badge/skills/orcaqubits/agentic-commerce-skills-plugins/ts-modern.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 47 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,966 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00047	$0.01966
Opus 5	$0.00023	$0.00983
Sonnet 5	$0.00009	$0.00393
Haiku 4.5	$0.00005	$0.00197

Measured 2d ago against content hash bf89b25bb6f6, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-16, from the pricing page.

Security

Grade A, and why

ts-modern scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

medusa-commerce/skills/ts-modern/SKILL.md · 195 lines

How it starts

The opening of the file, as written. The whole thing — 195 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Modern TypeScript for Medusa v2

Before writing code

Fetch live docs:

Web-search site:docs.medusajs.com typescript types modules for Medusa type patterns
Web-search site:www.typescriptlang.org docs handbook for latest TypeScript features
Web-search site:docs.medusajs.com DML infer type model for DML type inference
Fetch https://docs.medusajs.com/learn/fundamentals/modules/service-factory for service generics
Web-search site:docs.medusajs.com container dependency injection resolve for container typing

TypeScript Configuration in Medusa

Medusa v2 projects use strict TypeScript with specific compiler options:

Option	Value	Purpose
`strict`	`true`	Enable all strict type checks
`target`	`ES2021`	Modern JS output
`module`	`CommonJS`	Module system
`moduleResolution`	`node`	Node.js module resolution
`esModuleInterop`	`true`	CJS/ESM interop
`skipLibCheck`	`true`	Skip declaration file checks
`declaration`	`true`	Generate `.d.ts` files
`outDir`	`.medusa/server`	Build output directory

DML Type Inference

InferTypeOf Pattern

Medusa generates TypeScript types from DML model definitions. Use InferTypeOf to derive entity types without manual interface duplication:

// Fetch live docs for InferTypeOf import path
// and exact DML-to-type mapping behavior
import { InferTypeOf } from "@medusajs/framework/types"

DML Field	Inferred TypeScript Type
`.text()`	`string`
`.number()`	`number`
`.boolean()`	`boolean`
`.dateTime()`	`Date`
`.json()`	`Record<string, unknown>`
`.enum(values)`	Union literal type
`.id()`	`string`
`.hasOne(Model)`	Inferred model type
`.hasMany(Model)`	Array of inferred model type
`.belongsTo(Model)`	Inferred model type
`.nullable()`	`T

Service Generics

MedusaService Factory

The MedusaService factory generates a typed service class from DML models:

Read the full file on GitHub · 195 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2d ago First seen · 195 lines · 47 tokens per session scan A bf89b25bb6f6

Subscribe to this mod's changes

ts-modern is a skill published in the GitHub repository OrcaQubits/agentic-commerce-skills-plugins (39 stars, last pushed 2d ago), licensed MIT. It adds 47 tokens to every session and 1,966 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-15.

Backend and APIs Languages Magento TypeScript a2a acp agentic-commerce ucp webmcp

lucid-agents

Build, modify, review, debug, or deploy TypeScript services made with the Lucid Agents SDK. Use whenever a project imports @lucid-agents packages or the user asks about Lucid runtimes, entrypoints, adapters, payments, MPP, identity, wallets, A2A tasks, service UI, scaffolding, or deployment.

daydreamsai/lucid-agents · 75 tokens

near-api-js

Guide for developing with near-api-js v7 - the JavaScript/TypeScript library for NEAR blockchain interaction. Use when: (1) building apps that interact with NEAR blockchain, (2) creating/signing transactions, (3) calling smart contracts, (4) managing accounts and keys, (5) working with NEAR RPC API, (6) handling…

internet-court/internet-court-skill · 159 tokens

near-kit

TypeScript library for NEAR Protocol blockchain interaction. Use this skill when writing code that interacts with NEAR Protocol, including viewing contract data, calling contract methods, sending NEAR tokens, building transactions, creating type-safe contract wrappers, integrating wallets (Wallet Selector, HOT…

internet-court/internet-court-skill · 92 tokens

ts-modern

Getting it into your agent

Wrote this? Show the measurements

What it costs to keep this loaded

Grade A, and why

Nothing flagged

How it starts

Modern TypeScript for Medusa v2

Before writing code

TypeScript Configuration in Medusa

DML Type Inference

InferTypeOf Pattern

Service Generics

MedusaService Factory

What this file has done since we first saw it

Other skills, from other repositories

lucid-agents

near-api-js

near-kit

lucid-agents

lucid-agents

lucid-agents