@absolutejs/commerce 0.0.1-beta.0

package/LICENSE

@@ -0,0 +1,83 @@
+# Business Source License 1.1
+
+**Licensor:** Alex Kahn
+
+**Licensed Work:** @absolutejs/commerce (https://github.com/absolutejs/commerce)
+
+**Change Date:** June 22, 2030
+
+**Change License:** Apache License, Version 2.0
+
+---
+
+## Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, permitting limited production use.
+
+### Additional Use Grant
+
+You may use the Licensed Work in production, provided your use does not include
+any of the following:
+
+1. **Offering a Competing Service.** You may not offer the Licensed Work, or
+   any derivative or substantial portion of it, to third parties as a hosted or
+   managed service that competes with a hosted commerce, checkout, storefront,
+   or e-commerce backend platform (including, but not limited to, services like
+   Shopify, BigCommerce, Medusa Cloud, Commerce.js/Chec, Swell, or Saleor
+   Cloud). This includes any product whose primary value to its users is the
+   functionality the Licensed Work provides.
+
+2. **Resale or Redistribution as a Standalone Product.** You may not sell,
+   license, or distribute the Licensed Work, or any derivative or fork of it,
+   as a standalone commercial product.
+
+3. **Removal of Attribution.** Any derivative work, fork, or redistribution of
+   the Licensed Work must prominently credit AbsoluteJS and include a link to
+   the original project repository (https://github.com/absolutejs/commerce).
+
+For clarity, the following uses are expressly permitted:
+
+- Using the Licensed Work to build and operate your own stores, applications,
+  websites, internal tools, or SaaS products (whether commercial or
+  non-commercial), so long as the Licensed Work itself is not the primary
+  product you are selling.
+- Using the Licensed Work as a dependency in commercial software you build and
+  sell, as long as the software is not itself a competing managed service of
+  the kind described in clause 1.
+- Providing consulting, development, or professional services to clients using
+  the Licensed Work.
+- Forking and modifying the Licensed Work for your own internal use, provided
+  attribution is maintained.
+
+### Change Date and Change License
+
+On the Change Date specified above, or on such other date as the Licensor may
+specify by written notice, the Licensed Work will be made available under the
+Change License (Apache License, Version 2.0). Until the Change Date, the terms
+of this Business Source License 1.1 apply.
+
+### Trademark
+
+This license does not grant you any rights to use the "AbsoluteJS" or
+"@absolutejs" name, logo, or any related trademarks. Forks and derivative works
+must not be named or branded in a manner that suggests endorsement by or
+affiliation with AbsoluteJS or the Licensor.
+
+### Notices
+
+You must not remove or obscure any licensing, copyright, or other notices
+included in the Licensed Work.
+
+### No Warranty
+
+THE LICENSED WORK IS PROVIDED "AS IS". THE LICENSOR HEREBY DISCLAIMS ALL
+WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE LICENSOR BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR
+IN CONNECTION WITH THE LICENSED WORK OR THE USE OR OTHER DEALINGS IN THE
+LICENSED WORK.
+
+---

package/README.md

@@ -0,0 +1,45 @@
+# @absolutejs/commerce
+
+Provider-agnostic commerce primitives for [AbsoluteJS](https://absolutejs.ai)
+apps — so every shop isn't rebuilding cart, checkout, orders, and fulfillment
+from scratch.
+
+Follows the same shape as `@absolutejs/voice`: a host package holds the
+**agnostic logic + adapter contracts**, and provider implementations live in
+the [`commerce-adapters`](https://github.com/absolutejs/commerce-adapters)
+monorepo (Apache-2.0).
+
+## v0 — shipping contract
+
+The first slice is the carrier-agnostic shipping interface. Apps program against
+`ShippingProvider`; a carrier adapter (e.g. `@absolutejs/commerce-easypost`)
+implements it, so a shop can plug in whatever carrier account it already uses.
+
+```ts
+import type { ShippingProvider } from '@absolutejs/commerce';
+import { createEasyPostProvider } from '@absolutejs/commerce-easypost';
+
+const shipping: ShippingProvider = createEasyPostProvider({
+	apiKey: process.env.EASYPOST_API_KEY!
+});
+
+const label = await shipping.buyCheapestLabel({ from, to, parcel });
+// → { trackingNumber, labelUrl, carrier, service, amount, … }
+```
+
+## Roadmap
+
+Being lifted from real AbsoluteJS shops next, against the same adapter pattern:
+
+- Cart + pricing engine (variants, options, quantity breaks, setup fees)
+- Order lifecycle + production-stage state machine
+- `PaymentProvider` contract (Stripe adapter) + server-side re-pricing + webhook
+  fulfillment
+- Discount-code engine
+- B2B quotes → deposit → fulfill
+- Branded transactional emails, proof-approval, `./drizzle` schema builders,
+  and a `./client` cart SDK
+
+## License
+
+BSL-1.1 (converts to Apache-2.0 on the Change Date in `LICENSE`).

package/dist/core/shipping.d.ts

@@ -0,0 +1,71 @@
+/** A postal address. `country` is an ISO-3166 alpha-2 code (e.g. "US"). */
+export type Address = {
+    name: string;
+    company?: string | null;
+    street1: string;
+    street2?: string | null;
+    city: string;
+    state: string;
+    zip: string;
+    country: string;
+    phone?: string | null;
+    email?: string | null;
+};
+/** Parcel dimensions (inches) and weight (ounces). */
+export type Parcel = {
+    lengthIn: number;
+    widthIn: number;
+    heightIn: number;
+    weightOz: number;
+};
+/** A purchasable rate quote from a carrier. */
+export type ShippingRate = {
+    /** Adapter-specific id, used to buy this exact rate. */
+    id: string;
+    carrier: string;
+    service: string;
+    /** Price in the smallest currency unit's major form (e.g. dollars). */
+    amount: number;
+    currency: string;
+    estDeliveryDays: number | null;
+};
+/** A purchased label, ready to print, with its tracking handle. */
+export type ShippingLabel = {
+    trackingNumber: string;
+    trackingUrl: string | null;
+    /** URL of the printable label (PDF/PNG). */
+    labelUrl: string;
+    carrier: string;
+    service: string;
+    amount: number;
+    currency: string;
+    rateId: string;
+    /** Adapter-specific shipment id (for follow-up calls). */
+    shipmentId: string;
+};
+export type RateInput = {
+    from: Address;
+    to: Address;
+    parcel: Parcel;
+};
+export type BuyInput = {
+    shipmentId: string;
+    rateId: string;
+};
+export type TrackResult = {
+    status: string;
+    estDelivery: string | null;
+    trackingUrl: string | null;
+};
+export type ShippingProvider = {
+    /** Quote all available rates for a parcel between two addresses. */
+    rates(input: RateInput): Promise<ShippingRate[]>;
+    /** Quote, pick the cheapest rate, and buy a label in one call. */
+    buyCheapestLabel(input: RateInput): Promise<ShippingLabel>;
+    /** Buy a specific previously-quoted rate. */
+    buyLabel(input: BuyInput): Promise<ShippingLabel>;
+    /** Current tracking status for a shipment. */
+    track(trackingNumber: string, carrier?: string): Promise<TrackResult>;
+};
+/** A sensible default parcel for small apparel orders (a poly mailer). */
+export declare const DEFAULT_APPAREL_PARCEL: Parcel;

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './core/shipping';

package/dist/index.js

@@ -0,0 +1,11 @@
+// @bun
+// src/core/shipping.ts
+var DEFAULT_APPAREL_PARCEL = {
+  heightIn: 2,
+  lengthIn: 12,
+  weightOz: 8,
+  widthIn: 9
+};
+export {
+  DEFAULT_APPAREL_PARCEL
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+	"name": "@absolutejs/commerce",
+	"version": "0.0.1-beta.0",
+	"description": "Provider-agnostic commerce primitives (cart, orders, fulfillment, shipping) for AbsoluteJS",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/absolutejs/commerce.git"
+	},
+	"homepage": "https://github.com/absolutejs/commerce",
+	"bugs": {
+		"url": "https://github.com/absolutejs/commerce/issues"
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE"
+	],
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"license": "BSL-1.1",
+	"author": "Alex Kahn",
+	"scripts": {
+		"build": "rm -rf dist && bun build ./src/index.ts --outdir dist --target bun && tsc --emitDeclarationOnly --project tsconfig.json",
+		"format": "prettier --write \"./**/*.{js,ts,json,md}\"",
+		"release": "bun run build && bun publish --tag beta",
+		"typecheck": "tsc --noEmit"
+	},
+	"devDependencies": {
+		"@types/bun": "1.3.9",
+		"typescript": "^5.9.3"
+	}
+}