@jsm-mit/sultana-core-motoko-package 0.3.0 → 0.4.0

package/declarations/sultana-core-motoko/sultana-core-motoko.did

@@ -75,6 +75,16 @@ type UpdateSalonServiceArgs =
    serviceTypeIds: vec ServiceTypeId;
    workerIds: vec principal;
  };
+type UpdatePromoArgs = 
+ record {
+   assetId: AssetId;
+   chips: vec text;
+   cta: PromoCta;
+   promoId: PromoId;
+   salonId: SalonId;
+   target: PromoTarget;
+   textLines: vec text;
+ };
 type UpdateProfileArgs = 
  record {
    avatarUrl: opt text;
@@ -127,6 +137,12 @@ type SetReportThresholdArgs =
    opType: OperationType;
    thresholdMs: nat;
  };
+type SetPromoActiveArgs = 
+ record {
+   active: bool;
+   promoId: PromoId;
+   salonId: SalonId;
+ };
 type SetLanguageActiveArgs = 
  record {
    active: bool;
@@ -497,6 +513,7 @@ type PromoTarget =
  };
 type PromoItem = 
  record {
+   active: bool;
    assetId: AssetId;
    chips: vec text;
    createdAt: int;
@@ -856,8 +873,9 @@ service : {
   addDiscountCode: (args: AddDiscountCodeArgs) -> (Result_1);
   /// Superadmin: adds a supported language (active by default; languages are never deleted)
   addLanguage: (code: LangCode) -> (Result_1);
-  /// Owner attaches a promo (max 3 per salon): #Ready media from the salon's library,
-  /// target = the salon or one of its services, CTA = button label / show-delay / discount code
+  /// Owner adds a promo to the salon's library (max 15): #Ready media from the salon's
+  /// library, target = the salon or one of its services, CTA = button label / discount code.
+  /// The promo is created INACTIVE — setPromoActive is what puts it in the feed
   addPromo: (args: AddPromoArgs) -> (Result_37);
   /// Adds a new service to a specific salon
   addSalonService: (args: AddSalonServiceArgs) -> (Result_36);
@@ -942,7 +960,7 @@ service : {
   /// The salon's outstanding invite, or null when there is none or it has expired (Owner only)
   getSalonInvite: (salonId: SalonId) -> (Result_20) query;
   getSalonInviteTtl: () -> (Result_3) query;
-  /// Public: the salon's current promos
+  /// The salon's promos: the whole library for its owner, the active ones for everyone else
   getSalonPromos: (salonId: SalonId) -> (Result_19) query;
   /// Returns the list of salon services by salon ID (owner view)
   getSalonServicesBySalonId: (salonId: SalonId) -> (Result_6) query;
@@ -983,7 +1001,7 @@ service : {
   removeDailySchedule: (args: RemoveDailyScheduleArgs) -> (Result_1);
   /// Owner removes a code (blocked while a promo of the salon still broadcasts it)
   removeDiscountCode: (args: RemoveDiscountCodeArgs) -> (Result_1);
-  /// Owner removes a promo (this is also the "deactivate"); the library asset stays
+  /// Owner deletes a promo for good (to only hide it, use setPromoActive); the asset stays
   removePromo: (args: RemovePromoArgs) -> (Result_1);
   /// Permanently removes a salon service and cleans up search indexes
   removeSalonServiceBySalonServiceId: (salonServiceId: SalonServiceId) ->
@@ -1015,6 +1033,9 @@ service : {
   /// Superadmin only, ONE-WAY: flips isProd to true — the test-only endpoints
   /// (purgeFailedAssetsNow, triggerAssetsSweep) trap from then on. There is no way back.
   setProdMode: () -> (Result_1);
+  /// Owner puts a promo in the feed or takes it out (max 3 active per salon); the promo
+  /// itself stays in the library either way
+  setPromoActive: (args: SetPromoActiveArgs) -> (Result_1);
   setReportBatchSize: (size: nat) -> (Result_3);
   setReportThreshold: (args: SetReportThresholdArgs) -> (Result_3);
   setSalonInviteTtl: (newTtlSeconds: nat) -> (Result_3);
@@ -1031,6 +1052,8 @@ service : {
   /// sweep now, with a TTL override — same code path its hourly timer drives
   triggerAssetsSweep: (ttlSeconds: nat) -> (Result_3);
   updateMyProfile: (args: UpdateProfileArgs) -> (Result_2);
+  /// Owner edits a promo in place; it keeps its id, its createdAt and its place in the feed
+  updatePromo: (args: UpdatePromoArgs) -> (Result_1);
   /// Updates an existing service with new details and synchronizes the index
   updateSalonService: (args: UpdateSalonServiceArgs) -> (Result_1);
   updateVisit: (args: UpdateVisitArgs) -> (Result);

package/declarations/sultana-core-motoko/sultana-core-motoko.did.d.ts

@@ -265,6 +265,7 @@ export interface PromoItem {
   'cta' : PromoCta,
   'textLines' : Array<string>,
   'thumbId' : AssetId,
+  'active' : boolean,
   'assetId' : AssetId,
   'chips' : Array<string>,
   'kind' : AssetKind,
@@ -479,6 +480,11 @@ export interface SetDailyScheduleArgs {
   'mask' : TimeMask,
 }
 export interface SetLanguageActiveArgs { 'active' : boolean, 'code' : LangCode }
+export interface SetPromoActiveArgs {
+  'active' : boolean,
+  'salonId' : SalonId,
+  'promoId' : PromoId,
+}
 export interface SetReportThresholdArgs {
   'opType' : OperationType,
   'thresholdMs' : bigint,
@@ -516,6 +522,15 @@ export interface UpdateProfileArgs {
   'name' : string,
   'avatarUrl' : [] | [string],
 }
+export interface UpdatePromoArgs {
+  'cta' : PromoCta,
+  'textLines' : Array<string>,
+  'assetId' : AssetId,
+  'chips' : Array<string>,
+  'target' : PromoTarget,
+  'salonId' : SalonId,
+  'promoId' : PromoId,
+}
 export interface UpdateSalonServiceArgs {
   'duration' : bigint,
   'active' : boolean,
@@ -596,8 +611,9 @@ export interface _SERVICE {
    */
   'addLanguage' : ActorMethod<[LangCode], Result_1>,
   /**
-   * / Owner attaches a promo (max 3 per salon): #Ready media from the salon's library,
-   * / target = the salon or one of its services, CTA = button label / show-delay / discount code
+   * / Owner adds a promo to the salon's library (max 15): #Ready media from the salon's
+   * / library, target = the salon or one of its services, CTA = button label / discount code.
+   * / The promo is created INACTIVE — setPromoActive is what puts it in the feed
    */
   'addPromo' : ActorMethod<[AddPromoArgs], Result_37>,
   /**
@@ -759,7 +775,7 @@ export interface _SERVICE {
   'getSalonInvite' : ActorMethod<[SalonId], Result_20>,
   'getSalonInviteTtl' : ActorMethod<[], Result_3>,
   /**
-   * / Public: the salon's current promos
+   * / The salon's promos: the whole library for its owner, the active ones for everyone else
    */
   'getSalonPromos' : ActorMethod<[SalonId], Result_19>,
   /**
@@ -828,7 +844,7 @@ export interface _SERVICE {
    */
   'removeDiscountCode' : ActorMethod<[RemoveDiscountCodeArgs], Result_1>,
   /**
-   * / Owner removes a promo (this is also the "deactivate"); the library asset stays
+   * / Owner deletes a promo for good (to only hide it, use setPromoActive); the asset stays
    */
   'removePromo' : ActorMethod<[RemovePromoArgs], Result_1>,
   /**
@@ -888,6 +904,11 @@ export interface _SERVICE {
    * / (purgeFailedAssetsNow, triggerAssetsSweep) trap from then on. There is no way back.
    */
   'setProdMode' : ActorMethod<[], Result_1>,
+  /**
+   * / Owner puts a promo in the feed or takes it out (max 3 active per salon); the promo
+   * / itself stays in the library either way
+   */
+  'setPromoActive' : ActorMethod<[SetPromoActiveArgs], Result_1>,
   'setReportBatchSize' : ActorMethod<[bigint], Result_3>,
   'setReportThreshold' : ActorMethod<[SetReportThresholdArgs], Result_3>,
   'setSalonInviteTtl' : ActorMethod<[bigint], Result_3>,
@@ -910,6 +931,10 @@ export interface _SERVICE {
    */
   'triggerAssetsSweep' : ActorMethod<[bigint], Result_3>,
   'updateMyProfile' : ActorMethod<[UpdateProfileArgs], Result_2>,
+  /**
+   * / Owner edits a promo in place; it keeps its id, its createdAt and its place in the feed
+   */
+  'updatePromo' : ActorMethod<[UpdatePromoArgs], Result_1>,
   /**
    * / Updates an existing service with new details and synchronizes the index
    */

package/declarations/sultana-core-motoko/sultana-core-motoko.did.js

@@ -397,6 +397,7 @@ export const idlFactory = ({ IDL }) => {
     'cta' : PromoCta,
     'textLines' : IDL.Vec(IDL.Text),
     'thumbId' : AssetId,
+    'active' : IDL.Bool,
     'assetId' : AssetId,
     'chips' : IDL.Vec(IDL.Text),
     'kind' : AssetKind,
@@ -591,6 +592,11 @@ export const idlFactory = ({ IDL }) => {
     'active' : IDL.Bool,
     'code' : LangCode,
   });
+  const SetPromoActiveArgs = IDL.Record({
+    'active' : IDL.Bool,
+    'salonId' : SalonId,
+    'promoId' : PromoId,
+  });
   const SetReportThresholdArgs = IDL.Record({
     'opType' : OperationType,
     'thresholdMs' : IDL.Nat,
@@ -606,6 +612,15 @@ export const idlFactory = ({ IDL }) => {
     'name' : IDL.Text,
     'avatarUrl' : IDL.Opt(IDL.Text),
   });
+  const UpdatePromoArgs = IDL.Record({
+    'cta' : PromoCta,
+    'textLines' : IDL.Vec(IDL.Text),
+    'assetId' : AssetId,
+    'chips' : IDL.Vec(IDL.Text),
+    'target' : PromoTarget,
+    'salonId' : SalonId,
+    'promoId' : PromoId,
+  });
   const UpdateSalonServiceArgs = IDL.Record({
     'duration' : IDL.Nat,
     'active' : IDL.Bool,
@@ -809,6 +824,7 @@ export const idlFactory = ({ IDL }) => {
     'setLanguageActive' : IDL.Func([SetLanguageActiveArgs], [Result_1], []),
     'setLoggingEnabled' : IDL.Func([IDL.Bool], [Result_1], []),
     'setProdMode' : IDL.Func([], [Result_1], []),
+    'setPromoActive' : IDL.Func([SetPromoActiveArgs], [Result_1], []),
     'setReportBatchSize' : IDL.Func([IDL.Nat], [Result_3], []),
     'setReportThreshold' : IDL.Func([SetReportThresholdArgs], [Result_3], []),
     'setSalonInviteTtl' : IDL.Func([IDL.Nat], [Result_3], []),
@@ -820,6 +836,7 @@ export const idlFactory = ({ IDL }) => {
     'setWeeklyTemplate' : IDL.Func([SetWeeklyTemplateArgs], [Result_1], []),
     'triggerAssetsSweep' : IDL.Func([IDL.Nat], [Result_3], []),
     'updateMyProfile' : IDL.Func([UpdateProfileArgs], [Result_2], []),
+    'updatePromo' : IDL.Func([UpdatePromoArgs], [Result_1], []),
     'updateSalonService' : IDL.Func([UpdateSalonServiceArgs], [Result_1], []),
     'updateVisit' : IDL.Func([UpdateVisitArgs], [Result], []),
   });

package/dist/actors/promo-actor.d.ts

@@ -1,6 +1,10 @@
 import { type Identity } from "@icp-sdk/core/agent";
 import { ActorBase } from "../actor-base.js";
 import type { PromoItem } from "../../declarations/sultana-core-motoko/sultana-core-motoko.did.js";
+/** How many promos a salon may KEEP — the size of its library, drafts included (PromoRepo). */
+export declare const MAX_PROMOS_PER_SALON = 15;
+/** How many of them may be IN THE FEED at once (PromoRepo). */
+export declare const MAX_ACTIVE_PROMOS_PER_SALON = 3;
 /** Friendly promo-content input — every field optional; omitted = empty / frontend default. */
 export interface PromoContentInput {
     /** Up to 2 overlay text lines rendered over the media. */
@@ -13,46 +17,82 @@ export interface PromoContentInput {
     discountCode?: string;
 }
 /**
- * Wraps the promo endpoints on sultana-core-motoko. Promos belong to a SALON (max 3 per
- * salon) and are managed by its current owner; the media must be a #Ready asset from the
- * salon's library. getSalonPromos and getPromoFeed are public queries — the feed follows
- * the search pattern: the frontend expands its radius into geohash6 cells and adapts the
- * set to the response size, core only answers exact-key lookups.
+ * Wraps the promo endpoints on sultana-core-motoko. A salon keeps a LIBRARY of up to
+ * MAX_PROMOS_PER_SALON promos, of which at most MAX_ACTIVE_PROMOS_PER_SALON may be active —
+ * only the active ones reach the geo feed. Promos are managed by the salon's current owner
+ * and the media must be a #Ready asset from the salon's library.
+ *
+ * getSalonPromos and getPromoFeed are public queries. The feed follows the search pattern: the
+ * caller expands its radius into geohash6 cells and adapts the set to the response size, core
+ * only answers exact-key lookups.
  */
 export declare class PromoActor extends ActorBase {
     constructor(canisterId: string, identity?: Identity);
     /**
-     * Attaches a promo to the salon (owner only, max 3 per salon). The media must be a
-     * #Ready asset from the salon's library (image or video — kind and thumb/poster are
-     * taken from the library entry).
+     * Adds a promo to the salon's library (owner only, max MAX_PROMOS_PER_SALON). The media
+     * must be a #Ready asset from the salon's library (image or video — kind and thumb/poster
+     * are taken from the library entry).
+     *
+     * The promo is created INACTIVE: adding never pushes a running campaign out of the feed,
+     * so call setPromoActiveAsyncUnsafe to put it there.
      * @param salonId - The salon the promo belongs to (and, for a salon-target promo, links to).
-     * @param assetId - A #Ready asset from the salon's library; one asset can back only one promo.
+     * @param assetId - A #Ready asset from the salon's library; one asset may back several promos.
      * @param content - Overlay text lines (max 2), chips (max 2), button label and discount
      *        code (all optional — see PromoContentInput).
      * @param targetSalonServiceId - Optional: make the promo tap through to this service of the
      *        salon; omitted -> the promo targets the salon itself.
      * @returns A Promise that resolves to the new PromoId.
      * @throws Error `CanisterError` on a Framework.Result #err (not the owner, asset not in the
-     *         library or not #Ready, promo limit reached, duplicate asset, bad target, too many
-     *         lines/chips, ...).
+     *         library or not #Ready, library full, bad target, too many lines/chips, a discount
+     *         code that is not this salon's or whose scope does not fit the target, ...).
      * @throws Error `CriticalCanisterError` / `CallRefusedAtInspectionStage` as usual.
      */
     addPromoAsyncUnsafe(salonId: string, assetId: string, content?: PromoContentInput, targetSalonServiceId?: string): Promise<string>;
     /**
-     * Removes a promo from the salon (owner only). This is also the "deactivate" — there is
-     * no separate active flag; the library asset stays untouched.
+     * Edits a promo in place (owner only). The promo keeps its id, its createdAt and its place
+     * in or out of the feed, so correcting a running campaign does not restart it. Every
+     * content field is replaced by what you pass — an omitted `content` field clears it.
+     * @param salonId - The salon that owns the promo.
+     * @param promoId - The promo to edit.
+     * @param assetId - A #Ready asset from the salon's library; may differ from the current one
+     *        (kind and thumb/poster are re-read from the new entry).
+     * @param content - The new overlay text lines, chips, button label and discount code.
+     * @param targetSalonServiceId - Optional new tap-through target; omitted -> the salon itself.
+     * @throws Error `CanisterError` on a Framework.Result #err (not the owner, promo not found,
+     *         promo of a different salon, plus every validation addPromo does).
+     */
+    updatePromoAsyncUnsafe(salonId: string, promoId: string, assetId: string, content?: PromoContentInput, targetSalonServiceId?: string): Promise<boolean>;
+    /**
+     * Puts a promo in the geo feed (`active = true`) or takes it out (owner only). The promo
+     * stays in the library either way — this is the "deactivate"; removePromo is a real delete.
+     *
+     * Setting the flag to what it already is succeeds and changes nothing. Activating one promo
+     * too many FAILS rather than dropping a running one: which campaign comes down is the
+     * owner's decision, so deactivate one first.
+     * @throws Error `CanisterError` on a Framework.Result #err (not the owner, promo not found,
+     *         promo of a different salon, MAX_ACTIVE_PROMOS_PER_SALON already active).
+     */
+    setPromoActiveAsyncUnsafe(salonId: string, promoId: string, active: boolean): Promise<boolean>;
+    /**
+     * Deletes a promo from the salon's library (owner only) — content, id and all. To only take
+     * it off the feed use setPromoActiveAsyncUnsafe. The library asset stays untouched.
      * @throws Error `CanisterError` on a Framework.Result #err (not the owner, promo not
      *         found, promo of a different salon).
      */
     removePromoAsyncUnsafe(salonId: string, promoId: string): Promise<boolean>;
     /**
-     * Returns the salon's current promos — public query (promo content is public by nature).
+     * The salon's promos — a public query, but the answer depends on who asks: the salon's
+     * owner gets the whole library, everyone else gets the ACTIVE promos only. Drafts stay
+     * private because one may already carry a discount code the owner has not broadcast yet.
+     *
+     * So call this with the owner's identity to manage the library, and with any identity to
+     * read what the public sees.
      * @throws Error `CriticalCanisterError` on transport/canister failure.
      */
     getSalonPromosAsyncUnsafe(salonId: string): Promise<PromoItem[]>;
     /**
-     * Public geo feed: promos in the given geohash6 cells, deduplicated by promo id. The
-     * caller expands its radius into cells and should adapt the set to the response size
+     * Public geo feed: the ACTIVE promos in the given geohash6 cells, deduplicated by promo id.
+     * The caller expands its radius into cells and should adapt the set to the response size
      * (there is no server-side pagination; core soft-caps very large responses).
      * @param geohashes6 - The geohash6 cells covering the viewer's radius.
      * @throws Error `CriticalCanisterError` on transport/canister failure.

package/dist/actors/promo-actor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"promo-actor.d.ts","sourceRoot":"","sources":["../../src/actors/promo-actor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAY,SAAS,EAAe,MAAM,mEAAmE,CAAC;AAE1H,+FAA+F;AAC/F,MAAM,WAAW,iBAAiB;IAC9B,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6FAA6F;IAC7F,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAaD;;;;;;GAMG;AACH,qBAAa,UAAW,SAAQ,SAAS;gBAEzB,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ;IAInD;;;;;;;;;;;;;;;OAeG;IACU,mBAAmB,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,EAC/B,oBAAoB,CAAC,EAAE,MAAM,GAC9B,OAAO,CAAC,MAAM,CAAC;IAalB;;;;;OAKG;IACU,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMvF;;;OAGG;IACU,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAM7E;;;;;;OAMG;IACU,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAKnF"}
+{"version":3,"file":"promo-actor.d.ts","sourceRoot":"","sources":["../../src/actors/promo-actor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAY,SAAS,EAAe,MAAM,mEAAmE,CAAC;AAE1H,+FAA+F;AAC/F,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,+DAA+D;AAC/D,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,+FAA+F;AAC/F,MAAM,WAAW,iBAAiB;IAC9B,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6FAA6F;IAC7F,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAaD;;;;;;;;;GASG;AACH,qBAAa,UAAW,SAAQ,SAAS;gBAEzB,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ;IAInD;;;;;;;;;;;;;;;;;;OAkBG;IACU,mBAAmB,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,EAC/B,oBAAoB,CAAC,EAAE,MAAM,GAC9B,OAAO,CAAC,MAAM,CAAC;IAalB;;;;;;;;;;;;OAYG;IACU,sBAAsB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,EAC/B,oBAAoB,CAAC,EAAE,MAAM,GAC9B,OAAO,CAAC,OAAO,CAAC;IAcnB;;;;;;;;;OASG;IACU,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAM3G;;;;;OAKG;IACU,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMvF;;;;;;;;OAQG;IACU,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAM7E;;;;;;OAMG;IACU,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAKnF"}

package/dist/actors/promo-actor.js

@@ -1,5 +1,9 @@
 import {} from "@icp-sdk/core/agent";
 import { ActorBase } from "../actor-base.js";
+/** How many promos a salon may KEEP — the size of its library, drafts included (PromoRepo). */
+export const MAX_PROMOS_PER_SALON = 15;
+/** How many of them may be IN THE FEED at once (PromoRepo). */
+export const MAX_ACTIVE_PROMOS_PER_SALON = 3;
 function toCandidCta(content) {
     return {
         buttonLabel: content.buttonLabel === undefined ? [] : [content.buttonLabel],
@@ -10,30 +14,36 @@ function toCandidTarget(targetSalonServiceId) {
     return targetSalonServiceId ? { SalonService: targetSalonServiceId } : { Salon: null };
 }
 /**
- * Wraps the promo endpoints on sultana-core-motoko. Promos belong to a SALON (max 3 per
- * salon) and are managed by its current owner; the media must be a #Ready asset from the
- * salon's library. getSalonPromos and getPromoFeed are public queries — the feed follows
- * the search pattern: the frontend expands its radius into geohash6 cells and adapts the
- * set to the response size, core only answers exact-key lookups.
+ * Wraps the promo endpoints on sultana-core-motoko. A salon keeps a LIBRARY of up to
+ * MAX_PROMOS_PER_SALON promos, of which at most MAX_ACTIVE_PROMOS_PER_SALON may be active —
+ * only the active ones reach the geo feed. Promos are managed by the salon's current owner
+ * and the media must be a #Ready asset from the salon's library.
+ *
+ * getSalonPromos and getPromoFeed are public queries. The feed follows the search pattern: the
+ * caller expands its radius into geohash6 cells and adapts the set to the response size, core
+ * only answers exact-key lookups.
  */
 export class PromoActor extends ActorBase {
     constructor(canisterId, identity) {
         super(canisterId, identity);
     }
     /**
-     * Attaches a promo to the salon (owner only, max 3 per salon). The media must be a
-     * #Ready asset from the salon's library (image or video — kind and thumb/poster are
-     * taken from the library entry).
+     * Adds a promo to the salon's library (owner only, max MAX_PROMOS_PER_SALON). The media
+     * must be a #Ready asset from the salon's library (image or video — kind and thumb/poster
+     * are taken from the library entry).
+     *
+     * The promo is created INACTIVE: adding never pushes a running campaign out of the feed,
+     * so call setPromoActiveAsyncUnsafe to put it there.
      * @param salonId - The salon the promo belongs to (and, for a salon-target promo, links to).
-     * @param assetId - A #Ready asset from the salon's library; one asset can back only one promo.
+     * @param assetId - A #Ready asset from the salon's library; one asset may back several promos.
      * @param content - Overlay text lines (max 2), chips (max 2), button label and discount
      *        code (all optional — see PromoContentInput).
      * @param targetSalonServiceId - Optional: make the promo tap through to this service of the
      *        salon; omitted -> the promo targets the salon itself.
      * @returns A Promise that resolves to the new PromoId.
      * @throws Error `CanisterError` on a Framework.Result #err (not the owner, asset not in the
-     *         library or not #Ready, promo limit reached, duplicate asset, bad target, too many
-     *         lines/chips, ...).
+     *         library or not #Ready, library full, bad target, too many lines/chips, a discount
+     *         code that is not this salon's or whose scope does not fit the target, ...).
      * @throws Error `CriticalCanisterError` / `CallRefusedAtInspectionStage` as usual.
      */
     async addPromoAsyncUnsafe(salonId, assetId, content = {}, targetSalonServiceId) {
@@ -47,8 +57,45 @@ export class PromoActor extends ActorBase {
         }));
     }
     /**
-     * Removes a promo from the salon (owner only). This is also the "deactivate" — there is
-     * no separate active flag; the library asset stays untouched.
+     * Edits a promo in place (owner only). The promo keeps its id, its createdAt and its place
+     * in or out of the feed, so correcting a running campaign does not restart it. Every
+     * content field is replaced by what you pass — an omitted `content` field clears it.
+     * @param salonId - The salon that owns the promo.
+     * @param promoId - The promo to edit.
+     * @param assetId - A #Ready asset from the salon's library; may differ from the current one
+     *        (kind and thumb/poster are re-read from the new entry).
+     * @param content - The new overlay text lines, chips, button label and discount code.
+     * @param targetSalonServiceId - Optional new tap-through target; omitted -> the salon itself.
+     * @throws Error `CanisterError` on a Framework.Result #err (not the owner, promo not found,
+     *         promo of a different salon, plus every validation addPromo does).
+     */
+    async updatePromoAsyncUnsafe(salonId, promoId, assetId, content = {}, targetSalonServiceId) {
+        return this.executeFunctionAsyncUnsafe(() => this.actor.updatePromo({
+            salonId,
+            promoId,
+            assetId,
+            target: toCandidTarget(targetSalonServiceId),
+            textLines: content.textLines ?? [],
+            chips: content.chips ?? [],
+            cta: toCandidCta(content),
+        }));
+    }
+    /**
+     * Puts a promo in the geo feed (`active = true`) or takes it out (owner only). The promo
+     * stays in the library either way — this is the "deactivate"; removePromo is a real delete.
+     *
+     * Setting the flag to what it already is succeeds and changes nothing. Activating one promo
+     * too many FAILS rather than dropping a running one: which campaign comes down is the
+     * owner's decision, so deactivate one first.
+     * @throws Error `CanisterError` on a Framework.Result #err (not the owner, promo not found,
+     *         promo of a different salon, MAX_ACTIVE_PROMOS_PER_SALON already active).
+     */
+    async setPromoActiveAsyncUnsafe(salonId, promoId, active) {
+        return this.executeFunctionAsyncUnsafe(() => this.actor.setPromoActive({ salonId, promoId, active }));
+    }
+    /**
+     * Deletes a promo from the salon's library (owner only) — content, id and all. To only take
+     * it off the feed use setPromoActiveAsyncUnsafe. The library asset stays untouched.
      * @throws Error `CanisterError` on a Framework.Result #err (not the owner, promo not
      *         found, promo of a different salon).
      */
@@ -56,15 +103,20 @@ export class PromoActor extends ActorBase {
         return this.executeFunctionAsyncUnsafe(() => this.actor.removePromo({ salonId, promoId }));
     }
     /**
-     * Returns the salon's current promos — public query (promo content is public by nature).
+     * The salon's promos — a public query, but the answer depends on who asks: the salon's
+     * owner gets the whole library, everyone else gets the ACTIVE promos only. Drafts stay
+     * private because one may already carry a discount code the owner has not broadcast yet.
+     *
+     * So call this with the owner's identity to manage the library, and with any identity to
+     * read what the public sees.
      * @throws Error `CriticalCanisterError` on transport/canister failure.
      */
     async getSalonPromosAsyncUnsafe(salonId) {
         return this.executeFunctionAsyncUnsafe(() => this.actor.getSalonPromos(salonId));
     }
     /**
-     * Public geo feed: promos in the given geohash6 cells, deduplicated by promo id. The
-     * caller expands its radius into cells and should adapt the set to the response size
+     * Public geo feed: the ACTIVE promos in the given geohash6 cells, deduplicated by promo id.
+     * The caller expands its radius into cells and should adapt the set to the response size
      * (there is no server-side pagination; core soft-caps very large responses).
      * @param geohashes6 - The geohash6 cells covering the viewer's radius.
      * @throws Error `CriticalCanisterError` on transport/canister failure.

package/dist/index.d.ts

@@ -16,6 +16,7 @@ export { PromoActor } from "./actors/promo-actor.js";
 export { DiscountCodesActor } from "./actors/discount-codes-actor.js";
 export type { DiscountValueInput } from "./actors/discount-codes-actor.js";
 export type { PromoContentInput } from "./actors/promo-actor.js";
+export { MAX_PROMOS_PER_SALON, MAX_ACTIVE_PROMOS_PER_SALON } from "./actors/promo-actor.js";
 export type { PromoItem, PromoCta, PromoTarget, PromoId, DiscountCode, DiscountScope, DiscountValue, SupportedLanguage, ServiceTypeLabel, ServiceTypeTranslations, SetTranslationArgs, SalonPublicInfo } from "../declarations/sultana-core-motoko/sultana-core-motoko.did.js";
 export { SalonServicesActor } from "./actors/salon-services-actor.js";
 export { SalonsActor } from "./actors/salons-actor.js";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -8,6 +8,7 @@ export { HrActor } from "./actors/hr-actor.js";
 export { MigrationActor } from "./actors/migration-actor.js";
 export { PromoActor } from "./actors/promo-actor.js";
 export { DiscountCodesActor } from "./actors/discount-codes-actor.js";
+export { MAX_PROMOS_PER_SALON, MAX_ACTIVE_PROMOS_PER_SALON } from "./actors/promo-actor.js";
 export { SalonServicesActor } from "./actors/salon-services-actor.js";
 export { SalonsActor } from "./actors/salons-actor.js";
 export { SearchActor } from "./actors/search-actor.js";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jsm-mit/sultana-core-motoko-package",
-    "version": "0.3.0",
+    "version": "0.4.0",
     "description": "A TypeScript library for interacting with the Sultana Core Motoko actor on the Internet Computer (IC) platform.",
     "homepage": "https://github.com/JSM-Sultana/sultana-core-motoko-package#readme",
     "bugs": {