Name: lip-sdk
Author: craveup-oss

Imported from craveup-oss/loyalty-interchange-protocol (skills/lip-sdk/SKILL.md). Install upstream with npx skills add craveup-oss/loyalty-interchange-protocol --skill lip-sdk. Copyright stays with the author.

LIP TypeScript SDK

Prefer LipClient over raw fetch. It supplies protocol context, validates requests and responses, and exposes typed errors.

import { LipClient } from "@loyalty-interchange/sdk";

const lip = new LipClient({
  baseUrl: process.env.LIP_URL!,
  apiKey: process.env.LIP_API_KEY!,
  source: { system: "my-app", instance: "production" }
});

Idempotency (required for mutations)

Derive keys from business ids, not random UUIDs per retry:

await lip.accruals.post(
  { member_id: memberId, order },
  { idempotencyKey: `accrual:${order.order_id}` }
);

For operator-issued bonus, gift, migration, service-recovery, or correction points, call lip.ledger.adjust(...) with a stable adjustment_id, a signed nonzero amount, a reason, and an explicit qualifies_for_tier boolean.

Runnable example

npm run example:sdk

Source: examples/typescript/full-lifecycle.ts

Reference

{ "ocm": "1", "id": "craveup-oss-loyalty-interchange-protocol-lip-sdk", "kind": "skill", "name": "lip-sdk", "description": "Use @loyalty-interchange/sdk LipClient for LIP integrations. Use when writing enroll, evaluate, accrue, reserve, capture, reverse, or adjust calls, handling LipApiError, building FoodserviceOrder payloads, or verifying webhooks.", "publisher": "craveup-oss", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Use @loyalty-interchange/sdk LipClient for LIP integrations. Use when writing enroll, evaluate, accrue, reserve, capture, reverse, or adjust calls, handling LipApiError, building FoodserviceOrder payloads, or verifying webhooks." ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/craveup-oss/loyalty-interchange-protocol", "path": "skills/lip-sdk/SKILL.md", "ref": "8ad93c81a414f5f7521061ddd88009083f4857aa", "url": "https://github.com/craveup-oss/loyalty-interchange-protocol/blob/8ad93c81a414f5f7521061ddd88009083f4857aa/skills/lip-sdk/SKILL.md", "key": "craveup-oss/loyalty-interchange-protocol/skills/lip-sdk/SKILL.md" } }, "instructions": "# LIP TypeScript SDK\n\nPrefer `LipClient` over raw `fetch`. It supplies protocol context, validates\nrequests and responses, and exposes typed errors.\n\n```ts\nimport { LipClient } from \"@loyalty-interchange/sdk\";\n\nconst lip = new LipClient({\n baseUrl: process.env.LIP_URL!,\n apiKey: process.env.LIP_API_KEY!,\n source: { system: \"my-app\", instance: \"production\" }\n});\n```\n\n## Idempotency (required for mutations)\n\nDerive keys from business ids, not random UUIDs per retry:\n\n```ts\nawait lip.accruals.post(\n { member_id: memberId, order },\n { idempotencyKey: `accrual:${order.order_id}` }\n);\n```\n\nFor ", "cost": { "context_tokens": 275 } }

lip-sdk

About

LIP TypeScript SDK

Idempotency (required for mutations)

Runnable example

Reference

Use it

Manifest

Reviews