@stapel/listings-react 0.1.0

package/dist/model/draft.js

@@ -0,0 +1,192 @@
+import { fromFeaturesDto, toFeaturesDto } from "@stapel/attributes-react";
+import { DEFAULT_LISTING_CURRENCY } from "../api/types.js";
+export const EMPTY_LOCATION = {
+    locationId: "",
+    locationLabel: "",
+    lat: null,
+    lon: null,
+    geohash: "",
+};
+/** A blank draft. `currency` defaults to the storefront's (owner verdict F6 —
+ * RUB), overridable per runtime and per call. */
+export function emptyDraftValues(options = {}) {
+    return {
+        categoryId: options.categoryId ?? "",
+        title: "",
+        description: "",
+        price: "",
+        currency: options.currency ?? DEFAULT_LISTING_CURRENCY,
+        language: options.language ?? "",
+        images: [],
+        location: EMPTY_LOCATION,
+        features: {},
+        countable: false,
+        stockQuantity: null,
+        autoRepublish: false,
+    };
+}
+function text(value) {
+    return value ?? "";
+}
+/**
+ * A reopened draft: the server's `*_draft` fields → the composer's values.
+ *
+ * `features_draft` is `null` on a listing nobody has filled in yet, which is
+ * not the same as `{}` on the wire but is the same thing to a composer.
+ */
+export function draftValuesFromWire(draft, options = {}) {
+    const base = emptyDraftValues(options);
+    return {
+        categoryId: text(draft.category_id),
+        title: text(draft.title_draft),
+        description: text(draft.description_draft),
+        price: text(draft.price_draft),
+        currency: draft.currency !== undefined && draft.currency.length > 0
+            ? draft.currency
+            : base.currency,
+        language: text(draft.language),
+        images: draft.images_draft ?? [],
+        location: {
+            locationId: text(draft.location_id_draft),
+            locationLabel: text(draft.location_label_draft),
+            lat: draft.lat_draft ?? null,
+            lon: draft.lon_draft ?? null,
+            geohash: text(draft.geohash_draft),
+        },
+        features: fromFeaturesDto((draft.features_draft ?? {})),
+        countable: draft.countable ?? false,
+        stockQuantity: draft.stock_quantity ?? null,
+        autoRepublish: draft.auto_republish ?? false,
+    };
+}
+/**
+ * Editing something already PUBLISHED: the published half → the composer.
+ *
+ * A live listing's `*_draft` fields hold whatever was last submitted, which
+ * after a publish is the same content — but a listing published before this
+ * pair existed, or one whose draft was cleared, would open empty. Seeding
+ * from the PUBLISHED fields is what makes "edit" show the listing a person
+ * can actually see. Feature values come back from the DAO projection, which
+ * is the one place the published values live.
+ */
+export function draftValuesFromDetail(detail, featuresDto, options = {}) {
+    const base = emptyDraftValues(options);
+    return {
+        categoryId: detail.category_id,
+        title: text(detail.title),
+        description: text(detail.description),
+        price: text(detail.price),
+        currency: detail.currency !== undefined && detail.currency.length > 0
+            ? detail.currency
+            : base.currency,
+        language: text(detail.language),
+        images: detail.images ?? [],
+        location: {
+            locationId: text(detail.location_id),
+            locationLabel: text(detail.location_label),
+            lat: detail.lat ?? null,
+            lon: detail.lon ?? null,
+            geohash: text(detail.geohash),
+        },
+        features: fromFeaturesDto(featuresDto),
+        countable: detail.countable ?? false,
+        stockQuantity: detail.stock_quantity ?? null,
+        autoRepublish: detail.auto_republish ?? false,
+    };
+}
+/**
+ * The ONE boundary between the two descriptions of a feature value.
+ *
+ * `toFeaturesDto` speaks the engine's own structural shape (`{type: string,
+ * value: unknown}` plus whatever a type adds) — it has to, because the type
+ * vocabulary is an OPEN registry server-side (`EXTRA_TYPES`, runtime
+ * `register_feature_type`), so a deployment can legitimately submit a type
+ * this generated union has never heard of. The generated union describes the
+ * ten BUILTIN types precisely, which is exactly right for reading and one
+ * notch too narrow for writing.
+ *
+ * Rather than widen the wire type or narrow the engine's, the conversion is
+ * named here, once, with the reason attached. A cast scattered at call sites
+ * would be the same code with nowhere to write this down.
+ */
+function toWireFeatures(features, values) {
+    return toFeaturesDto(features, values);
+}
+/**
+ * The composer's values → the `save-draft` body.
+ *
+ * `features` needs the category schema to be tagged, so it is passed in. A
+ * feature the schema no longer declares is dropped by `toFeaturesDto` only if
+ * it is absent from `features`; keeping a stale slug in the payload would be
+ * refused per-feature by 0.6.0's M-7 rule
+ * (`error.400.listing_feature_not_allowed`), which is why
+ * {@link retainKnownFeatureValues} prunes on the way in rather than letting
+ * the server explain it.
+ */
+export function draftPatchFromValues(values, features) {
+    return {
+        category_id: values.categoryId,
+        title_draft: values.title,
+        description_draft: values.description,
+        price_draft: values.price.length > 0 ? values.price : null,
+        currency: values.currency,
+        ...(values.language.length > 0 ? { language: values.language } : {}),
+        images_draft: [...values.images],
+        location_id_draft: values.location.locationId,
+        location_label_draft: values.location.locationLabel,
+        geohash_draft: values.location.geohash,
+        lat_draft: values.location.lat,
+        lon_draft: values.location.lon,
+        features_draft: toWireFeatures(features, values.features),
+        countable: values.countable,
+        // The pair mirrors the model's cross-field rule rather than sending a
+        // contradiction: a service carries no quantity, and `validate_countable
+        // _stock` refuses a `stock_quantity` beside `countable: false`.
+        stock_quantity: values.countable ? values.stockQuantity : null,
+        auto_republish: values.autoRepublish,
+    };
+}
+/**
+ * The body for CREATING a draft: `category_id` and nothing else.
+ *
+ * `perform_create` forces `owner` and `status`, and everything else has a
+ * model default, so a create that also carried the form's current contents
+ * would be a second write of data the very next `save-draft` sends anyway —
+ * and would fail the whole submission on a field the person could still fix.
+ * Create the row, then save into it.
+ */
+export function createDraftBody(categoryId) {
+    return { category_id: categoryId };
+}
+/**
+ * Switching category: keep the answers whose slug the new schema also
+ * declares, drop the rest.
+ *
+ * Spec §4.1 asks for exactly this, and the reason is the same one the forms
+ * spec gives for `error.409.forms_version_superseded`: a person who picked
+ * "Phones", filled in Brand and Condition, then realised they meant "Used
+ * phones" should not retype what both categories ask for. A value whose slug
+ * is gone IS dropped, because 0.6.0 rejects an unknown slug per feature —
+ * carrying it would turn a category change into a publish refusal about a
+ * field the composer no longer draws.
+ */
+export function retainKnownFeatureValues(values, features) {
+    const known = new Set(features.map((feature) => feature.slug));
+    const out = {};
+    for (const [slug, value] of Object.entries(values)) {
+        if (known.has(slug))
+            out[slug] = value;
+    }
+    return out;
+}
+/** Slugs that were answered and are NOT in the new schema — what
+ * {@link retainKnownFeatureValues} just dropped. A composer tells the person
+ * ("2 answers do not apply to this category") instead of losing them
+ * silently. */
+export function droppedFeatureSlugs(values, features) {
+    const known = new Set(features.map((feature) => feature.slug));
+    return Object.keys(values)
+        .filter((slug) => !known.has(slug))
+        .sort();
+}
+//# sourceMappingURL=draft.js.map

package/dist/model/draft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft.js","sourceRoot":"","sources":["../../src/model/draft.ts"],"names":[],"mappings":"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"}

package/dist/model/features.d.ts

@@ -0,0 +1,69 @@
+/**
+ * The stored DAO projection → something `@stapel/attributes-react` can draw.
+ *
+ * A listing carries its attribute values THREE times, all of them DAO lists:
+ * `features` (everything, ordered), `features_title` (the ones flagged for
+ * the title line) and `features_badges` (the ones flagged for the card). A
+ * DAO is the value together with the display configuration its type needs —
+ * `prefix`, `precision`, `trueLabel`, `unitType`, … all inline beside
+ * `value` — which is the single most useful property of this contract:
+ *
+ *   **a card can render its badges without ever fetching the category.**
+ *
+ * `formatFeatureValue` wants a `(FeatureDef, FeatureValueDto)` pair, so this
+ * module splits a DAO back into one. The split is mechanical, and it is
+ * written down once here rather than at each of the three call sites.
+ *
+ * ── Where the config comes from, and why the whole row is handed over ──────
+ *
+ * `FeatureConfig` has an index signature, so passing the DAO itself as the
+ * config costs nothing and loses nothing: the type-specific keys are already
+ * at the top level of the row, and the four presentation flags (`name`,
+ * `order`, `title`, `badge`) are simply ignored by every formatter. Copying a
+ * hand-picked subset instead would be a list to keep in step with ten types.
+ *
+ * ── What a DAO does NOT carry ──────────────────────────────────────────────
+ *
+ * `select`'s `options`. `normalize_to_dao` stores the chosen VALUES, not the
+ * option table, so `formatFeatureValue` falls back to the raw option value —
+ * which is a translation KEY when the config is translatable (the default),
+ * so a host whose bundle carries the catalogue's option copy still reads a
+ * word. A host whose bundle does not sees the key, on purpose: a visible
+ * `option.condition.used` gets fixed, an invented "Used" ships wrong.
+ */
+import type { FeatureValueDto } from "@stapel/attributes-react";
+import type { ListingFeatureDao, ListingFeatureView } from "../api/types.js";
+/**
+ * One DAO row → the definition/value pair the display half consumes.
+ *
+ * `undefined` for a row with no `slug`: the stored projection always injects
+ * one (`build_features_list`: `{**dao, "slug": slug}`), so a row without it
+ * is a malformed record, and a synthesized index would key a badge to a
+ * position that changes whenever the category does.
+ */
+export declare function featureFromDao(dao: ListingFeatureDao): ListingFeatureView | undefined;
+/** A stored projection → the pairs a display component iterates. Malformed
+ * rows are dropped HERE, in one place, and counted by {@link
+ * unreadableFeatureCount} so a skin can say how many rather than pretend the
+ * listing had fewer attributes. */
+export declare function featuresFromDaoList(daos: readonly ListingFeatureDao[] | null | undefined): readonly ListingFeatureView[];
+/** How many rows of a stored projection this build could not key. */
+export declare function unreadableFeatureCount(daos: readonly ListingFeatureDao[] | null | undefined): number;
+/**
+ * A stored projection → the `{slug: {type, value}}` envelope, which is what
+ * a composer reopening a PUBLISHED listing needs: `draftValuesFromDetail`
+ * seeds its editors from the published values, and the published values live
+ * only in the DAO list.
+ */
+export declare function featuresDtoFromDaoList(daos: readonly ListingFeatureDao[] | null | undefined): Readonly<Record<string, FeatureValueDto>>;
+/**
+ * The `features` field of a detail response, typed.
+ *
+ * The generated `FeatureDao` union is unusable (the discriminator defect —
+ * see `api/types.ts`), and `features` is a `JSONField` on the serializer, so
+ * this cast is the boundary between "the schema's description" and "the row
+ * the JSONField actually emitted". It lives in ONE function so there is one
+ * place to change when upstream fixes the mapping.
+ */
+export declare function asFeatureDaoList(value: unknown): readonly ListingFeatureDao[];
+//# sourceMappingURL=features.d.ts.map

package/dist/model/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../src/model/features.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,KAAK,EAAc,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAK7E;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,iBAAiB,GACrB,kBAAkB,GAAG,SAAS,CAqBhC;AAED;;;mCAGmC;AACnC,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,iBAAiB,EAAE,GAAG,IAAI,GAAG,SAAS,GACpD,SAAS,kBAAkB,EAAE,CAO/B;AAED,qEAAqE;AACrE,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,SAAS,iBAAiB,EAAE,GAAG,IAAI,GAAG,SAAS,GACpD,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,SAAS,iBAAiB,EAAE,GAAG,IAAI,GAAG,SAAS,GACpD,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAM3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,iBAAiB,EAAE,CAE7E"}

package/dist/model/features.js

@@ -0,0 +1,73 @@
+/** Keys that belong to the DAO envelope rather than to the type's config. */
+const ENVELOPE = new Set(["slug", "value", "name", "order", "title", "badge"]);
+/**
+ * One DAO row → the definition/value pair the display half consumes.
+ *
+ * `undefined` for a row with no `slug`: the stored projection always injects
+ * one (`build_features_list`: `{**dao, "slug": slug}`), so a row without it
+ * is a malformed record, and a synthesized index would key a badge to a
+ * position that changes whenever the category does.
+ */
+export function featureFromDao(dao) {
+    if (typeof dao.slug !== "string" || dao.slug.length === 0)
+        return undefined;
+    const config = {};
+    for (const [key, value] of Object.entries(dao)) {
+        if (!ENVELOPE.has(key))
+            config[key] = value;
+    }
+    const feature = {
+        slug: dao.slug,
+        config,
+        name: dao.name ?? null,
+        ...(dao.translate !== undefined ? { translate: dao.translate } : {}),
+    };
+    const value = typeof dao.type === "string" && dao.type.length > 0
+        ? { type: dao.type, value: dao.value }
+        : undefined;
+    return { feature, value };
+}
+/** A stored projection → the pairs a display component iterates. Malformed
+ * rows are dropped HERE, in one place, and counted by {@link
+ * unreadableFeatureCount} so a skin can say how many rather than pretend the
+ * listing had fewer attributes. */
+export function featuresFromDaoList(daos) {
+    const out = [];
+    for (const dao of daos ?? []) {
+        const view = featureFromDao(dao);
+        if (view !== undefined)
+            out.push(view);
+    }
+    return out;
+}
+/** How many rows of a stored projection this build could not key. */
+export function unreadableFeatureCount(daos) {
+    return (daos ?? []).length - featuresFromDaoList(daos).length;
+}
+/**
+ * A stored projection → the `{slug: {type, value}}` envelope, which is what
+ * a composer reopening a PUBLISHED listing needs: `draftValuesFromDetail`
+ * seeds its editors from the published values, and the published values live
+ * only in the DAO list.
+ */
+export function featuresDtoFromDaoList(daos) {
+    const out = {};
+    for (const view of featuresFromDaoList(daos)) {
+        if (view.value !== undefined)
+            out[view.feature.slug] = view.value;
+    }
+    return out;
+}
+/**
+ * The `features` field of a detail response, typed.
+ *
+ * The generated `FeatureDao` union is unusable (the discriminator defect —
+ * see `api/types.ts`), and `features` is a `JSONField` on the serializer, so
+ * this cast is the boundary between "the schema's description" and "the row
+ * the JSONField actually emitted". It lives in ONE function so there is one
+ * place to change when upstream fixes the mapping.
+ */
+export function asFeatureDaoList(value) {
+    return Array.isArray(value) ? value : [];
+}
+//# sourceMappingURL=features.js.map

package/dist/model/features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.js","sourceRoot":"","sources":["../../src/model/features.ts"],"names":[],"mappings":"AAoCA,6EAA6E;AAC7E,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAE/E;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAsB;IAEtB,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE5E,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC9C,CAAC;IAED,MAAM,OAAO,GAAe;QAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,MAAM;QACN,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,IAAI;QACtB,GAAG,CAAC,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrE,CAAC;IAEF,MAAM,KAAK,GACT,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QACjD,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE;QACtC,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED;;;mCAGmC;AACnC,MAAM,UAAU,mBAAmB,CACjC,IAAqD;IAErD,MAAM,GAAG,GAAyB,EAAE,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,IAAI,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,sBAAsB,CACpC,IAAqD;IAErD,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAqD;IAErD,MAAM,GAAG,GAAoC,EAAE,CAAC;IAChD,KAAK,MAAM,IAAI,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IACpE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAsC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC"}

package/dist/model/mineSource.d.ts

@@ -0,0 +1,47 @@
+/**
+ * THE GAP: stapel-listings cannot list a person their own listings.
+ *
+ * This is the one place in the pair where a contract is missing rather than
+ * awkward, so it gets its own module and its own name.
+ *
+ * `GET /listings/` answers `qs.published()` and takes no owner parameter
+ * (`views.ListingViewSet.get_queryset`): it returns the whole marketplace's
+ * shop window and can be narrowed to nobody. The only owner-scoped reads in
+ * the module are `my/counters` (three integers) and `my/favorites`. So a
+ * seller's own DRAFTS are unreachable by any call this contract offers — and
+ * drafts are not indexed either, so routing around it through
+ * `@stapel/search-react`'s `owner=` would return the published subset and
+ * quietly call it "everything".
+ *
+ * The storefront spec assumed `GET /listings/` was "for mine" (§4.1). It is
+ * not, and this pair records the gap rather than papering over it.
+ *
+ * Two upstream asks, in preference order:
+ *  1. an `?owner=me` filter (or a `my/listings` action) on the list endpoint,
+ *     with the same `IDAnchorPagination` envelope the other two use;
+ *  2. failing that, a `status` filter on it, so at least the published subset
+ *     can be narrowed without a search module.
+ *
+ * Until then a host injects a {@link MyListingsSource} and the dashboard
+ * works completely; without one it shows the real counters and NAMES the
+ * absence, because "we cannot ask" and "you have no listings" are different
+ * sentences.
+ */
+import { StapelApiError } from "@stapel/core";
+import type { ListingPageParams, PaginatedListingCards } from "../api/types.js";
+import type { MyListingsTab } from "./status.js";
+/** One page of the caller's own listings, however the host can get them. */
+export type MyListingsSource = (args: {
+    readonly tab: MyListingsTab;
+    readonly page: ListingPageParams;
+    readonly signal?: AbortSignal;
+}) => Promise<PaginatedListingCards>;
+/**
+ * The error a dashboard without a source reports.
+ *
+ * `status: 0` on purpose: this is a fact about the deployment's wiring, not
+ * something a server said, and a client-side refusal must never be
+ * indistinguishable from one that came over the wire.
+ */
+export declare const MY_LISTINGS_SOURCE_MISSING: StapelApiError;
+//# sourceMappingURL=mineSource.d.ts.map

package/dist/model/mineSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mineSource.d.ts","sourceRoot":"","sources":["../../src/model/mineSource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,4EAA4E;AAC5E,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE;IACpC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAErC;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,EAAE,cAMvC,CAAC"}

package/dist/model/mineSource.js

@@ -0,0 +1,45 @@
+/**
+ * THE GAP: stapel-listings cannot list a person their own listings.
+ *
+ * This is the one place in the pair where a contract is missing rather than
+ * awkward, so it gets its own module and its own name.
+ *
+ * `GET /listings/` answers `qs.published()` and takes no owner parameter
+ * (`views.ListingViewSet.get_queryset`): it returns the whole marketplace's
+ * shop window and can be narrowed to nobody. The only owner-scoped reads in
+ * the module are `my/counters` (three integers) and `my/favorites`. So a
+ * seller's own DRAFTS are unreachable by any call this contract offers — and
+ * drafts are not indexed either, so routing around it through
+ * `@stapel/search-react`'s `owner=` would return the published subset and
+ * quietly call it "everything".
+ *
+ * The storefront spec assumed `GET /listings/` was "for mine" (§4.1). It is
+ * not, and this pair records the gap rather than papering over it.
+ *
+ * Two upstream asks, in preference order:
+ *  1. an `?owner=me` filter (or a `my/listings` action) on the list endpoint,
+ *     with the same `IDAnchorPagination` envelope the other two use;
+ *  2. failing that, a `status` filter on it, so at least the published subset
+ *     can be narrowed without a search module.
+ *
+ * Until then a host injects a {@link MyListingsSource} and the dashboard
+ * works completely; without one it shows the real counters and NAMES the
+ * absence, because "we cannot ask" and "you have no listings" are different
+ * sentences.
+ */
+import { StapelApiError } from "@stapel/core";
+import { LISTINGS_I18N_KEYS } from "../i18n/keys.js";
+/**
+ * The error a dashboard without a source reports.
+ *
+ * `status: 0` on purpose: this is a fact about the deployment's wiring, not
+ * something a server said, and a client-side refusal must never be
+ * indistinguishable from one that came over the wire.
+ */
+export const MY_LISTINGS_SOURCE_MISSING = new StapelApiError({
+    code: LISTINGS_I18N_KEYS.mineSourceMissing,
+    message: "No MyListingsSource was supplied, and stapel-listings has no " +
+        "owner-scoped list endpoint to fall back on.",
+    status: 0,
+});
+//# sourceMappingURL=mineSource.js.map

package/dist/model/mineSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mineSource.js","sourceRoot":"","sources":["../../src/model/mineSource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AASrD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAmB,IAAI,cAAc,CAAC;IAC3E,IAAI,EAAE,kBAAkB,CAAC,iBAAiB;IAC1C,OAAO,EACL,+DAA+D;QAC/D,6CAA6C;IAC/C,MAAM,EAAE,CAAC;CACV,CAAC,CAAC"}

package/dist/model/mutations.d.ts

@@ -0,0 +1,60 @@
+import type { UseMutationResult } from "@tanstack/react-query";
+import type { StapelApiError } from "@stapel/core";
+import type { DeleteResponse, FavoriteToggleResponse, ListingActionResponse, ListingDraft, ListingDraftPatch, PublishResponse } from "../api/types.js";
+/** Start a draft. The server forces `owner` and `status=draft`. */
+export declare function useCreateDraft(): UseMutationResult<ListingDraft, StapelApiError, ListingDraftPatch>;
+/** What a `save-draft` write carries. */
+export interface SaveDraftInput {
+    readonly id: number;
+    readonly body: ListingDraftPatch;
+}
+/**
+ * Persist draft fields. Always partial — send what the form holds.
+ *
+ * The validate-draft entry is invalidated rather than written: the saved row
+ * comes back, but it carries no verdict, and a stale verdict beside fresh
+ * content is the one combination a composer must never show.
+ */
+export declare function useSaveDraft(): UseMutationResult<ListingDraft, StapelApiError, SaveDraftInput>;
+/**
+ * Promote the draft.
+ *
+ * `retry: false` — the 400 here is a VERDICT about the content (a bare
+ * `ValidationBatchResult` body, see `model/validation.ts`), and repeating a
+ * verdict three times only delays the moment the composer can lay it on the
+ * controls.
+ */
+export declare function usePublishListing(): UseMutationResult<PublishResponse, StapelApiError, number>;
+/** Move to ARCHIVED. 409 `error.409.invalid_listing_transition` carries
+ * `params.from_status`, which is what turns the refusal into a sentence. */
+export declare function useArchiveListing(): UseMutationResult<ListingActionResponse, StapelApiError, number>;
+/** Mark SOLD. Same 409 contract as {@link useArchiveListing}. */
+export declare function useCompleteListing(): UseMutationResult<ListingActionResponse, StapelApiError, number>;
+/** Soft-delete. Refused with `error.409.listing_cannot_delete_active` while
+ * the listing is PUBLISHED or PENDING. */
+export declare function useDeleteListing(): UseMutationResult<DeleteResponse, StapelApiError, number>;
+/** What a favourite toggle carries: the id and the state it should END in. */
+export interface FavoriteInput {
+    readonly id: number;
+    readonly favorited: boolean;
+}
+/**
+ * Favourite / un-favourite, as ONE mutation over the intended next state.
+ *
+ * Two endpoints, one intent — and modelling it as two hooks would let a
+ * caller call the wrong one for the state it is in. The server is idempotent
+ * on both sides (`get_or_create` / `filter().delete()`), so a double-click
+ * cannot desynchronise anything.
+ *
+ * This is the pair's ONE write whose next state the client may predict, and
+ * the reason is that the truth is a single boolean the caller already holds.
+ * Everything else here moves a LIFECYCLE whose next state is the server's to
+ * decide — guessing `pending` versus `published` after a publish would be
+ * inventing the very verdict the pair exists to report faithfully.
+ *
+ * The invalidation reaches the favourites LIST as well as the row: a heart
+ * turned off on the favourites page must remove the card, not leave a hollow
+ * one behind.
+ */
+export declare function useFavoriteListing(): UseMutationResult<FavoriteToggleResponse, StapelApiError, FavoriteInput>;
+//# sourceMappingURL=mutations.d.ts.map

package/dist/model/mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../src/model/mutations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAwCzB,mEAAmE;AACnE,wBAAgB,cAAc,IAAI,iBAAiB,CACjD,YAAY,EACZ,cAAc,EACd,iBAAiB,CAClB,CAYA;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;CAClC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,IAAI,iBAAiB,CAC/C,YAAY,EACZ,cAAc,EACd,cAAc,CACf,CAUA;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,CACpD,eAAe,EACf,cAAc,EACd,MAAM,CACP,CAUA;AAED;4EAC4E;AAC5E,wBAAgB,iBAAiB,IAAI,iBAAiB,CACpD,qBAAqB,EACrB,cAAc,EACd,MAAM,CACP,CAUA;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,IAAI,iBAAiB,CACrD,qBAAqB,EACrB,cAAc,EACd,MAAM,CACP,CAUA;AAED;0CAC0C;AAC1C,wBAAgB,gBAAgB,IAAI,iBAAiB,CACnD,cAAc,EACd,cAAc,EACd,MAAM,CACP,CAWA;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,CACrD,sBAAsB,EACtB,cAAc,EACd,aAAa,CACd,CAmBA"}