配送ゾーンと料金(定額・重量・金額・X 以上無料)、配達目安、追跡 URL
コード6 ファイルコンテキスト約 445 トークンスキャン合格
インストール
$
genpm add @core/shipping含まれるもの
- src/lib/shipping/ にソースコード(6 ファイル)。 (15 KB)
- src/lib/shipping/AGENTS.md に AI ルール、加えて IDE 用のルールファイル。
- @core/cart, @core/contracts, @core/db, @core/money を自動で解決します。
README
このパッケージには README がありません。
約 445 トークン→ src/lib/shipping/AGENTS.md→ .cursor/rules/genpm-core-shipping.mdc
これは AI が src/lib/shipping で作業するときに読む内容そのものです。それ以外はコンテキストに追加されません。
@core/shipping — rules for AI agents
Purpose
Shipping zones (ISO country lists, * = rest of world) and rates per zone: flat price, weight and order-value
ranges, free shipping over an amount (after discounts) and delivery estimates in days. Registers the shipping
step (order 200) of the @core/cart totals pipeline and builds tracking URLs for common carriers.
No label purchase or live carrier quotes. Tables: shipping_zones, shipping_rates.
Map
index.ts— public API:upsertZone,upsertRate,ratesFor,zoneFor,trackingUrl,CARRIERS,shippingAdminResources.shipping.ts— rules and the totals step.admin.ts— admin resources.schema.ts— tables.
Integration
- Migrations as in
src/lib/db/AGENTS.md. Import this module at startup (it registers the totals step). - Create zones and rates in the admin (
...shippingAdminResources()insrc/genpm/admin.ts, permissionsshipping:read|update). - At checkout, store the country and the chosen rate on the cart:
setCartMeta(cart.id, { country: 'ES', shippingRateId }); list options withratesFor(totals, country)and showminDays–maxDaysbefore payment. - Tracking:
trackingUrl(carrier, number)when marking an order shipped (@core/orders). - Verify: a cart with country
ESgets the cheapest Spanish rate; one over the free threshold pays 0.
Conventions
- Prices in minor units of
STORE_CURRENCY; weights in grams from catalog variants. - Digital-only carts never get shipping.
- Show
no_shippingissues clearly and block checkout for those countries.
Don't
- Don't hide delivery times or shipping costs until after payment (EU consumer law requires them upfront).
- Don't trust a rate id or amount sent by the browser; the totals step recomputes it.
# @core/shipping — rules for AI agents
## Purpose
Shipping zones (ISO country lists, `*` = rest of world) and rates per zone: flat price, weight and order-value
ranges, free shipping over an amount (after discounts) and delivery estimates in days. Registers the `shipping`
step (order 200) of the @core/cart totals pipeline and builds tracking URLs for common carriers.
No label purchase or live carrier quotes. Tables: `shipping_zones`, `shipping_rates`.
## Map
- `index.ts` — public API: `upsertZone`, `upsertRate`, `ratesFor`, `zoneFor`, `trackingUrl`, `CARRIERS`, `shippingAdminResources`.
- `shipping.ts` — rules and the totals step. `admin.ts` — admin resources. `schema.ts` — tables.
## Integration
1. Migrations as in `src/lib/db/AGENTS.md`. Import this module at startup (it registers the totals step).
2. Create zones and rates in the admin (`...shippingAdminResources()` in `src/genpm/admin.ts`, permissions `shipping:read|update`).
3. At checkout, store the country and the chosen rate on the cart: `setCartMeta(cart.id, { country: 'ES', shippingRateId })`;
list options with `ratesFor(totals, country)` and show `minDays–maxDays` before payment.
4. Tracking: `trackingUrl(carrier, number)` when marking an order shipped (@core/orders).
5. Verify: a cart with country `ES` gets the cheapest Spanish rate; one over the free threshold pays 0.
## Conventions
- Prices in minor units of `STORE_CURRENCY`; weights in grams from catalog variants.
- Digital-only carts never get shipping.
- Show `no_shipping` issues clearly and block checkout for those countries.
## Don't
- Don't hide delivery times or shipping costs until after payment (EU consumer law requires them upfront).
- Don't trust a rate id or amount sent by the browser; the totals step recomputes it.
.genpmignore 適用後に組み込まれる正確なツリーです。固定先:
// Tablas de @core/shipping. Las recoge drizzle-kit vía src/lib/db/drizzle.config.ts.
import { boolean, index, integer, jsonb, pgTable, text } from 'drizzle-orm/pg-core';
import { primaryId, timestamps } from '../db/index.ts';
export const shippingZones = pgTable('shipping_zones', {
id: primaryId('shz'),
name: text('name').notNull(),
/** Códigos ISO 3166-1 alpha-2; `*` = resto del mundo. */
countries: jsonb('countries').$type<string[]>().notNull(),
position: integer('position').notNull().default(0),
...timestamps,
});
export const shippingRates = pgTable(
'shipping_rates',
{
id: primaryId('shr'),
zoneId: text('zone_id')
.notNull()
.references(() => shippingZones.id, { onDelete: 'cascade' }),
name: text('name').notNull(),
/** Precio en unidades menores de la moneda de la tienda. */
amount: integer('amount').notNull(),
/** Gratis si el subtotal (tras descuentos) llega a este importe. */
freeOver: integer('free_over'),
/** Rango de aplicación por peso del carrito (gramos) y por subtotal. */
minWeightGrams: integer('min_weight_grams'),
maxWeightGrams: integer('max_weight_grams'),
minSubtotal: integer('min_subtotal'),
maxSubtotal: integer('max_subtotal'),
/** Plazo de entrega estimado (días laborables), visible antes de pagar. */
minDays: integer('min_days'),
maxDays: integer('max_days'),
active: boolean('active').notNull().default(true),
position: integer('position').notNull().default(0),
...timestamps,
},
(t) => [index('shipping_rates_zone_idx').on(t.zoneId)],
);
export type ShippingZone = typeof shippingZones.$inferSelect;
export type ShippingRate = typeof shippingRates.$inferSelect;
このパッケージは MCP サーバーを宣言していません。
| バージョン | コミット | 公開日 | スキャン |
|---|---|---|---|
| 1.0.0 | 4e8e68d | 4 時間前 | スキャン合格 |
- npm
- zod ^4.0.0
- 提案
- GenPM は npm コマンドを提案し、あなたが承認した場合にのみ実行します。
- スキャン
- スキャン合格 · 指摘 0 件
- コミット
- v1.0.0 → 4e8e68d047c764a7a689d286d2e4119529ae11ee · 取得後に検証済み
- スクリプト
- なし。GenPM はパッケージのコードを実行しません。
- ライセンス
- MIT
- 品質
- 100/100
- 認識されたライセンス達成
- AGENTS.md に目的の説明がある達成
- AGENTS.md に統合手順がある達成
- AGENTS.md に規約や禁止事項がある達成
- テストを含む達成
- セキュリティスキャンに合格達成
- 過去 6 か月以内に公開達成
- 認証済みの公開者達成
- 概要とキーワード達成
- 報告
- 問題を見つけましたか?