pesanle-theme 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pesanle
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS 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 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,78 @@
-# Temporary Holding Version
+# pesanle-theme
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Compile and push a storefront theme to a [Pesanle](https://pesanle.id) shop:
+sign in, scaffold a project, push it as a draft, preview it, publish it live.
+
+```bash
+npx pesanle-theme login                 # once per machine
+npx pesanle-theme init ./my-theme --shop my-shop
+cd my-theme
+npx pesanle-theme push                  # compile → the shop's draft
+npx pesanle-theme preview               # a signed link that draws the draft
+npx pesanle-theme publish               # the draft → live
+```
+
+The CLI talks to **Pesanle** and nothing else — no endpoint, project, database
+or API key. `login` signs you in with your Pesanle email and password; the
+dashboard mints a token for the machine and does all the compiling, storing
+and publishing server-side. Themes are authored in an HTML-first,
+Liquid-shaped language and **compiled** to a JavaScript render function:
+there is no interpreter at request time, and an unknown filter, a typo'd drop
+property or a missing snippet fails the push, not a shopper's page.
+
+- CLI reference: <https://github.com/ridhotamma/pesanle/blob/main/docs/THEME-CLI.md>
+- Language reference: <https://github.com/ridhotamma/pesanle/blob/main/docs/TEMPLATE-LANGUAGE.md>
+- How the engine works: <https://github.com/ridhotamma/pesanle/blob/main/docs/TEMPLATE_ENGINE.md>
+
+## Commands
+
+| Command                           | What it does                                                                       |
+| --------------------------------- | ---------------------------------------------------------------------------------- |
+| `login`                           | Sign in to Pesanle and store a token for this machine.                             |
+| `logout`                          | Revoke the token and forget it locally.                                            |
+| `whoami`                          | Show the signed-in account.                                                        |
+| `init [dir]`                      | Scaffold a working theme project and write `.pesanle.json` with `--shop`.          |
+| `push [dir]`                      | Send the folder to Pesanle, which compiles it and writes the shop's **draft**.     |
+| `publish [dir]`                   | Copy the draft live, with one version snapshot per publish. `--push` pushes first. |
+| `preview [dir]`                   | Print a signed link that draws the **draft** for an hour.                          |
+| `pull [dir]`                      | Write the shop's published theme back into the folder (`--draft` for the draft).   |
+| `status [dir]`                    | The shop, its engine, and the draft and published versions.                        |
+| `engine <template\|page-builder>` | Flip which engine draws the shop.                                                  |
+
+Flags: `--shop`, `--name`, `--api`, `--email`, `--force`, `--draft`, `--push`,
+`--no-engine`.
+
+## Configuration
+
+- **`.pesanle.json`** — written by `init --shop`, safe to commit:
+  `{ "shop": "my-shop", "name": "My theme" }`.
+- **`~/.pesanle/credentials.json`** — the token `login` minted (mode `0600`);
+  `PESANLE_HOME` moves it. Never the password.
+- **`PESANLE_EMAIL` / `PESANLE_PASSWORD`** — for a non-interactive login (CI).
+- **`PESANLE_API_URL`** or **`--api`** — a self-hosted Pesanle dashboard.
+
+## What a theme looks like
+
+```
+my-theme/
+  layout/theme.tpl            the shell around every page of the shop
+  templates/index.tpl         home
+  templates/product.tpl       a product page
+  templates/catalog.tpl       the catalogue
+  snippets/product-card.tpl   a partial
+  assets/theme.css            scoped under .theme
+```
+
+A route the theme does not define is drawn by the platform's default theme,
+so a project can start with one page and grow. Interactive pieces — the buy
+box, reviews, the order-tracking form — arrive as host slots
+(`{% slot 'productPurchase' %}`); a theme never ships its own JavaScript.
+
+## Requirements
+
+Node 20.19 or newer. The CLI sends your theme files to your Pesanle dashboard
+and nothing else.
+
+## License
+
+MIT

package/dist/cli.js

@@ -0,0 +1,415 @@
+#!/usr/bin/env node
+// @bun
+import{existsSync as F0,mkdirSync as j,writeFileSync as T0}from"fs";import{basename as w,join as l,resolve as d}from"path";class G extends Error{status;diagnostics;name="CliApiError";constructor($,K,N=[]){super($);this.status=K;this.diagnostics=N}}class H{options;constructor($){this.options=$}async request($,K={}){let N={"content-type":"application/json"};if(this.options.token)N.authorization=`Bearer ${this.options.token}`;let W;try{W=await fetch(`${this.options.api.replace(/\/+$/,"")}${$}`,{method:K.method??"GET",headers:N,body:K.body===void 0?void 0:JSON.stringify(K.body)})}catch(Q){throw new G(`Could not reach ${this.options.api} — ${Q.message}`,0)}let b=await W.json().catch(()=>({}));if(!W.ok||b.ok!==!0)throw new G(b.error??`The API answered ${W.status}.`,W.status,b.diagnostics??[]);return b.data}async login($,K,N){return this.request("/api/cli/login",{method:"POST",body:{email:$,password:K,name:N}})}async logout(){await this.request("/api/cli/logout",{method:"POST"})}async me(){return this.request("/api/cli/me")}async theme($){return this.request(`/api/cli/shops/${encodeURIComponent($)}/theme`)}async push($,K,N){return this.request(`/api/cli/shops/${encodeURIComponent($)}/theme/draft`,{method:"PUT",body:{files:K,name:N}})}async publish($){return this.request(`/api/cli/shops/${encodeURIComponent($)}/theme/publish`,{method:"POST"})}async files($,K){return this.request(`/api/cli/shops/${encodeURIComponent($)}/theme/files${K?"?draft=1":""}`)}async preview($){return this.request(`/api/cli/shops/${encodeURIComponent($)}/theme/preview`)}async engine($,K){return this.request(`/api/cli/shops/${encodeURIComponent($)}/engine`,{method:"POST",body:{engine:K}})}}import{chmodSync as n,existsSync as S,mkdirSync as t,readFileSync as E,rmSync as s,writeFileSync as y}from"node:fs";import{homedir as r}from"node:os";import{dirname as a,join as q}from"node:path";var x=".pesanle.json",I="https://dashboard.pesanle.com";function D($){let K=q($,x);if(!S(K))return null;try{let N=JSON.parse(E(K,"utf8"));if(typeof N.shop!=="string"||!N.shop)return null;return{shop:N.shop,name:typeof N.name==="string"?N.name:void 0}}catch{return null}}function L($,K){y(q($,x),`${JSON.stringify({shop:K.shop,...K.name?{name:K.name}:{}},null,2)}
+`)}function _(){let $=process.env.PESANLE_HOME?.trim()||q(r(),".pesanle");return q($,"credentials.json")}function M(){let $=_();if(!S($))return null;try{let K=JSON.parse(E($,"utf8"));if(typeof K.token!=="string"||!K.token)return null;return{api:typeof K.api==="string"&&K.api?K.api:I,token:K.token,email:typeof K.email==="string"?K.email:void 0,name:typeof K.name==="string"?K.name:void 0}}catch{return null}}function v($){let K=_();t(a(K),{recursive:!0,mode:448}),y(K,`${JSON.stringify($,null,2)}
+`,{mode:384}),n(K,384)}function k(){s(_(),{force:!0})}function O($){return $?.trim()||process.env.PESANLE_API_URL?.trim()||M()?.api||I}import{readdirSync as e,readFileSync as $0}from"node:fs";import{join as K0,relative as N0,sep as W0}from"node:path";var b0=[".tpl",".css"];function m($){let K={},N=(W)=>{for(let b of e(W,{withFileTypes:!0})){if(b.name.startsWith("."))continue;let Q=K0(W,b.name);if(b.isDirectory())N(Q);else if(b0.some((B)=>b.name.endsWith(B)))K[N0($,Q).split(W0).join("/")]=$0(Q,"utf8")}};return N($),K}var T=($)=>`\x1B[1m${$}\x1B[0m`,u=($)=>`\x1B[2m${$}\x1B[0m`,z0=($)=>`\x1B[32m${$}\x1B[0m`,Q0=($)=>`\x1B[33m${$}\x1B[0m`,V0=($)=>`\x1B[31m${$}\x1B[0m`,F=0;function X($){F+=1,console.log(`
+${u(`[${F}]`)} ${T($)}`)}function V($){console.log(`  ${z0("OK")}   ${$}`)}function z($){console.log(`       ${u($)}`)}function R($){console.log(`  ${Q0("WARN")} ${$}`)}function U($){console.error(`  ${V0("FAIL")} ${$}`)}function f(){F=0}import{createInterface as Z0}from"node:readline";async function h($,K=""){if(!process.stdin.isTTY)return K;let N=Z0({input:process.stdin,output:process.stdout});try{return(await new Promise((b)=>N.question(`${$}: `,b))).trim()||K}finally{N.close()}}async function p($,K){let N=process.env[K]?.trim();if(N)return N;if(!process.stdin.isTTY)throw Error(`No terminal to prompt on: set ${K}.`);let W=process.stdin,b=W.isRaw;return process.stdout.write(`${$}: `),new Promise((Q,B)=>{let Z="",A=(i)=>{for(let Y of i.toString("utf8")){if(Y===`
+`||Y==="\r"){if(C(),process.stdout.write(`
+`),!Z)B(Error("Nothing was entered."));else Q(Z);return}if(Y==="\x03"){C(),process.stdout.write(`
+`),B(Error("Cancelled."));return}if(Y===""||Y==="\b"){Z=Z.slice(0,-1);continue}Z+=Y}},C=()=>{if(W.removeListener("data",A),W.setRawMode)W.setRawMode(b??!1);W.pause()};if(W.resume(),W.setRawMode)W.setRawMode(!0);W.on("data",A)})}import{existsSync as B0,mkdirSync as X0,writeFileSync as Y0}from"node:fs";import{dirname as H0,join as J0}from"node:path";var G0=`<div class="theme">
+  <header class="theme-header">
+    <a class="theme-brand" href="{{ routes.home }}">{{ shop.name }}</a>
+    <nav class="theme-nav">
+      <a href="{{ routes.products }}">Shop</a>
+      {% for category in categories limit: 4 %}
+        <a href="{{ category.url }}">{{ category.name }}</a>
+      {% endfor %}
+    </nav>
+    <div class="theme-actions">
+      <a href="{{ routes.search }}">Search</a>
+      {% slot 'cartTrigger' %}
+    </div>
+  </header>
+
+  <main class="theme-main">{{ content_for_layout }}</main>
+
+  <footer class="theme-footer">
+    <p>{{ shop.name }}</p>
+    <p>{{ shop.address | default: shop.email }}</p>
+  </footer>
+
+  {% slot 'cartDrawer' %}
+</div>
+`,M0=`<section class="hero">
+  <div>
+    <h1>{{ shop.name }}</h1>
+    <p>{{ shop.description | default: 'Everything we make, in one place.' }}</p>
+    <a class="button" href="{{ routes.products }}">Shop all</a>
+  </div>
+  {% if shop.banner_url %}
+    <img class="hero-image" src="{{ shop.banner_url }}" alt="{{ shop.name }}" />
+  {% endif %}
+</section>
+
+<section class="band">
+  <h2>New arrivals</h2>
+  <div class="grid">
+    {% for product in latest limit: 8 %}
+      {% render 'product-card', product: product %}
+    {% endfor %}
+  </div>
+</section>
+`,q0=`<article class="product">
+  <div class="gallery">
+    {% for image in product.images limit: 4 %}
+      {% if image.url %}<img src="{{ image.url }}" alt="{{ product.title }}" />{% endif %}
+    {% endfor %}
+  </div>
+
+  <div class="product-info">
+    <h1>{{ product.title }}</h1>
+    <p class="price">
+      {{ product.price | money }}
+      {% if product.on_sale %}<s>{{ product.compare_at_price | money }}</s>{% endif %}
+    </p>
+    {% if product.available != blank and product.available <= 0 %}
+      <p class="sold-out">Sold out</p>
+    {% endif %}
+
+    <div class="buy">{% slot 'productPurchase' %}</div>
+
+    {% if product.description %}<p class="description">{{ product.description }}</p>{% endif %}
+  </div>
+</article>
+
+{% if product.related.size > 0 %}
+  <section class="band">
+    <h2>You may also like</h2>
+    <div class="grid">
+      {% for related in product.related limit: 4 %}
+        {% render 'product-card', product: related %}
+      {% endfor %}
+    </div>
+  </section>
+{% endif %}
+`,I0=`<section class="listing-head">
+  <h1>{{ listing.title }}</h1>
+  {% if listing.description %}<p>{{ listing.description }}</p>{% endif %}
+</section>
+
+<p class="count">{{ listing.total }} products</p>
+
+<div class="grid">
+  {% for product in listing.products limit: 12 %}
+    {% render 'product-card', product: product %}
+  {% endfor %}
+</div>
+
+{% if listing.pages > 1 %}
+  <nav class="pager">
+    {% for pageNumber in (1..listing.pages) %}
+      {% if pageNumber == listing.page %}
+        <span class="current">{{ pageNumber }}</span>
+      {% else %}
+        <a href="{{ pageNumber | page_url }}">{{ pageNumber }}</a>
+      {% endif %}
+    {% endfor %}
+  </nav>
+{% endif %}
+`,O0=`<article class="page">
+  <p class="eyebrow">{{ shop.name }}</p>
+  <h1>{{ page.title }}</h1>
+  <p>
+    This page is the theme's own: <code>templates/pages/about.tpl</code> answers
+    <code>/about</code>. Rename the file to change the address, or delete it and
+    build the page in the dashboard instead.
+  </p>
+</article>
+`,R0=`<a class="card" href="{{ product.url }}">
+  <span class="card-media">
+    {% if product.image_url %}
+      <img src="{{ product.image_url }}" alt="{{ product.title }}" loading="lazy" />
+    {% endif %}
+    {% if product.on_sale %}<span class="badge">Sale</span>{% endif %}
+  </span>
+  <span class="card-name">{{ product.title }}</span>
+  <span class="card-price">
+    {{ product.price | money }}
+    {% if product.on_sale %}<s>{{ product.compare_at_price | money }}</s>{% endif %}
+  </span>
+</a>
+`,D0=`/* Scoped under .theme — the wrapper the storefront puts around the theme. */
+.theme {
+  background: #faf9f6;
+  color: #171512;
+  font-family: var(--chakra-fonts-body);
+  min-height: 100dvh;
+}
+
+.theme a {
+  color: inherit;
+  text-decoration: none;
+}
+
+.theme img {
+  display: block;
+  max-width: 100%;
+}
+
+.theme-header {
+  align-items: center;
+  border-bottom: 1px solid #e6e2da;
+  display: flex;
+  gap: 2rem;
+  justify-content: space-between;
+  padding: 1rem clamp(1rem, 4vw, 2.5rem);
+}
+
+.theme-brand {
+  font-family: var(--chakra-fonts-heading);
+  font-size: 1.3rem;
+  font-weight: 700;
+}
+
+.theme-nav,
+.theme-actions {
+  display: flex;
+  gap: 1.2rem;
+  font-size: 0.95rem;
+}
+
+.theme-main {
+  margin: 0 auto;
+  max-width: 1200px;
+  padding: 0 clamp(1rem, 4vw, 2.5rem);
+}
+
+.theme-footer {
+  border-top: 1px solid #e6e2da;
+  color: #6f6a60;
+  font-size: 0.9rem;
+  margin-top: 4rem;
+  padding: 2rem clamp(1rem, 4vw, 2.5rem);
+}
+
+.hero {
+  align-items: center;
+  display: grid;
+  gap: 2.5rem;
+  padding: clamp(2rem, 5vw, 4rem) 0;
+}
+
+@media (min-width: 900px) {
+  .hero {
+    grid-template-columns: 1fr 1fr;
+  }
+}
+
+.hero h1 {
+  font-family: var(--chakra-fonts-heading);
+  font-size: clamp(2.2rem, 5vw, 3.8rem);
+  letter-spacing: -0.02em;
+  margin: 0;
+}
+
+.hero p {
+  color: #6f6a60;
+  line-height: 1.7;
+  margin: 1rem 0 1.5rem;
+  max-width: 32rem;
+}
+
+.hero-image {
+  aspect-ratio: 4 / 3;
+  border-radius: 1rem;
+  object-fit: cover;
+  width: 100%;
+}
+
+.button {
+  background: #171512;
+  border-radius: 999px;
+  color: #faf9f6;
+  display: inline-block;
+  font-weight: 600;
+  padding: 0.75rem 1.5rem;
+}
+
+.band {
+  padding-top: clamp(2rem, 5vw, 3.5rem);
+}
+
+.band h2 {
+  font-family: var(--chakra-fonts-heading);
+  font-size: clamp(1.4rem, 3vw, 2rem);
+  margin: 0 0 1.25rem;
+}
+
+.grid {
+  display: grid;
+  gap: 1rem;
+  grid-template-columns: repeat(2, 1fr);
+}
+
+@media (min-width: 800px) {
+  .grid {
+    grid-template-columns: repeat(4, 1fr);
+  }
+}
+
+.card {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.card-media {
+  aspect-ratio: 1;
+  background: #fff;
+  border: 1px solid #e6e2da;
+  border-radius: 0.9rem;
+  overflow: hidden;
+  position: relative;
+}
+
+.card-media img {
+  height: 100%;
+  object-fit: cover;
+  width: 100%;
+}
+
+.badge {
+  background: #d9f24e;
+  border-radius: 999px;
+  font-size: 0.7rem;
+  font-weight: 700;
+  left: 0.6rem;
+  padding: 0.2rem 0.55rem;
+  position: absolute;
+  text-transform: uppercase;
+  top: 0.6rem;
+}
+
+.card-name {
+  font-weight: 600;
+}
+
+.card-price,
+.price {
+  align-items: baseline;
+  display: flex;
+  gap: 0.5rem;
+}
+
+.card-price s,
+.price s {
+  color: #6f6a60;
+}
+
+.product {
+  display: grid;
+  gap: 2.5rem;
+  padding-top: 2rem;
+}
+
+@media (min-width: 900px) {
+  .product {
+    grid-template-columns: 1.1fr 1fr;
+  }
+}
+
+.gallery {
+  display: grid;
+  gap: 0.75rem;
+  grid-template-columns: 1fr 1fr;
+}
+
+.gallery img {
+  aspect-ratio: 1;
+  border-radius: 0.9rem;
+  object-fit: cover;
+  width: 100%;
+}
+
+.product-info {
+  align-self: start;
+  display: flex;
+  flex-direction: column;
+  gap: 0.9rem;
+}
+
+.product-info h1 {
+  font-family: var(--chakra-fonts-heading);
+  font-size: clamp(1.8rem, 4vw, 2.6rem);
+  margin: 0;
+}
+
+.description {
+  color: #6f6a60;
+  line-height: 1.75;
+  white-space: pre-line;
+}
+
+.sold-out {
+  color: #b42318;
+  font-weight: 600;
+}
+
+.listing-head {
+  padding-top: 2.5rem;
+}
+
+.listing-head h1 {
+  font-family: var(--chakra-fonts-heading);
+  font-size: clamp(1.9rem, 4vw, 3rem);
+  margin: 0;
+}
+
+.count {
+  color: #6f6a60;
+  font-size: 0.9rem;
+  margin: 1.5rem 0 1rem;
+}
+
+.pager {
+  display: flex;
+  gap: 0.5rem;
+  justify-content: center;
+  padding-top: 2rem;
+}
+
+.pager a,
+.pager span {
+  border: 1px solid #e6e2da;
+  border-radius: 0.5rem;
+  padding: 0.4rem 0.75rem;
+}
+
+.pager .current {
+  background: #171512;
+  color: #faf9f6;
+}
+`,L0=`# Theme project
+
+A storefront theme for Pesanle, authored in the compiled template language.
+The reference is \`docs/TEMPLATE-LANGUAGE.md\` in the Pesanle repository.
+
+\`\`\`bash
+pesanle-theme push       # compile and write the shop's draft
+pesanle-theme publish    # make the draft live
+pesanle-theme pull       # write the live theme back into this folder
+pesanle-theme status     # the shop, its engine, and both versions
+\`\`\`
+
+The API key comes from \`PESANLE_API_KEY\`; the shop and project live in
+\`.pesanle.json\`. The key is never written to the file.
+`;function _0(){return{"layout/theme.tpl":G0,"templates/index.tpl":M0,"templates/product.tpl":q0,"templates/catalog.tpl":I0,"snippets/product-card.tpl":R0,"templates/pages/about.tpl":O0,"assets/theme.css":D0,"README.md":L0}}function c($){let K=[],N=[];for(let[W,b]of Object.entries(_0())){let Q=J0($.dir,W);if(B0(Q)&&!$.force){N.push(W);continue}X0(H0(Q),{recursive:!0}),Y0(Q,b),K.push(W)}return{written:K,skipped:N}}function U0($){let K={command:$[0]??"",dir:"",shop:"",name:"",api:"",email:"",engine:"",force:!1,draft:!1,push:!1,noEngine:!1},N=$.slice(1);for(let W=0;W<N.length;W+=1){let b=N[W],[Q,B]=b.startsWith("--")?b.split("=",2):["",""],Z=()=>B??N[++W]??"";switch(Q){case"--dir":K.dir=Z();break;case"--shop":K.shop=Z();break;case"--name":K.name=Z();break;case"--api":K.api=Z();break;case"--email":K.email=Z();break;case"--force":K.force=!0;break;case"--draft":K.draft=!0;break;case"--push":K.push=!0;break;case"--no-engine":K.noEngine=!0;break;case"":if(!K.dir)K.dir=b;else if(!K.engine&&P(b))K.engine=b;break;default:throw Error(`Unknown flag "${b}".`)}}if(K.command==="engine"&&!K.engine&&P(K.dir))K.engine=K.dir,K.dir="";return K}function P($){return $==="template"||$==="page-builder"}function j0($){let K=M();if(!K)throw Error('Not signed in. Run "pesanle-theme login" first.');return new H({api:O($)||K.api,token:K.token})}function J($){let K=d($.dir||"."),N=D(K),W=$.shop||N?.shop||"";if(!W)throw Error('No shop given: pass --shop <slug>, or run "pesanle-theme init --shop <slug>" to write .pesanle.json.');return{dir:K,shop:W,name:$.name||N?.name||w(K),api:j0($.api)}}function P0($){for(let K of $.diagnostics){let N=K.file?`${K.file}${K.loc?.start?.line?`:${K.loc.start.line}:${K.loc.start.column??1}`:""} `:"";console.error(`       ${N}${K.code?`${K.code}: `:""}${K.message}`)}}async function w0($){let K=O($.api),N=$.email||process.env.PESANLE_EMAIL||await h("Email");if(!N)throw Error("An email is required.");let W=await p("Password (hidden)","PESANLE_PASSWORD"),b=$.name||`pesanle-theme on ${w(process.env.HOME??"this machine")}`;X("Sign in");let B=await new H({api:K}).login(N,W,b);v({api:K,token:B.token,email:B.user.email,name:b}),V(`Signed in as ${B.user.name} <${B.user.email}>`),z(`API: ${K}`),z("Next: pesanle-theme init ./my-theme --shop <shop>")}async function A0(){let $=M();if(X("Sign out"),!$){z("Not signed in.");return}try{await new H({api:$.api,token:$.token}).logout(),V("Token revoked")}catch(K){R(K.message)}k(),V("Signed out on this machine")}async function C0($){let K=M();if(!K)throw Error('Not signed in. Run "pesanle-theme login" first.');let W=await new H({api:O($.api)||K.api,token:K.token}).me();V(`${W.name} <${W.email}>`),z(`API: ${K.api}`)}async function S0($){let K=d($.dir||".");j(K,{recursive:!0});let N=$.name||w(K);X("Scaffold");let W=c({dir:K,name:N,force:$.force});V(`${W.written.length} files written${W.skipped.length?`, ${W.skipped.length} kept`:""}`);for(let b of W.skipped)z(`kept ${b}`);if($.shop)L(K,{shop:$.shop,name:N}),V(`.pesanle.json points at "${$.shop}"`);else R("No --shop given: add .pesanle.json (or pass --shop) before pushing.");console.log(`
+  ${N} is ready.`),z(`cd ${$.dir||"."} && pesanle-theme push`)}async function o($){let K=J($);X("Compile & push");let N=m(K.dir);if(Object.keys(N).length===0)throw Error(`No theme files under ${K.dir}. A theme needs at least templates/index.tpl \u2014 run "pesanle-theme init" first.`);let W=await K.api.push(K.shop,N,K.name);if(V(`${Object.keys(N).length} files \u2192 version ${W.version}`),W.warnings.length>0){R(`${W.warnings.length} warning(s)`);for(let b of W.warnings)z(`${b.file??""}${b.file?": ":""}${b.message}`)}if(!$.noEngine)V("Shop is on the template engine");z("Make it live with: pesanle-theme publish")}async function E0($){if($.push)await o($);let K=J($);X("Publish");let N=await K.api.publish(K.shop);V(`Live \u2014 version ${N.version}`),z(N.url)}async function y0($){let K=J($);X("Preview");let N=await K.api.preview(K.shop);V(`Draft version ${N.version}`),console.log(`
+  ${T("Open:")} ${N.url}
+`),z(`The link (and its cookie) lasts ${Math.round(N.expiresInSeconds/60)} minutes.`)}async function x0($){let K=J($);X("Pull");let N=await K.api.files(K.shop,$.draft);j(K.dir,{recursive:!0});let W=0,b=0;for(let[Q,B]of Object.entries(N.files)){let Z=l(K.dir,Q);if(F0(Z)&&!$.force){b+=1;continue}j(l(Z,".."),{recursive:!0}),T0(Z,B),W+=1}if(V(`${W} files written, ${b} kept (--force overwrites)`),!D(K.dir))L(K.dir,{shop:K.shop,name:K.name}),V(".pesanle.json written");z(`Pulled version ${N.version}`)}async function v0($){let K=J($);X("Shop");let N=await K.api.theme(K.shop);if(V(`${N.shop.name} (${N.shop.slug})`),z(`Engine: ${N.engine}`),X("Theme"),!N.draft&&!N.published){z("No template theme has been pushed to this shop.");return}if(N.draft)V(`Draft:     ${N.draft.version} \xB7 compiled ${N.draft.compiledAt} \xB7 ${N.draft.files} files`),z(`Routes:    ${N.draft.routes.join(", ")}`);else z("Draft:     none");z(N.published?`Published: ${N.published.version} \xB7 ${N.published.publishedAt??"unknown date"}`:"Published: none")}async function k0($){if(!P($.engine))throw Error("Usage: pesanle-theme engine <template|page-builder>");let K=J($),N=await K.api.engine(K.shop,$.engine);V(`${K.shop} now uses the ${N.engine} engine`)}var g=`pesanle-theme \u2014 compile and push a storefront theme to Pesanle
+
+  login [--api url] [--email you@example.com]
+  logout
+  whoami
+  init [dir] --shop <slug> [--name "My theme"] [--force]
+  push [dir] [--shop <slug>] [--name "My theme"] [--no-engine]
+  publish [dir] [--shop <slug>] [--push]
+  preview [dir] [--shop <slug>]
+  pull [dir] [--shop <slug>] [--draft] [--force]
+  status [dir] [--shop <slug>]
+  engine <template|page-builder> [--shop <slug>]
+
+Sign in once per machine; the shop lives in the project's .pesanle.json.
+Self-hosted Pesanle: pass --api (default ${I}) or set PESANLE_API_URL.`;async function m0(){let $=U0(process.argv.slice(2));switch(f(),$.command){case"login":return w0($);case"logout":return A0();case"whoami":return C0($);case"init":return S0($);case"push":return o($);case"publish":return E0($);case"preview":return y0($);case"pull":return x0($);case"status":return v0($);case"engine":return k0($);case"help":case"--help":case"-h":case"":console.log(g);return;default:throw Error(`Unknown command "${$.command}".
+
+${g}`)}}m0().catch(($)=>{if($ instanceof G){if(U($.message),P0($),$.status===401)z('Run "pesanle-theme login" to sign in again.');if($.diagnostics.length>0)z("Nothing was pushed; the shop keeps serving its current theme.")}else U($.message);process.exitCode=1});

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "pesanle-theme",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Compile and push a storefront theme to a Pesanle shop: scaffold, draft, publish, preview.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "pesanle-theme": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "keywords": [
+    "pesanle",
+    "theme",
+    "storefront",
+    "ecommerce",
+    "cli",
+    "template"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ridhotamma/pesanle.git",
+    "directory": "packages/theme-cli"
+  },
+  "homepage": "https://github.com/ridhotamma/pesanle/blob/main/docs/THEME-CLI.md",
+  "bugs": {
+    "url": "https://github.com/ridhotamma/pesanle/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "bun run scripts/build.ts",
+    "prepublishOnly": "bun run build",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "@repo/typescript-config": "workspace:*",
+    "@types/bun": "latest",
+    "typescript": "^5.9.3"
+  }
+}