waha-shared 1.0.552 → 1.0.554

package/dist/chunks/{chunk-7VYOSR3V.mjs → chunk-46VSKJAN.mjs}

@@ -8926,194 +8926,6 @@ var require_translationsSet = __commonJS({
           }
         ],
         eng: [
-          {
-            lessonTitles: {
-              "01.063.001": "Creation",
-              "01.063.002": "Creation of Humans",
-              "01.063.003": "Humans Disobey God",
-              "01.063.004": "God Destroys an Evil Humanity",
-              "01.063.005": "Tower of Babel",
-              "01.063.006": "Abraham Trusted God",
-              "01.063.007": "Abraham Obeyed God",
-              "01.063.008": "God's Call to Moses",
-              "01.063.009": "The Passover Sacrifice",
-              "01.063.010": "The Ten Commandments and Sacrifice",
-              "01.063.011": "Cycle of Disobedience",
-              "01.063.012": "The Suffering Servant of God",
-              "01.063.013": "The Promised Saviour",
-              "01.063.014": "The Birth of Jesus"
-            },
-            pauseAndDiscuss: "Pause now and discuss.",
-            setDescription: "Start your journey toward discovering God by learning how He created the universe and everything in it. Find out how God began His relationship with mankind and what went wrong early on. These lessons give an overview of God\u2019s loving character and our need for forgiveness.",
-            setId: "01.063",
-            setTitle: "From Creation to the Birth of Jesus"
-          },
-          {
-            lessonTitles: {
-              "01.064.001": "John Testifies of the Saviour",
-              "01.064.002": "Temptation and Ministry of Jesus",
-              "01.064.003": "Jesus Heals and Forgives",
-              "01.064.004": "Jesus' Power ",
-              "01.064.005": "Forgiveness & Sacrifice",
-              "01.064.006": "Love God and Love Your Neighbor",
-              "01.064.007": "God Seeks the Lost",
-              "01.064.008": "Different Responses to God",
-              "01.064.009": "Jesus' Power Over Death",
-              "01.064.010": "Jesus' Humility",
-              "01.064.011": "Passover with the Disciples",
-              "01.064.012": "Jesus Arrested",
-              "01.064.013": "The Crucifixion",
-              "01.064.014": "The Resurrection and Ascension",
-              "01.064.015": "Jesus in Heaven"
-            },
-            setDescription: "Was Jesus a mighty prophet, a wise teacher, or something even more? These lessons introduce Jesus Christ as He demonstrates how we can be right with God and find the peace so many of us have been looking for.",
-            setId: "01.064",
-            setTitle: "The Life and Message of Jesus"
-          },
-          {
-            lessonTitles: {
-              "01.065.001": "Who is Jesus?",
-              "01.065.002": "What does Jesus offer you and ask you?",
-              "01.065.003": "What is the result of faith in Jesus?",
-              "01.065.004": "What is the price of following Jesus?",
-              "01.065.005": "Should we expect persecution?",
-              "01.065.006": "What is your response? ",
-              "01.065.007": "What does Baptism mean?",
-              "01.065.008": "What are His promises for His followers?",
-              "01.065.009": "How will God help us? ",
-              "01.065.010": "What does He tell us to do?"
-            },
-            setDescription: "As we begin to understand who Jesus is and what He did, it becomes clear we need to choose  how to respond to Him. These lessons help ensure you know everything you need in order to make that big decision.",
-            setId: "01.065",
-            setTitle: "Invitation of Jesus"
-          },
-          {
-            lessonTitles: {
-              "01.066.001": "Disciples Love God and Love Others",
-              "01.066.002": "Disciples Are Forgiven",
-              "01.066.003": "Disciples Are Children of God",
-              "01.066.004": "Disciples Seek our Father",
-              "01.066.005": "Disciples Rely on God's Word",
-              "01.066.006": "Disciples Are Led by God",
-              "01.066.007": "Disciples Obey Jesus and Fish for People",
-              "01.066.008": "Disciples Abide and Bear Fruit in Jesus",
-              "01.066.009": "Disciples Live by the Spirit",
-              "01.066.010": "Disciples Cannot be Separated from God's Love"
-            },
-            setDescription: "What does it mean to become a disciple of Jesus? How should your life be different now compared to before you encountered Him? These lessons help answer any questions you may have about being a disciple.",
-            setId: "01.066",
-            setTitle: "Being Disciples"
-          },
-          {
-            lessonTitles: {
-              "01.067.001": "The Church is the Body of Christ",
-              "01.067.002": "The Church is the Bride of Christ",
-              "01.067.003": "The Church is God\u2019s Family",
-              "01.067.004": "The Church is a Spiritual Temple and Priests",
-              "01.067.005": "The Church is United",
-              "01.067.006": "The Church is Guided by the Spirit",
-              "01.067.007": "The Church is God's Community",
-              "01.067.008": "The Church Praises God",
-              "01.067.009": "The Church Serves One Another",
-              "01.067.010": "The Church Does Signs and Wonders by the Spirit",
-              "01.067.011": "The Church Gives Generously",
-              "01.067.012": "The Church Remembers Christ's Sacrifice"
-            },
-            setDescription: "One of the first things we realize when we become a disciple of Jesus is that we aren\u2019t the only ones. There are a lot of other disciples out there, known collectively as the Church. These lessons help you learn what the Bible says about the Church and why it\u2019s important.",
-            setId: "01.067",
-            setTitle: "Being a Jesus Community"
-          },
-          {
-            lessonTitles: {
-              "01.068.001": "Jesus as Servant",
-              "01.068.002": "Jesus talks about Leadership",
-              "01.068.003": "What do good leaders do?",
-              "01.068.004": "What do bad leaders do?",
-              "01.068.005": "Jesus' Example as the Good Shepherd",
-              "01.068.006": "Paul's Example ",
-              "01.068.007": "Faithfulness and Multiplying",
-              "01.068.008": "Equipping the Disciples",
-              "01.068.009": "Paul's Instructions to Leaders",
-              "01.068.010": "A Sacrificed Life",
-              "01.068.011": "Leadership Qualifications",
-              "01.068.012": "Multiply Leaders"
-            },
-            setDescription: "As a disciple of Jesus, you have been given the Holy Spirit, and that makes you a leader. Whether  God guides you to lead in your workplace, the Church, or even just your family it is important to know what the Bible says about leadership. These lessons will help you lead in everyday life.",
-            setId: "01.068",
-            setTitle: "Being Leaders"
-          },
-          {
-            lessonTitles: {
-              "01.069.001": "Disciples Seek God",
-              "01.069.002": "Disciples Are Blessed by God",
-              "01.069.003": "Disciples Seek God's Kingdom",
-              "01.069.004": "Disciples Will Sacrifice to Follow Jesus",
-              "01.069.005": "Disciples Go into the Harvest",
-              "01.069.006": "Disciples Go with Jesus' Authority",
-              "01.069.007": "Disciples Fight with God's Word",
-              "01.069.008": "Disciples Live by the Spirit's Power",
-              "01.069.009": "Disciples Put Off the Old, Put on the New",
-              "01.069.010": " Disciples Confess Sins ",
-              "01.069.011": "Disciples Forgive others as the Lord forgives them",
-              "01.069.012": "Disciples Put on God's Armor"
-            },
-            setDescription: "Being a disciple is not just a one-time experience. It is a new way of life that involves growing and learning to be more like Jesus every day. These lessons will guide you into deeper discussions about what it really means to live as disciples of Jesus.",
-            setId: "01.069",
-            setTitle: "Growing as Disciples"
-          },
-          {
-            lessonTitles: {
-              "01.070.001": "The Church Belongs to God",
-              "01.070.002": "The Church Is the Household of God",
-              "01.070.003": "The Church Praises God",
-              "01.070.004": "The Church Helps Each Other",
-              "01.070.005": "The Church Serves Each Other",
-              "01.070.006": "The Church Prays Together",
-              "01.070.007": "The Church Prays For Each Other",
-              "01.070.008": "The Church Gives Sacrificially",
-              "01.070.009": "The Church Cannot Lie to God",
-              "01.070.010": "The Church Deals with Sin",
-              "01.070.011": "The Church Serves Others",
-              "01.070.012": "The Church Sends Workers Out"
-            },
-            setDescription: "If you\u2019ve been meeting for some time now, you might be wondering if God has something more for your church. What does it look like to really get serious about serving God and advancing His Kingdom? These lessons will shed more light on church growth.",
-            setId: "01.070",
-            setTitle: "Growing as a Jesus Community"
-          },
-          {
-            lessonTitles: {
-              "01.071.001": "Leaders Point People to Jesus",
-              "01.071.002": "Leaders Obey God in Everything",
-              "01.071.003": "Leaders Obey and Teach others to Obey",
-              "01.071.004": "Leaders Pray for Followers",
-              "01.071.005": "Leaders Judge Rightly",
-              "01.071.006": "Leaders Follow God's Wisdom",
-              "01.071.007": "Leaders are Good Stewards",
-              "01.071.008": "Leaders Sometimes Stumble but Can Still Serve",
-              "01.071.009": "Leaders Warn and Encourage",
-              "01.071.010": "Leaders Communicate Across Cultures",
-              "01.071.011": "Leaders Have Faith and Endurance",
-              "01.071.012": "Leaders Give Up Their Rights"
-            },
-            setDescription: "If you are living life as a disciple that makes disciples, then by now you probably realize you need to grow as a more capable leader. These lessons will tackle some of the most difficult questions of leadership, and help you understand the wisdom the Bible holds for those who serve others.",
-            setId: "01.071",
-            setTitle: "Growing as Leaders"
-          },
-          {
-            lessonTitles: {
-              "02.073.001": "Hope for the Rejected",
-              "02.073.002": "Hope for the Non-religious",
-              "02.073.003": "Hope for the Sick and Sinful",
-              "02.073.004": "Hope for the Religious",
-              "02.073.005": "Hope Changes Lives",
-              "02.073.006": "Hope Forgives",
-              "02.073.007": "Hungry for Hope",
-              "02.073.008": "Hope is Waiting for You"
-            },
-            setId: "02.073",
-            setTag: "Truth",
-            setTitle: "Hope"
-          },
           {
             lessonTitles: {
               "03.005.001": "Vision",

package/dist/chunks/{chunk-RQR7ADQ3.mjs → chunk-5JMRXTQB.mjs}

@@ -3,7 +3,9 @@ import { z } from "zod";
 var CurriculumTopics = z.array(
   z.object({
     curriculumId: z.string(),
-    crowdinProjectId: z.string(),
+    crowdinProjectId: z.string().optional().describe(
+      "The Crowdin project for this curriculum's title translations. Leave it out when the curriculum has no titles of its own, like ASL, whose sets take their titles from the main set with the same name. Prep and the Crowdin config then skip it."
+    ),
     sets: z.array(z.string()).describe(
       "An array of set ids that make up this topics curriculum. Set ids must be linked to valid sets present in data/sets.json."
     )

package/dist/chunks/{chunk-44FF5O3D.mjs → chunk-B6C4GGOM.mjs}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-PV7LVBQJ.mjs";
 import {
   numerals
-} from "./chunk-RKEA5BP2.mjs";
+} from "./chunk-TGVLQAXS.mjs";
 import {
   getBibleInfo
 } from "./chunk-LZ7M5WP7.mjs";

package/dist/chunks/{chunk-7HGUA25M.mjs → chunk-IYDI5F2O.mjs}

@@ -1,6 +1,6 @@
 import {
   CurriculumFoundations
-} from "./chunk-FBVDZGXA.mjs";
+} from "./chunk-VYO3H52S.mjs";
 import {
   __commonJS
 } from "./chunk-5AVXA5JL.mjs";
@@ -66,7 +66,6 @@ var require_curriculumFoundations = __commonJS({
         },
         {
           curriculumId: "ase",
-          crowdinProjectId: "549537",
           sets: [
             "01.063",
             "01.064",

package/dist/chunks/{chunk-RKEA5BP2.mjs → chunk-TGVLQAXS.mjs}

@@ -1,9 +1,9 @@
 import {
   curriculumFoundations
-} from "./chunk-7HGUA25M.mjs";
+} from "./chunk-IYDI5F2O.mjs";
 import {
   curriculumTopics
-} from "./chunk-KCYVCCJ5.mjs";
+} from "./chunk-YOWQLQC3.mjs";
 import {
   curriculumQuestions
 } from "./chunk-LODLCRYD.mjs";
@@ -24,7 +24,7 @@ import {
 } from "./chunk-VSLJCKFL.mjs";
 import {
   translationsSet
-} from "./chunk-7VYOSR3V.mjs";
+} from "./chunk-46VSKJAN.mjs";
 import {
   translationsQuestion
 } from "./chunk-OCE4ZKES.mjs";

package/dist/chunks/{chunk-FBVDZGXA.mjs → chunk-VYO3H52S.mjs}

@@ -3,7 +3,9 @@ import { z } from "zod";
 var CurriculumFoundations = z.array(
   z.object({
     curriculumId: z.string(),
-    crowdinProjectId: z.string(),
+    crowdinProjectId: z.string().optional().describe(
+      "The Crowdin project for this curriculum's title translations. Leave it out when the curriculum has no titles of its own, like ASL, whose sets take their titles from the main set with the same name. Prep and the Crowdin config then skip it."
+    ),
     sets: z.array(z.string()).describe(
       "An array of set ids that make up this foundations curriculum. Set ids must be linked to valid sets present in data/sets.json."
     )

package/dist/chunks/{chunk-KCYVCCJ5.mjs → chunk-YOWQLQC3.mjs}

@@ -1,6 +1,6 @@
 import {
   CurriculumTopics
-} from "./chunk-RQR7ADQ3.mjs";
+} from "./chunk-5JMRXTQB.mjs";
 import {
   __commonJS
 } from "./chunk-5AVXA5JL.mjs";
@@ -15,7 +15,6 @@ var require_curriculumTopics = __commonJS({
       data: [
         {
           curriculumId: "ase",
-          crowdinProjectId: "549537",
           sets: ["02.073", "02.075", "02.076", "02.078", "02.079", "02.080"]
         },
         {

package/dist/data/curriculumFoundations/curriculumFoundations.zod.d.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 export declare const CurriculumFoundations: z.ZodArray<z.ZodObject<{
     curriculumId: z.ZodString;
-    crowdinProjectId: z.ZodString;
+    crowdinProjectId: z.ZodOptional<z.ZodString>;
     sets: z.ZodArray<z.ZodString>;
 }, z.core.$strict>>;
 export type CurriculumFoundations = z.infer<typeof CurriculumFoundations>;

package/dist/data/curriculumFoundations/curriculumFoundations.zod.mjs

@@ -1,6 +1,6 @@
 import {
   CurriculumFoundations
-} from "../../chunks/chunk-FBVDZGXA.mjs";
+} from "../../chunks/chunk-VYO3H52S.mjs";
 import "../../chunks/chunk-5AVXA5JL.mjs";
 export {
   CurriculumFoundations

package/dist/data/curriculumFoundations/index.d.ts

@@ -1,5 +1,5 @@
 export declare const curriculumFoundations: {
     curriculumId: string;
-    crowdinProjectId: string;
     sets: string[];
+    crowdinProjectId?: string | undefined;
 }[];

package/dist/data/curriculumFoundations/index.mjs

@@ -1,7 +1,7 @@
 import {
   curriculumFoundations
-} from "../../chunks/chunk-7HGUA25M.mjs";
-import "../../chunks/chunk-FBVDZGXA.mjs";
+} from "../../chunks/chunk-IYDI5F2O.mjs";
+import "../../chunks/chunk-VYO3H52S.mjs";
 import "../../chunks/chunk-5AVXA5JL.mjs";
 export {
   curriculumFoundations

package/dist/data/curriculumFoundations.mjs

@@ -1,7 +1,7 @@
 import {
   curriculumFoundations
-} from "../chunks/chunk-7HGUA25M.mjs";
-import "../chunks/chunk-FBVDZGXA.mjs";
+} from "../chunks/chunk-IYDI5F2O.mjs";
+import "../chunks/chunk-VYO3H52S.mjs";
 import "../chunks/chunk-5AVXA5JL.mjs";
 export {
   curriculumFoundations

package/dist/data/curriculumTopics/curriculumTopics.zod.d.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 export declare const CurriculumTopics: z.ZodArray<z.ZodObject<{
     curriculumId: z.ZodString;
-    crowdinProjectId: z.ZodString;
+    crowdinProjectId: z.ZodOptional<z.ZodString>;
     sets: z.ZodArray<z.ZodString>;
 }, z.core.$strict>>;
 export type CurriculumTopics = z.infer<typeof CurriculumTopics>;

package/dist/data/curriculumTopics/curriculumTopics.zod.mjs

@@ -1,6 +1,6 @@
 import {
   CurriculumTopics
-} from "../../chunks/chunk-RQR7ADQ3.mjs";
+} from "../../chunks/chunk-5JMRXTQB.mjs";
 import "../../chunks/chunk-5AVXA5JL.mjs";
 export {
   CurriculumTopics

package/dist/data/curriculumTopics/index.d.ts

@@ -1,5 +1,5 @@
 export declare const curriculumTopics: {
     curriculumId: string;
-    crowdinProjectId: string;
     sets: string[];
+    crowdinProjectId?: string | undefined;
 }[];

package/dist/data/curriculumTopics/index.mjs

@@ -1,7 +1,7 @@
 import {
   curriculumTopics
-} from "../../chunks/chunk-KCYVCCJ5.mjs";
-import "../../chunks/chunk-RQR7ADQ3.mjs";
+} from "../../chunks/chunk-YOWQLQC3.mjs";
+import "../../chunks/chunk-5JMRXTQB.mjs";
 import "../../chunks/chunk-5AVXA5JL.mjs";
 export {
   curriculumTopics

package/dist/data/curriculumTopics.mjs

@@ -1,7 +1,7 @@
 import {
   curriculumTopics
-} from "../chunks/chunk-KCYVCCJ5.mjs";
-import "../chunks/chunk-RQR7ADQ3.mjs";
+} from "../chunks/chunk-YOWQLQC3.mjs";
+import "../chunks/chunk-5JMRXTQB.mjs";
 import "../chunks/chunk-5AVXA5JL.mjs";
 export {
   curriculumTopics

package/dist/data/translationsSet/index.mjs

@@ -1,6 +1,6 @@
 import {
   translationsSet
-} from "../../chunks/chunk-7VYOSR3V.mjs";
+} from "../../chunks/chunk-46VSKJAN.mjs";
 import "../../chunks/chunk-SMLKJF5I.mjs";
 import "../../chunks/chunk-5AVXA5JL.mjs";
 export {

package/dist/data/translationsSet.mjs

@@ -1,6 +1,6 @@
 import {
   translationsSet
-} from "../chunks/chunk-7VYOSR3V.mjs";
+} from "../chunks/chunk-46VSKJAN.mjs";
 import "../chunks/chunk-SMLKJF5I.mjs";
 import "../chunks/chunk-5AVXA5JL.mjs";
 export {

package/dist/functions/crowdin.d.ts

@@ -54,16 +54,32 @@ interface DownloadTranslationsParams {
  * Downloads translations from Crowdin for a given project ID and source path.
  */
 export declare function downloadTranslations({ projectId, translationsFolder, token, sourcePattern, }: DownloadTranslationsParams): void;
+/**
+ * Parser and import settings for files Crowdin can't read with its defaults,
+ * such as the `fm_md` drip emails. `type` only applies on create; Crowdin
+ * rejects it on update.
+ */
+export interface CrowdinFileSettings {
+    type?: SourceFilesModel.FileType;
+    importOptions?: SourceFilesModel.ImportOptions;
+}
 interface UploadSourceParams {
     /** The id of the project to upload to, from `crowdinProjectIds`. */
     projectId: string;
     /**
-     * Absolute path to the source file to upload, somewhere under a `crowdin/`
-     * directory (e.g. `/path/to/project/crowdin/eng/app_interface_text.json`,
-     * or `/path/to/project/crowdin/foo.md` for a project that keeps sources at
-     * the root). The path Crowdin sees is everything after `crowdin/`.
+     * Absolute path to the local source file. When `dest` is omitted this must
+     * sit somewhere under a `crowdin/` directory (e.g.
+     * `/path/to/project/crowdin/eng/app_interface_text.json`) so the Crowdin
+     * path can be derived from it.
      */
     source: string;
+    /**
+     * Where the file lives in Crowdin, e.g. `main.json`. Defaults to everything
+     * after `crowdin/` in `source`, which is wrong when the project's layout
+     * differs from the repo's. A wrong path creates a new file with none of the
+     * real one's translations, hence `allowCreate`.
+     */
+    dest?: string;
     /** The Crowdin personal access token to use for authentication. */
     token: string;
     /**
@@ -72,11 +88,15 @@ interface UploadSourceParams {
      */
     label?: string;
     /** Parser and import settings, for files needing more than the defaults. */
-    fileSettings?: FileSettings;
-}
-interface FileSettings {
-    type?: SourceFilesModel.FileType;
-    importOptions?: SourceFilesModel.ImportOptions;
+    fileSettings?: CrowdinFileSettings;
+    /**
+     * Whether a file Crowdin doesn't already have may be created. Defaults to
+     * true. Pass false to make the upload update-only, so a mistyped path throws
+     * instead of orphaning the real file's translations.
+     */
+    allowCreate?: boolean;
+    /** Resolve what would happen and report it without uploading anything. */
+    dryRun?: boolean;
 }
 /**
  * The request that replaces an existing file. Built separately from
@@ -88,19 +108,26 @@ interface FileSettings {
  */
 export declare function replaceFileRequest({ storageId, fileSettings, attachLabelIds, }: {
     storageId: number;
-    fileSettings?: FileSettings;
+    fileSettings?: CrowdinFileSettings;
     attachLabelIds?: number[];
 }): SourceFilesModel.ReplaceFileFromStorageRequest;
 /** The request that creates a new file. See {@link replaceFileRequest}. */
 export declare function createFileRequest({ storageId, name, fileSettings, attachLabelIds, directoryId, }: {
     storageId: number;
     name: string;
-    fileSettings?: FileSettings;
+    fileSettings?: CrowdinFileSettings;
     attachLabelIds?: number[];
     directoryId?: number;
 }): SourceFilesModel.CreateFileRequest;
-/** Uploads a source file to Crowdin, creating it or replacing its contents. */
-export declare function uploadSource({ projectId, source, token, label, fileSettings, }: UploadSourceParams): Promise<void>;
+/**
+ * Whether an upload created a new file in Crowdin or updated an existing one.
+ */
+export type UploadSourceOutcome = 'created' | 'updated';
+/**
+ * Uploads a source file to Crowdin, creating it or replacing its contents, and
+ * reports which of the two it did.
+ */
+export declare function uploadSource({ projectId, source, dest, token, label, fileSettings, allowCreate, dryRun, }: UploadSourceParams): Promise<UploadSourceOutcome>;
 /**
  * The directory a new file at `relativePath` belongs in, or undefined for a
  * file at the project root.
@@ -115,4 +142,68 @@ export interface CrowdinDirectory {
     path: string;
 }
 export declare function findDirectoryId(directories: CrowdinDirectory[], projectId: number, relativePath: string): number | undefined;
+/** One source file a repo owns, as declared in its Crowdin sources config. */
+export interface CrowdinSourceFileConfig {
+    /**
+     * Path to the local file, relative to the `baseDir` passed to
+     * `uploadSources`. With the repo's `crowdin/` directory as `baseDir`, that's
+     * `eng/main.json`.
+     */
+    source: string;
+    /** The project this file belongs to, from `crowdinProjectIds`. */
+    projectId: string;
+    /**
+     * Where the file lives in Crowdin. Defaults to the part of `source` below
+     * the repo's `crowdin/` directory. See `UploadSourceParams['dest']`.
+     */
+    dest?: string;
+    /** Parser and import settings, for files needing more than the defaults. */
+    fileSettings?: CrowdinFileSettings;
+    /**
+     * Lets this file be created even when the run doesn't allow it. For files
+     * where a new one is routine rather than a typo, like the drip emails (one
+     * file per email). Leave it off for hand-maintained files.
+     */
+    allowCreate?: boolean;
+}
+/**
+ * Everything a repo uploads to Crowdin. One config per repo rather than per
+ * project, since a repo's files often span several projects and one list
+ * leaves one place to register a file.
+ */
+export interface CrowdinSourcesConfig {
+    files: CrowdinSourceFileConfig[];
+}
+interface UploadSourcesParams {
+    config: CrowdinSourcesConfig;
+    /** The directory `config`'s `source` paths are relative to. */
+    baseDir: string;
+    /** The Crowdin personal access token to use for authentication. */
+    token: string;
+    /** Label to attach to new strings in every uploaded file. */
+    label?: string;
+    /**
+     * Whether files Crowdin doesn't already have may be created. Defaults to
+     * false, unlike `uploadSource`, so an unattended run fails on a wrong path.
+     * Entries that set their own `allowCreate` may be created either way.
+     */
+    allowCreate?: boolean;
+    /**
+     * Upload only the entries with these `source` paths, e.g.
+     * `['eng/app_interface_text.json']`, including every project a file is in.
+     * A path matching no entry throws before anything is uploaded.
+     */
+    only?: string[];
+    /** Report what each file would do without uploading anything. */
+    dryRun?: boolean;
+}
+/**
+ * Uploads every file in a Crowdin sources config, one at a time to stay under
+ * Crowdin's rate limit and keep the log readable, and returns how many it
+ * uploaded.
+ *
+ * A failed file doesn't stop the others: the run finishes, then throws with
+ * every failure listed.
+ */
+export declare function uploadSources({ config, baseDir, token, label, allowCreate, only, dryRun, }: UploadSourcesParams): Promise<number>;
 export {};

package/dist/functions/crowdin.mjs

@@ -1,7 +1,10 @@
 import "../chunks/chunk-5AVXA5JL.mjs";
 
 // functions/crowdin.ts
-import CrowdinClient from "@crowdin/crowdin-api-client";
+import {
+  Client as CrowdinClient,
+  CrowdinError
+} from "@crowdin/crowdin-api-client";
 import fs from "fs";
 import { spawnSync } from "node:child_process";
 import path from "path";
@@ -46,9 +49,22 @@ function downloadTranslations({
     }
   );
 }
-var exportOptions = {
-  exportPattern: `/${CROWDIN_TRANSLATION_PATTERN}`
-};
+function crowdinClient(token) {
+  return new CrowdinClient(
+    { token },
+    {
+      retryConfig: {
+        retries: 3,
+        waitInterval: 5e3,
+        conditions: [
+          {
+            test: (error) => error instanceof CrowdinError && error.code < 500 && error.code !== 429
+          }
+        ]
+      }
+    }
+  );
+}
 function replaceFileRequest({
   storageId,
   fileSettings,
@@ -56,10 +72,14 @@ function replaceFileRequest({
 }) {
   return {
     storageId,
-    exportOptions,
     // Keeps translations of revised strings but drops their approvals, so a
     // reviewer looks again rather than stale copy staying green.
     updateOption: "keep_translations",
+    /*
+     * No `exportOptions`, so a project's custom export pattern survives an
+     * update (Waha Training exports `glossary-8064.tbx` as
+     * `03.009.000.glossary.tbx`).
+     */
     ...fileSettings?.importOptions && {
       importOptions: fileSettings.importOptions
     },
@@ -76,7 +96,7 @@ function createFileRequest({
   return {
     storageId,
     name,
-    exportOptions,
+    exportOptions: { exportPattern: `/${CROWDIN_TRANSLATION_PATTERN}` },
     ...fileSettings,
     ...attachLabelIds && { attachLabelIds },
     ...directoryId !== void 0 && { directoryId }
@@ -85,17 +105,17 @@ function createFileRequest({
 async function uploadSource({
   projectId,
   source,
+  dest,
   token,
   label,
-  fileSettings
+  fileSettings,
+  allowCreate = true,
+  dryRun = false
 }) {
-  const client = new CrowdinClient({ token });
+  const client = crowdinClient(token);
   const id = Number(projectId);
-  const relativePath = crowdinRelativePath(source);
+  const relativePath = (dest ?? crowdinRelativePath(source)).replace(/^\//, "");
   const fileName = relativePath.slice(relativePath.lastIndexOf("/") + 1);
-  const contents = fs.readFileSync(source, "utf8");
-  const storage = await client.uploadStorageApi.addStorage(fileName, contents);
-  const storageId = storage.data.id;
   const files = await client.sourceFilesApi.listProjectFiles(id, {
     filter: fileName,
     limit: 500
@@ -103,6 +123,15 @@ async function uploadSource({
   const existing = files.data.find(
     (file) => file.data.path === `/${relativePath}`
   );
+  if (!existing && !allowCreate) {
+    throw new Error(
+      `Crowdin project ${projectId} has no /${relativePath}, and creating it was not allowed. Either the path is wrong \u2014 check it against the project's Sources & Translations page \u2014 or the file really is new, in which case upload it once with creation enabled.`
+    );
+  }
+  if (dryRun) return existing ? "updated" : "created";
+  const contents = fs.readFileSync(source, "utf8");
+  const storage = await client.uploadStorageApi.addStorage(fileName, contents);
+  const storageId = storage.data.id;
   const attachLabelIds = label ? [await labelId(client, id, label)] : void 0;
   if (existing) {
     await client.sourceFilesApi.updateOrRestoreFile(
@@ -110,7 +139,7 @@ async function uploadSource({
       existing.data.id,
       replaceFileRequest({ storageId, fileSettings, attachLabelIds })
     );
-    return;
+    return "updated";
   }
   const directories = relativePath.includes("/") ? await client.sourceFilesApi.listProjectDirectories(id, { limit: 500 }) : { data: [] };
   await client.sourceFilesApi.createFile(
@@ -127,6 +156,7 @@ async function uploadSource({
       )
     })
   );
+  return "created";
 }
 async function labelId(client, projectId, title) {
   const labels = await client.labelsApi.listLabels(projectId, { limit: 500 });
@@ -146,6 +176,60 @@ function findDirectoryId(directories, projectId, relativePath) {
   }
   return match.id;
 }
+async function uploadSources({
+  config,
+  baseDir,
+  token,
+  label,
+  allowCreate = false,
+  only,
+  dryRun = false
+}) {
+  const files = only ? config.files.filter((file) => only.includes(file.source)) : config.files;
+  const unmatched = (only ?? []).filter(
+    (source) => !files.some((file) => file.source === source)
+  );
+  if (unmatched.length > 0) {
+    throw new Error(
+      `No Crowdin sources config entry for ${unmatched.join(", ")}. Paths are relative to ${baseDir}, e.g. eng/app_interface_text.json.`
+    );
+  }
+  const failures = [];
+  for (const file of files) {
+    const source = path.resolve(baseDir, file.source);
+    const target = `${file.source} -> project ${file.projectId}`;
+    if (!fs.existsSync(source)) {
+      failures.push(`  ${file.source}: Local file ${source} does not exist.`);
+      console.log(`failed: ${target} (missing)`);
+      continue;
+    }
+    const dest = (file.dest ?? crowdinRelativePath(source)).replace(/^\//, "");
+    try {
+      const outcome = await uploadSource({
+        projectId: file.projectId,
+        source,
+        dest,
+        token,
+        label,
+        fileSettings: file.fileSettings,
+        allowCreate: allowCreate || Boolean(file.allowCreate),
+        dryRun
+      });
+      console.log(`${dryRun ? "would be " : ""}${outcome}: ${target} /${dest}`);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      failures.push(`  ${file.source}: ${message}`);
+      console.log(`failed: ${target} /${dest}`);
+    }
+  }
+  if (failures.length > 0) {
+    throw new Error(
+      `${failures.length} of ${files.length} Crowdin uploads failed:
+` + failures.join("\n")
+    );
+  }
+  return files.length;
+}
 export {
   CROWDIN_TRANSLATION_PATTERN,
   createFileRequest,
@@ -154,5 +238,6 @@ export {
   downloadTranslations,
   findDirectoryId,
   replaceFileRequest,
-  uploadSource
+  uploadSource,
+  uploadSources
 };

package/dist/functions/languages.mjs

@@ -5,11 +5,11 @@ import {
   getMeetTranslations,
   isLanguageAvailable,
   numerals
-} from "../chunks/chunk-RKEA5BP2.mjs";
-import "../chunks/chunk-7HGUA25M.mjs";
-import "../chunks/chunk-FBVDZGXA.mjs";
-import "../chunks/chunk-KCYVCCJ5.mjs";
-import "../chunks/chunk-RQR7ADQ3.mjs";
+} from "../chunks/chunk-TGVLQAXS.mjs";
+import "../chunks/chunk-IYDI5F2O.mjs";
+import "../chunks/chunk-VYO3H52S.mjs";
+import "../chunks/chunk-YOWQLQC3.mjs";
+import "../chunks/chunk-5JMRXTQB.mjs";
 import "../chunks/chunk-LODLCRYD.mjs";
 import "../chunks/chunk-LUPH55O7.mjs";
 import "../chunks/chunk-DQQEFFNA.mjs";
@@ -22,7 +22,7 @@ import "../chunks/chunk-BS5UUPEA.mjs";
 import "../chunks/chunk-MZGGI6PG.mjs";
 import "../chunks/chunk-VSLJCKFL.mjs";
 import "../chunks/chunk-MG76FEEV.mjs";
-import "../chunks/chunk-7VYOSR3V.mjs";
+import "../chunks/chunk-46VSKJAN.mjs";
 import "../chunks/chunk-SMLKJF5I.mjs";
 import "../chunks/chunk-OCE4ZKES.mjs";
 import "../chunks/chunk-Y7GBCSFN.mjs";

package/dist/functions/scripturePassages.mjs

@@ -8,13 +8,13 @@ import {
   normalizeVerseTimings,
   verseToSuperscript,
   withChapterPlaceholders
-} from "../chunks/chunk-44FF5O3D.mjs";
+} from "../chunks/chunk-B6C4GGOM.mjs";
 import "../chunks/chunk-PV7LVBQJ.mjs";
-import "../chunks/chunk-RKEA5BP2.mjs";
-import "../chunks/chunk-7HGUA25M.mjs";
-import "../chunks/chunk-FBVDZGXA.mjs";
-import "../chunks/chunk-KCYVCCJ5.mjs";
-import "../chunks/chunk-RQR7ADQ3.mjs";
+import "../chunks/chunk-TGVLQAXS.mjs";
+import "../chunks/chunk-IYDI5F2O.mjs";
+import "../chunks/chunk-VYO3H52S.mjs";
+import "../chunks/chunk-YOWQLQC3.mjs";
+import "../chunks/chunk-5JMRXTQB.mjs";
 import "../chunks/chunk-LODLCRYD.mjs";
 import "../chunks/chunk-LUPH55O7.mjs";
 import "../chunks/chunk-DQQEFFNA.mjs";
@@ -27,7 +27,7 @@ import "../chunks/chunk-BS5UUPEA.mjs";
 import "../chunks/chunk-MZGGI6PG.mjs";
 import "../chunks/chunk-VSLJCKFL.mjs";
 import "../chunks/chunk-MG76FEEV.mjs";
-import "../chunks/chunk-7VYOSR3V.mjs";
+import "../chunks/chunk-46VSKJAN.mjs";
 import "../chunks/chunk-SMLKJF5I.mjs";
 import "../chunks/chunk-OCE4ZKES.mjs";
 import "../chunks/chunk-Y7GBCSFN.mjs";

package/dist/functions/sentry.d.ts

@@ -22,5 +22,6 @@ export declare function sentryOptions({ dsn, enabled, }: {
     sendDefaultPii: false;
     sendClientReports: false;
     integrations: (defaults: Integration[]) => Integration[];
+    ignoreErrors: string[];
     beforeSend: typeof stripFileQueries;
 };

package/dist/functions/sentry.mjs

@@ -16,6 +16,11 @@ function stripFileQueries(event) {
   });
   return event;
 }
+var ignoredErrors = [
+  // Firebase Analytics registering an installation while the visitor is
+  // offline. It rejects a promise inside `getAnalytics` that nothing awaits.
+  "installations/app-offline"
+];
 function sentryOptions({
   dsn,
   enabled
@@ -28,6 +33,7 @@ function sentryOptions({
     // browser only contacts Sentry to report an error.
     sendClientReports: false,
     integrations: (defaults) => defaults.filter((integration) => integration.name !== "BrowserSession"),
+    ignoreErrors: ignoredErrors,
     beforeSend: stripFileQueries
   };
 }

package/dist/functions/sets.mjs

@@ -9,13 +9,13 @@ import "../chunks/chunk-2A7C3PEI.mjs";
 import {
   getFtbDuration,
   getPassagesString
-} from "../chunks/chunk-44FF5O3D.mjs";
+} from "../chunks/chunk-B6C4GGOM.mjs";
 import "../chunks/chunk-PV7LVBQJ.mjs";
-import "../chunks/chunk-RKEA5BP2.mjs";
-import "../chunks/chunk-7HGUA25M.mjs";
-import "../chunks/chunk-FBVDZGXA.mjs";
-import "../chunks/chunk-KCYVCCJ5.mjs";
-import "../chunks/chunk-RQR7ADQ3.mjs";
+import "../chunks/chunk-TGVLQAXS.mjs";
+import "../chunks/chunk-IYDI5F2O.mjs";
+import "../chunks/chunk-VYO3H52S.mjs";
+import "../chunks/chunk-YOWQLQC3.mjs";
+import "../chunks/chunk-5JMRXTQB.mjs";
 import "../chunks/chunk-LODLCRYD.mjs";
 import "../chunks/chunk-LUPH55O7.mjs";
 import "../chunks/chunk-DQQEFFNA.mjs";
@@ -30,7 +30,7 @@ import {
   specialIds
 } from "../chunks/chunk-VSLJCKFL.mjs";
 import "../chunks/chunk-MG76FEEV.mjs";
-import "../chunks/chunk-7VYOSR3V.mjs";
+import "../chunks/chunk-46VSKJAN.mjs";
 import "../chunks/chunk-SMLKJF5I.mjs";
 import "../chunks/chunk-OCE4ZKES.mjs";
 import "../chunks/chunk-Y7GBCSFN.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "waha-shared",
-  "version": "1.0.552",
+  "version": "1.0.554",
   "author": "Waha",
   "dependencies": {
     "@types/signale": "^1.4.7",