@withpotter/lib 0.13.0-next.101

package/dist/schema-validation.js

@@ -0,0 +1,252 @@
+import { z } from "zod";
+const fieldTypeSchema = z.enum([
+  "text",
+  "textarea",
+  "richtext",
+  "number",
+  "currency",
+  "boolean",
+  "toggle",
+  "image",
+  "gallery",
+  "select",
+  "categorySelect",
+  "resourceSelect",
+  "contentSelect",
+  "multiselect",
+  "tags",
+  "date",
+  "datetime",
+  "time",
+  "duration",
+  "url",
+  "email",
+  "phone",
+  "color",
+  "icon",
+  "array",
+  "json",
+  "relation",
+  "component",
+  "repeatable"
+]);
+const selectOptionSchema = z.object({
+  label: z.string(),
+  value: z.string(),
+  icon: z.string().optional(),
+  color: z.string().optional()
+});
+const validationRuleSchema = z.object({
+  type: z.enum([
+    "required",
+    "min",
+    "max",
+    "minLength",
+    "maxLength",
+    "pattern",
+    "custom"
+  ]),
+  value: z.union([z.number(), z.string()]).optional(),
+  message: z.string().optional()
+});
+const contentFieldSchema = z.lazy(
+  () => z.object({
+    name: z.string().min(1, "Field name is required"),
+    label: z.string().min(1, "Field label is required"),
+    type: fieldTypeSchema,
+    description: z.string().optional(),
+    placeholder: z.string().optional(),
+    required: z.boolean().optional(),
+    validations: z.array(validationRuleSchema).optional(),
+    options: z.array(selectOptionSchema).optional(),
+    min: z.number().optional(),
+    max: z.number().optional(),
+    step: z.number().optional(),
+    prefix: z.string().optional(),
+    suffix: z.string().optional(),
+    showIf: z.object({
+      field: z.string(),
+      equals: z.unknown().optional(),
+      notEquals: z.unknown().optional(),
+      in: z.array(z.unknown()).optional()
+    }).optional(),
+    width: z.enum(["full", "half", "third"]).optional(),
+    group: z.string().optional(),
+    relation: z.object({
+      endpoint: z.string(),
+      displayField: z.string(),
+      multiple: z.boolean().optional()
+    }).optional(),
+    fields: z.array(z.lazy(() => contentFieldSchema)).optional(),
+    maxItems: z.number().optional(),
+    minItems: z.number().optional(),
+    defaultValue: z.unknown().optional(),
+    // Allow additional properties for template-specific extensions
+    categoryKey: z.string().optional()
+  }).passthrough()
+);
+const fieldGroupSchema = z.object({
+  name: z.string().min(1),
+  label: z.string(),
+  description: z.string().optional(),
+  collapsed: z.boolean().optional(),
+  fields: z.array(z.string())
+});
+const contentBehaviorSchema = z.enum([
+  "sellable",
+  "bookable",
+  "giftable",
+  "subscribable",
+  "leadCapture",
+  "downloadable",
+  "shippable",
+  "rentable",
+  "ticketed",
+  "billable",
+  "publishable",
+  "showcase"
+]);
+const contentTypeSchema = z.object({
+  name: z.string().min(1, "Content type name is required"),
+  singularName: z.string().optional(),
+  description: z.string().optional(),
+  icon: z.string().optional(),
+  apiEndpoint: z.string().min(1, "API endpoint is required"),
+  contentTypeKey: z.string().optional(),
+  behaviors: z.array(contentBehaviorSchema).optional(),
+  bookingModel: z.enum(["time-slot", "date-range"]).optional(),
+  excludeGroups: z.array(z.string()).optional(),
+  fields: z.array(contentFieldSchema).min(1, "Content type must have at least one field"),
+  fieldGroups: z.array(fieldGroupSchema).optional(),
+  listFields: z.array(z.string()).optional(),
+  searchFields: z.array(z.string()).optional(),
+  listView: z.record(z.string(), z.unknown()).optional(),
+  // ListViewConfig is complex, validate structurally
+  defaultSort: z.object({
+    field: z.string(),
+    direction: z.enum(["asc", "desc"])
+  }).optional()
+}).passthrough();
+const dashboardModuleSchema = z.object({
+  id: z.string().min(1, "Module ID is required"),
+  // Support both old (title) and new (label) formats
+  label: z.string().optional(),
+  title: z.string().optional(),
+  name: z.string().optional(),
+  // Support both old (/admin/*) and new (/dashboard/*) path formats
+  path: z.string().min(1, "Module path is required"),
+  icon: z.string().optional(),
+  description: z.string().optional(),
+  badge: z.string().optional(),
+  contentType: z.string().optional(),
+  enabled: z.boolean().optional()
+  // old format
+}).refine((mod) => mod.label || mod.title || mod.name, {
+  message: "Module must have at least one of: label, title, or name"
+});
+const settingsFieldSchema = z.object({
+  name: z.string().min(1),
+  label: z.string().min(1),
+  type: fieldTypeSchema,
+  description: z.string().optional(),
+  placeholder: z.string().optional(),
+  required: z.boolean().optional(),
+  default: z.unknown().optional(),
+  options: z.array(selectOptionSchema).optional()
+}).passthrough();
+const settingsSectionSchema = z.object({
+  label: z.string().optional(),
+  title: z.string().optional(),
+  // old format
+  description: z.string().optional(),
+  fields: z.union([
+    z.array(settingsFieldSchema),
+    z.record(z.string(), z.unknown())
+    // object-keyed fields (old format)
+  ]).optional()
+}).passthrough();
+const siteSettingsSchema = z.record(z.string(), settingsSectionSchema);
+const pageContentSchema = z.record(z.string(), z.unknown()).optional();
+const dashboardSchemaValidator = z.object({
+  contentTypes: z.record(z.string(), contentTypeSchema).optional(),
+  behaviors: z.array(contentBehaviorSchema).optional(),
+  siteSettings: siteSettingsSchema.optional(),
+  pageContent: pageContentSchema,
+  dashboardModules: z.array(dashboardModuleSchema).min(1, "At least one dashboard module is required")
+}).refine(
+  (schema) => {
+    const modules = schema.dashboardModules || [];
+    const hasOverview = modules.some(
+      (m) => m.id === "overview" || m.path === "/dashboard" || m.path === "/admin" || m.path === "/overview"
+    );
+    return hasOverview;
+  },
+  {
+    message: 'dashboardModules must include an overview module (id="overview" or path="/dashboard")',
+    path: ["dashboardModules"]
+  }
+);
+function validateDashboardSchema(schema) {
+  const errors = [];
+  const warnings = [];
+  if (!schema || typeof schema !== "object") {
+    return {
+      valid: false,
+      errors: [{ path: "", message: "Schema must be a non-null object" }],
+      warnings: []
+    };
+  }
+  const result = dashboardSchemaValidator.safeParse(schema);
+  if (!result.success) {
+    for (const issue of result.error.issues) {
+      errors.push({
+        path: issue.path.join("."),
+        message: issue.message
+      });
+    }
+  }
+  const s = schema;
+  if (!s.contentTypes || Object.keys(s.contentTypes).length === 0) {
+    warnings.push(
+      "No contentTypes defined \u2014 content management modules will be empty"
+    );
+  }
+  if (!s.siteSettings || Object.keys(s.siteSettings).length === 0) {
+    warnings.push(
+      "No siteSettings defined \u2014 settings pages will have no configurable fields"
+    );
+  }
+  if (!s.behaviors || Array.isArray(s.behaviors) && s.behaviors.length === 0) {
+    warnings.push(
+      "No behaviors defined \u2014 behavior-gated features (inventory, bookings) may not appear"
+    );
+  }
+  const modules = s.dashboardModules || [];
+  const hasOrders = modules.some((m) => m.id === "orders");
+  if (!hasOrders) {
+    warnings.push(
+      "No orders module in dashboardModules \u2014 orders will only appear via platform injection"
+    );
+  }
+  return {
+    valid: errors.length === 0,
+    errors,
+    warnings
+  };
+}
+function validateTemplateConfig(apiTemplate) {
+  const schemaSubset = {
+    contentTypes: apiTemplate.contentTypes,
+    behaviors: apiTemplate.behaviors,
+    siteSettings: apiTemplate.siteSettings,
+    pageContent: apiTemplate.pageContent,
+    dashboardModules: apiTemplate.dashboardModules
+  };
+  return validateDashboardSchema(schemaSubset);
+}
+export {
+  dashboardSchemaValidator,
+  validateDashboardSchema,
+  validateTemplateConfig
+};
+//# sourceMappingURL=schema-validation.js.map

package/dist/schema-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema-validation.ts"],"sourcesContent":["/**\n * Dashboard Schema Validation\n *\n * Zod-based validation for dashboard-schema.json files.\n * Validates the structural integrity of template configurations\n * to prevent silent rendering failures and inaccessible platform modules.\n *\n * Used at:\n * - Template load time (in template-context.tsx)\n * - Build/CI time (can be imported by validation scripts)\n */\n\nimport { z } from 'zod';\n\n// ============================================\n// Field-level schemas\n// ============================================\n\nconst fieldTypeSchema = z.enum([\n  'text',\n  'textarea',\n  'richtext',\n  'number',\n  'currency',\n  'boolean',\n  'toggle',\n  'image',\n  'gallery',\n  'select',\n  'categorySelect',\n  'resourceSelect',\n  'contentSelect',\n  'multiselect',\n  'tags',\n  'date',\n  'datetime',\n  'time',\n  'duration',\n  'url',\n  'email',\n  'phone',\n  'color',\n  'icon',\n  'array',\n  'json',\n  'relation',\n  'component',\n  'repeatable',\n]);\n\nconst selectOptionSchema = z.object({\n  label: z.string(),\n  value: z.string(),\n  icon: z.string().optional(),\n  color: z.string().optional(),\n});\n\nconst validationRuleSchema = z.object({\n  type: z.enum([\n    'required',\n    'min',\n    'max',\n    'minLength',\n    'maxLength',\n    'pattern',\n    'custom',\n  ]),\n  value: z.union([z.number(), z.string()]).optional(),\n  message: z.string().optional(),\n});\n\nconst contentFieldSchema: z.ZodType<Record<string, unknown>> = z.lazy(() =>\n  z\n    .object({\n      name: z.string().min(1, 'Field name is required'),\n      label: z.string().min(1, 'Field label is required'),\n      type: fieldTypeSchema,\n      description: z.string().optional(),\n      placeholder: z.string().optional(),\n      required: z.boolean().optional(),\n      validations: z.array(validationRuleSchema).optional(),\n      options: z.array(selectOptionSchema).optional(),\n      min: z.number().optional(),\n      max: z.number().optional(),\n      step: z.number().optional(),\n      prefix: z.string().optional(),\n      suffix: z.string().optional(),\n      showIf: z\n        .object({\n          field: z.string(),\n          equals: z.unknown().optional(),\n          notEquals: z.unknown().optional(),\n          in: z.array(z.unknown()).optional(),\n        })\n        .optional(),\n      width: z.enum(['full', 'half', 'third']).optional(),\n      group: z.string().optional(),\n      relation: z\n        .object({\n          endpoint: z.string(),\n          displayField: z.string(),\n          multiple: z.boolean().optional(),\n        })\n        .optional(),\n      fields: z.array(z.lazy(() => contentFieldSchema)).optional(),\n      maxItems: z.number().optional(),\n      minItems: z.number().optional(),\n      defaultValue: z.unknown().optional(),\n      // Allow additional properties for template-specific extensions\n      categoryKey: z.string().optional(),\n    })\n    .passthrough(),\n);\n\nconst fieldGroupSchema = z.object({\n  name: z.string().min(1),\n  label: z.string(),\n  description: z.string().optional(),\n  collapsed: z.boolean().optional(),\n  fields: z.array(z.string()),\n});\n\n// ============================================\n// Content type schema\n// ============================================\n\nconst contentBehaviorSchema = z.enum([\n  'sellable',\n  'bookable',\n  'giftable',\n  'subscribable',\n  'leadCapture',\n  'downloadable',\n  'shippable',\n  'rentable',\n  'ticketed',\n  'billable',\n  'publishable',\n  'showcase',\n]);\n\nconst contentTypeSchema = z\n  .object({\n    name: z.string().min(1, 'Content type name is required'),\n    singularName: z.string().optional(),\n    description: z.string().optional(),\n    icon: z.string().optional(),\n    apiEndpoint: z.string().min(1, 'API endpoint is required'),\n    contentTypeKey: z.string().optional(),\n    behaviors: z.array(contentBehaviorSchema).optional(),\n    bookingModel: z.enum(['time-slot', 'date-range']).optional(),\n    excludeGroups: z.array(z.string()).optional(),\n    fields: z\n      .array(contentFieldSchema)\n      .min(1, 'Content type must have at least one field'),\n    fieldGroups: z.array(fieldGroupSchema).optional(),\n    listFields: z.array(z.string()).optional(),\n    searchFields: z.array(z.string()).optional(),\n    listView: z.record(z.string(), z.unknown()).optional(), // ListViewConfig is complex, validate structurally\n    defaultSort: z\n      .object({\n        field: z.string(),\n        direction: z.enum(['asc', 'desc']),\n      })\n      .optional(),\n  })\n  .passthrough();\n\n// ============================================\n// Dashboard module schema\n// ============================================\n\nconst dashboardModuleSchema = z\n  .object({\n    id: z.string().min(1, 'Module ID is required'),\n    // Support both old (title) and new (label) formats\n    label: z.string().optional(),\n    title: z.string().optional(),\n    name: z.string().optional(),\n    // Support both old (/admin/*) and new (/dashboard/*) path formats\n    path: z.string().min(1, 'Module path is required'),\n    icon: z.string().optional(),\n    description: z.string().optional(),\n    badge: z.string().optional(),\n    contentType: z.string().optional(),\n    enabled: z.boolean().optional(), // old format\n  })\n  .refine((mod) => mod.label || mod.title || mod.name, {\n    message: 'Module must have at least one of: label, title, or name',\n  });\n\n// ============================================\n// Site settings schema\n// ============================================\n\nconst settingsFieldSchema = z\n  .object({\n    name: z.string().min(1),\n    label: z.string().min(1),\n    type: fieldTypeSchema,\n    description: z.string().optional(),\n    placeholder: z.string().optional(),\n    required: z.boolean().optional(),\n    default: z.unknown().optional(),\n    options: z.array(selectOptionSchema).optional(),\n  })\n  .passthrough();\n\nconst settingsSectionSchema = z\n  .object({\n    label: z.string().optional(),\n    title: z.string().optional(), // old format\n    description: z.string().optional(),\n    fields: z\n      .union([\n        z.array(settingsFieldSchema),\n        z.record(z.string(), z.unknown()), // object-keyed fields (old format)\n      ])\n      .optional(),\n  })\n  .passthrough(); // Allow categoryManager and other custom section types\n\nconst siteSettingsSchema = z.record(z.string(), settingsSectionSchema);\n\n// ============================================\n// Page content schema\n// ============================================\n\nconst pageContentSchema = z.record(z.string(), z.unknown()).optional();\n\n// ============================================\n// Full dashboard-schema.json validation\n// ============================================\n\n/**\n * The complete Zod schema for dashboard-schema.json files.\n *\n * Required structure:\n * - dashboardModules: array with ≥1 entry (must include overview)\n * - Either contentTypes OR behaviors must be present (new-format schemas)\n * - siteSettings: at least 1 section with fields\n *\n * Old-format schemas (serenity-spa, noteable) won't have contentTypes,\n * but are still valid if they have dashboardModules + siteSettings.\n */\nexport const dashboardSchemaValidator = z\n  .object({\n    contentTypes: z.record(z.string(), contentTypeSchema).optional(),\n    behaviors: z.array(contentBehaviorSchema).optional(),\n    siteSettings: siteSettingsSchema.optional(),\n    pageContent: pageContentSchema,\n    dashboardModules: z\n      .array(dashboardModuleSchema)\n      .min(1, 'At least one dashboard module is required'),\n  })\n  .refine(\n    (schema) => {\n      // Must have at least dashboardModules with an overview or equivalent\n      const modules = schema.dashboardModules || [];\n      const hasOverview = modules.some(\n        (m) =>\n          m.id === 'overview' ||\n          m.path === '/dashboard' ||\n          m.path === '/admin' ||\n          m.path === '/overview',\n      );\n      return hasOverview;\n    },\n    {\n      message:\n        'dashboardModules must include an overview module (id=\"overview\" or path=\"/dashboard\")',\n      path: ['dashboardModules'],\n    },\n  );\n\n// ============================================\n// Validation types and helpers\n// ============================================\n\nexport interface SchemaValidationError {\n  path: string;\n  message: string;\n}\n\nexport interface SchemaValidationResult {\n  valid: boolean;\n  errors: SchemaValidationError[];\n  warnings: string[];\n}\n\n/**\n * Validate a dashboard-schema.json object using the Zod schema.\n *\n * Returns structured errors (blocking) and warnings (non-blocking).\n * - Errors: schema is structurally invalid and will cause rendering failures\n * - Warnings: schema is valid but missing recommended sections\n */\nexport function validateDashboardSchema(\n  schema: unknown,\n): SchemaValidationResult {\n  const errors: SchemaValidationError[] = [];\n  const warnings: string[] = [];\n\n  // Basic type check\n  if (!schema || typeof schema !== 'object') {\n    return {\n      valid: false,\n      errors: [{ path: '', message: 'Schema must be a non-null object' }],\n      warnings: [],\n    };\n  }\n\n  // Run Zod validation\n  const result = dashboardSchemaValidator.safeParse(schema);\n  if (!result.success) {\n    for (const issue of result.error.issues) {\n      errors.push({\n        path: issue.path.join('.'),\n        message: issue.message,\n      });\n    }\n  }\n\n  // Additional warnings (non-blocking recommendations)\n  const s = schema as Record<string, unknown>;\n\n  if (!s.contentTypes || Object.keys(s.contentTypes as object).length === 0) {\n    warnings.push(\n      'No contentTypes defined — content management modules will be empty',\n    );\n  }\n\n  if (!s.siteSettings || Object.keys(s.siteSettings as object).length === 0) {\n    warnings.push(\n      'No siteSettings defined — settings pages will have no configurable fields',\n    );\n  }\n\n  if (\n    !s.behaviors ||\n    (Array.isArray(s.behaviors) && s.behaviors.length === 0)\n  ) {\n    warnings.push(\n      'No behaviors defined — behavior-gated features (inventory, bookings) may not appear',\n    );\n  }\n\n  const modules = (s.dashboardModules || []) as Array<Record<string, unknown>>;\n  const hasOrders = modules.some((m) => m.id === 'orders');\n  if (!hasOrders) {\n    warnings.push(\n      'No orders module in dashboardModules — orders will only appear via platform injection',\n    );\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  };\n}\n\n/**\n * Validate a template API response (TemplateConfigAPI) structure.\n *\n * This is used at runtime when the dashboard fetches a template schema.\n * It replaces the ad-hoc validateTemplateSchema in template-context.tsx\n * with proper Zod-based validation.\n */\nexport function validateTemplateConfig(\n  apiTemplate: Record<string, unknown>,\n): SchemaValidationResult {\n  // The API template has additional fields (id, name, category, etc.)\n  // We only validate the dashboard-schema portion\n  const schemaSubset = {\n    contentTypes: apiTemplate.contentTypes,\n    behaviors: apiTemplate.behaviors,\n    siteSettings: apiTemplate.siteSettings,\n    pageContent: apiTemplate.pageContent,\n    dashboardModules: apiTemplate.dashboardModules,\n  };\n\n  return validateDashboardSchema(schemaSubset);\n}\n"],"mappings":"AAYA,SAAS,SAAS;AAMlB,MAAM,kBAAkB,EAAE,KAAK;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,MAAM,qBAAqB,EAAE,OAAO;AAAA,EAClC,OAAO,EAAE,OAAO;AAAA,EAChB,OAAO,EAAE,OAAO;AAAA,EAChB,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,OAAO,EAAE,OAAO,EAAE,SAAS;AAC7B,CAAC;AAED,MAAM,uBAAuB,EAAE,OAAO;AAAA,EACpC,MAAM,EAAE,KAAK;AAAA,IACX;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAAA,EACD,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,SAAS;AAAA,EAClD,SAAS,EAAE,OAAO,EAAE,SAAS;AAC/B,CAAC;AAED,MAAM,qBAAyD,EAAE;AAAA,EAAK,MACpE,EACG,OAAO;AAAA,IACN,MAAM,EAAE,OAAO,EAAE,IAAI,GAAG,wBAAwB;AAAA,IAChD,OAAO,EAAE,OAAO,EAAE,IAAI,GAAG,yBAAyB;AAAA,IAClD,MAAM;AAAA,IACN,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,IACjC,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,IACjC,UAAU,EAAE,QAAQ,EAAE,SAAS;AAAA,IAC/B,aAAa,EAAE,MAAM,oBAAoB,EAAE,SAAS;AAAA,IACpD,SAAS,EAAE,MAAM,kBAAkB,EAAE,SAAS;AAAA,IAC9C,KAAK,EAAE,OAAO,EAAE,SAAS;AAAA,IACzB,KAAK,EAAE,OAAO,EAAE,SAAS;AAAA,IACzB,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,IAC1B,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,IAC5B,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,IAC5B,QAAQ,EACL,OAAO;AAAA,MACN,OAAO,EAAE,OAAO;AAAA,MAChB,QAAQ,EAAE,QAAQ,EAAE,SAAS;AAAA,MAC7B,WAAW,EAAE,QAAQ,EAAE,SAAS;AAAA,MAChC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS;AAAA,IACpC,CAAC,EACA,SAAS;AAAA,IACZ,OAAO,EAAE,KAAK,CAAC,QAAQ,QAAQ,OAAO,CAAC,EAAE,SAAS;AAAA,IAClD,OAAO,EAAE,OAAO,EAAE,SAAS;AAAA,IAC3B,UAAU,EACP,OAAO;AAAA,MACN,UAAU,EAAE,OAAO;AAAA,MACnB,cAAc,EAAE,OAAO;AAAA,MACvB,UAAU,EAAE,QAAQ,EAAE,SAAS;AAAA,IACjC,CAAC,EACA,SAAS;AAAA,IACZ,QAAQ,EAAE,MAAM,EAAE,KAAK,MAAM,kBAAkB,CAAC,EAAE,SAAS;AAAA,IAC3D,UAAU,EAAE,OAAO,EAAE,SAAS;AAAA,IAC9B,UAAU,EAAE,OAAO,EAAE,SAAS;AAAA,IAC9B,cAAc,EAAE,QAAQ,EAAE,SAAS;AAAA;AAAA,IAEnC,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACnC,CAAC,EACA,YAAY;AACjB;AAEA,MAAM,mBAAmB,EAAE,OAAO;AAAA,EAChC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACtB,OAAO,EAAE,OAAO;AAAA,EAChB,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACjC,WAAW,EAAE,QAAQ,EAAE,SAAS;AAAA,EAChC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC;AAC5B,CAAC;AAMD,MAAM,wBAAwB,EAAE,KAAK;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,MAAM,oBAAoB,EACvB,OAAO;AAAA,EACN,MAAM,EAAE,OAAO,EAAE,IAAI,GAAG,+BAA+B;AAAA,EACvD,cAAc,EAAE,OAAO,EAAE,SAAS;AAAA,EAClC,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACjC,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,aAAa,EAAE,OAAO,EAAE,IAAI,GAAG,0BAA0B;AAAA,EACzD,gBAAgB,EAAE,OAAO,EAAE,SAAS;AAAA,EACpC,WAAW,EAAE,MAAM,qBAAqB,EAAE,SAAS;AAAA,EACnD,cAAc,EAAE,KAAK,CAAC,aAAa,YAAY,CAAC,EAAE,SAAS;AAAA,EAC3D,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EAC5C,QAAQ,EACL,MAAM,kBAAkB,EACxB,IAAI,GAAG,2CAA2C;AAAA,EACrD,aAAa,EAAE,MAAM,gBAAgB,EAAE,SAAS;AAAA,EAChD,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EACzC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EAC3C,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,EAAE,SAAS;AAAA;AAAA,EACrD,aAAa,EACV,OAAO;AAAA,IACN,OAAO,EAAE,OAAO;AAAA,IAChB,WAAW,EAAE,KAAK,CAAC,OAAO,MAAM,CAAC;AAAA,EACnC,CAAC,EACA,SAAS;AACd,CAAC,EACA,YAAY;AAMf,MAAM,wBAAwB,EAC3B,OAAO;AAAA,EACN,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,uBAAuB;AAAA;AAAA,EAE7C,OAAO,EAAE,OAAO,EAAE,SAAS;AAAA,EAC3B,OAAO,EAAE,OAAO,EAAE,SAAS;AAAA,EAC3B,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA;AAAA,EAE1B,MAAM,EAAE,OAAO,EAAE,IAAI,GAAG,yBAAyB;AAAA,EACjD,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACjC,OAAO,EAAE,OAAO,EAAE,SAAS;AAAA,EAC3B,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACjC,SAAS,EAAE,QAAQ,EAAE,SAAS;AAAA;AAChC,CAAC,EACA,OAAO,CAAC,QAAQ,IAAI,SAAS,IAAI,SAAS,IAAI,MAAM;AAAA,EACnD,SAAS;AACX,CAAC;AAMH,MAAM,sBAAsB,EACzB,OAAO;AAAA,EACN,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACtB,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACvB,MAAM;AAAA,EACN,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACjC,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACjC,UAAU,EAAE,QAAQ,EAAE,SAAS;AAAA,EAC/B,SAAS,EAAE,QAAQ,EAAE,SAAS;AAAA,EAC9B,SAAS,EAAE,MAAM,kBAAkB,EAAE,SAAS;AAChD,CAAC,EACA,YAAY;AAEf,MAAM,wBAAwB,EAC3B,OAAO;AAAA,EACN,OAAO,EAAE,OAAO,EAAE,SAAS;AAAA,EAC3B,OAAO,EAAE,OAAO,EAAE,SAAS;AAAA;AAAA,EAC3B,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACjC,QAAQ,EACL,MAAM;AAAA,IACL,EAAE,MAAM,mBAAmB;AAAA,IAC3B,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC;AAAA;AAAA,EAClC,CAAC,EACA,SAAS;AACd,CAAC,EACA,YAAY;AAEf,MAAM,qBAAqB,EAAE,OAAO,EAAE,OAAO,GAAG,qBAAqB;AAMrE,MAAM,oBAAoB,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,EAAE,SAAS;AAiB9D,MAAM,2BAA2B,EACrC,OAAO;AAAA,EACN,cAAc,EAAE,OAAO,EAAE,OAAO,GAAG,iBAAiB,EAAE,SAAS;AAAA,EAC/D,WAAW,EAAE,MAAM,qBAAqB,EAAE,SAAS;AAAA,EACnD,cAAc,mBAAmB,SAAS;AAAA,EAC1C,aAAa;AAAA,EACb,kBAAkB,EACf,MAAM,qBAAqB,EAC3B,IAAI,GAAG,2CAA2C;AACvD,CAAC,EACA;AAAA,EACC,CAAC,WAAW;AAEV,UAAM,UAAU,OAAO,oBAAoB,CAAC;AAC5C,UAAM,cAAc,QAAQ;AAAA,MAC1B,CAAC,MACC,EAAE,OAAO,cACT,EAAE,SAAS,gBACX,EAAE,SAAS,YACX,EAAE,SAAS;AAAA,IACf;AACA,WAAO;AAAA,EACT;AAAA,EACA;AAAA,IACE,SACE;AAAA,IACF,MAAM,CAAC,kBAAkB;AAAA,EAC3B;AACF;AAwBK,SAAS,wBACd,QACwB;AACxB,QAAM,SAAkC,CAAC;AACzC,QAAM,WAAqB,CAAC;AAG5B,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,WAAO;AAAA,MACL,OAAO;AAAA,MACP,QAAQ,CAAC,EAAE,MAAM,IAAI,SAAS,mCAAmC,CAAC;AAAA,MAClE,UAAU,CAAC;AAAA,IACb;AAAA,EACF;AAGA,QAAM,SAAS,yBAAyB,UAAU,MAAM;AACxD,MAAI,CAAC,OAAO,SAAS;AACnB,eAAW,SAAS,OAAO,MAAM,QAAQ;AACvC,aAAO,KAAK;AAAA,QACV,MAAM,MAAM,KAAK,KAAK,GAAG;AAAA,QACzB,SAAS,MAAM;AAAA,MACjB,CAAC;AAAA,IACH;AAAA,EACF;AAGA,QAAM,IAAI;AAEV,MAAI,CAAC,EAAE,gBAAgB,OAAO,KAAK,EAAE,YAAsB,EAAE,WAAW,GAAG;AACzE,aAAS;AAAA,MACP;AAAA,IACF;AAAA,EACF;AAEA,MAAI,CAAC,EAAE,gBAAgB,OAAO,KAAK,EAAE,YAAsB,EAAE,WAAW,GAAG;AACzE,aAAS;AAAA,MACP;AAAA,IACF;AAAA,EACF;AAEA,MACE,CAAC,EAAE,aACF,MAAM,QAAQ,EAAE,SAAS,KAAK,EAAE,UAAU,WAAW,GACtD;AACA,aAAS;AAAA,MACP;AAAA,IACF;AAAA,EACF;AAEA,QAAM,UAAW,EAAE,oBAAoB,CAAC;AACxC,QAAM,YAAY,QAAQ,KAAK,CAAC,MAAM,EAAE,OAAO,QAAQ;AACvD,MAAI,CAAC,WAAW;AACd,aAAS;AAAA,MACP;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,OAAO,WAAW;AAAA,IACzB;AAAA,IACA;AAAA,EACF;AACF;AASO,SAAS,uBACd,aACwB;AAGxB,QAAM,eAAe;AAAA,IACnB,cAAc,YAAY;AAAA,IAC1B,WAAW,YAAY;AAAA,IACvB,cAAc,YAAY;AAAA,IAC1B,aAAa,YAAY;AAAA,IACzB,kBAAkB,YAAY;AAAA,EAChC;AAEA,SAAO,wBAAwB,YAAY;AAC7C;","names":[]}

package/dist/service-areas.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Service areas: the places a business will actually go.
+ *
+ * A row in `location_catalog` must carry a country, a state and a city, so
+ * "everywhere in Lagos" had nowhere to live. The only way to cover a state was
+ * to add every city in it from the geo list — dozens of rows to manage, and
+ * silent about any city that list has never heard of. Since potter-api now
+ * refuses an order outside these areas, a city the list missed is a real order
+ * turned away.
+ *
+ * A wildcard city stands for the whole state, and a wildcard state for the
+ * whole country. Kept in step with `check-service-area.usecase.ts`, which
+ * accepts the same set on the way in.
+ */
+export declare const SERVICE_AREA_WILDCARD = "*";
+export declare function isServiceAreaWildcard(value?: string | null): boolean;
+export interface ServiceAreaLike {
+    city: string;
+    state: string;
+    country: string;
+}
+/**
+ * What to call a row on screen.
+ *
+ * Never the asterisk. A merchant wrote "everywhere in Lagos" and should read it
+ * back in those words, not in the symbol the database happens to store.
+ */
+export declare function serviceAreaLabel(area: ServiceAreaLike): string;
+/** The line under the label: where this sits, without repeating it. */
+export declare function serviceAreaContext(area: ServiceAreaLike): string;

package/dist/service-areas.js

@@ -0,0 +1,24 @@
+const SERVICE_AREA_WILDCARD = "*";
+const WILDCARDS = /* @__PURE__ */ new Set(["*", "all", "any", "anywhere", "everywhere"]);
+function isServiceAreaWildcard(value) {
+  return WILDCARDS.has((value ?? "").trim().toLowerCase());
+}
+function serviceAreaLabel(area) {
+  if (isServiceAreaWildcard(area.city)) {
+    return isServiceAreaWildcard(area.state) ? `Everywhere in ${area.country}` : `Everywhere in ${area.state}`;
+  }
+  return area.city;
+}
+function serviceAreaContext(area) {
+  if (isServiceAreaWildcard(area.city)) {
+    return isServiceAreaWildcard(area.state) ? "" : area.country;
+  }
+  return [area.state, area.country].filter(Boolean).join(", ");
+}
+export {
+  SERVICE_AREA_WILDCARD,
+  isServiceAreaWildcard,
+  serviceAreaContext,
+  serviceAreaLabel
+};
+//# sourceMappingURL=service-areas.js.map

package/dist/service-areas.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/service-areas.ts"],"sourcesContent":["/**\n * Service areas: the places a business will actually go.\n *\n * A row in `location_catalog` must carry a country, a state and a city, so\n * \"everywhere in Lagos\" had nowhere to live. The only way to cover a state was\n * to add every city in it from the geo list — dozens of rows to manage, and\n * silent about any city that list has never heard of. Since potter-api now\n * refuses an order outside these areas, a city the list missed is a real order\n * turned away.\n *\n * A wildcard city stands for the whole state, and a wildcard state for the\n * whole country. Kept in step with `check-service-area.usecase.ts`, which\n * accepts the same set on the way in.\n */\nexport const SERVICE_AREA_WILDCARD = '*';\n\nconst WILDCARDS = new Set(['*', 'all', 'any', 'anywhere', 'everywhere']);\n\nexport function isServiceAreaWildcard(value?: string | null): boolean {\n  return WILDCARDS.has((value ?? '').trim().toLowerCase());\n}\n\nexport interface ServiceAreaLike {\n  city: string;\n  state: string;\n  country: string;\n}\n\n/**\n * What to call a row on screen.\n *\n * Never the asterisk. A merchant wrote \"everywhere in Lagos\" and should read it\n * back in those words, not in the symbol the database happens to store.\n */\nexport function serviceAreaLabel(area: ServiceAreaLike): string {\n  if (isServiceAreaWildcard(area.city)) {\n    return isServiceAreaWildcard(area.state)\n      ? `Everywhere in ${area.country}`\n      : `Everywhere in ${area.state}`;\n  }\n  return area.city;\n}\n\n/** The line under the label: where this sits, without repeating it. */\nexport function serviceAreaContext(area: ServiceAreaLike): string {\n  if (isServiceAreaWildcard(area.city)) {\n    return isServiceAreaWildcard(area.state) ? '' : area.country;\n  }\n  return [area.state, area.country].filter(Boolean).join(', ');\n}\n"],"mappings":"AAcO,MAAM,wBAAwB;AAErC,MAAM,YAAY,oBAAI,IAAI,CAAC,KAAK,OAAO,OAAO,YAAY,YAAY,CAAC;AAEhE,SAAS,sBAAsB,OAAgC;AACpE,SAAO,UAAU,KAAK,SAAS,IAAI,KAAK,EAAE,YAAY,CAAC;AACzD;AAcO,SAAS,iBAAiB,MAA+B;AAC9D,MAAI,sBAAsB,KAAK,IAAI,GAAG;AACpC,WAAO,sBAAsB,KAAK,KAAK,IACnC,iBAAiB,KAAK,OAAO,KAC7B,iBAAiB,KAAK,KAAK;AAAA,EACjC;AACA,SAAO,KAAK;AACd;AAGO,SAAS,mBAAmB,MAA+B;AAChE,MAAI,sBAAsB,KAAK,IAAI,GAAG;AACpC,WAAO,sBAAsB,KAAK,KAAK,IAAI,KAAK,KAAK;AAAA,EACvD;AACA,SAAO,CAAC,KAAK,OAAO,KAAK,OAAO,EAAE,OAAO,OAAO,EAAE,KAAK,IAAI;AAC7D;","names":[]}

package/dist/service-operations-api.d.ts

@@ -0,0 +1,78 @@
+export type ServiceCaseStatus = 'open' | 'waiting_on_potter' | 'waiting_on_tenant' | 'waiting_on_customer' | 'resolved' | 'closed';
+export type ServiceCaseCategory = 'account_access' | 'billing' | 'technical' | 'feature_request' | 'order_issue' | 'booking_issue' | 'delivery_issue' | 'refund_request' | 'product_question' | 'general';
+export interface ServiceCaseAttachment {
+    url: string;
+    name: string;
+    mimeType: string;
+    size: number;
+}
+export interface ServiceCaseMessage {
+    id: string;
+    authorType: 'merchant' | 'platform_admin' | 'system';
+    authorId: string | null;
+    visibility: 'participants';
+    body: string;
+    attachments: ServiceCaseAttachment[];
+    createdAt: string;
+}
+export interface ServiceCase {
+    id: string;
+    reference: string;
+    type: 'potter_support';
+    tenantId: string;
+    reporterName: string;
+    reporterEmail: string;
+    subject: string;
+    description: string;
+    category: ServiceCaseCategory;
+    priority: 'low' | 'normal' | 'high' | 'urgent';
+    status: ServiceCaseStatus;
+    firstResponseDueAt: string | null;
+    resolutionDueAt: string | null;
+    firstRespondedAt: string | null;
+    resolvedAt: string | null;
+    closedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    messages?: ServiceCaseMessage[];
+}
+export interface ServiceCasePage {
+    items: ServiceCase[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+export interface CreateServiceCaseInput {
+    subject: string;
+    message: string;
+    /**
+     * Optional, and the merchant is never asked for one. Ten categories above a
+     * message box hands our triage to the person with the problem; a case lands
+     * as `general` and is re-filed from the sentence it was written in.
+     */
+    category?: ServiceCaseCategory;
+    /** A voice note, a screenshot, or both, on the case's first message. */
+    attachments?: ServiceCaseAttachment[];
+}
+/**
+ * ON UNLESS TURNED OFF, and the inversion is deliberate.
+ *
+ * This read `=== '1'`, which is the right shape for a feature being rolled out
+ * and the wrong one for a feature that is finished: `/dashboard/support`
+ * answers 404 until somebody remembers an environment variable, and a merchant
+ * who followed a notification into a case would land on "page not found"
+ * rather than on their case. Off is still one variable away —
+ * `NEXT_PUBLIC_SERVICE_OPERATIONS_ENABLED=0` — and it must match the api's
+ * `SERVICE_OPERATIONS_ENABLED`, which defaults the same way.
+ */
+export declare function isServiceOperationsEnabled(): boolean;
+export declare const serviceOperationsApi: {
+    list(tenantSlug: string, params?: {
+        status?: ServiceCaseStatus;
+        search?: string;
+        page?: number;
+    }): Promise<ServiceCasePage>;
+    get(tenantSlug: string, caseId: string): Promise<ServiceCase>;
+    create(tenantSlug: string, input: CreateServiceCaseInput): Promise<ServiceCase>;
+    reply(tenantSlug: string, caseId: string, message: string, attachments?: ServiceCaseAttachment[]): Promise<ServiceCase>;
+};

package/dist/service-operations-api.js

@@ -0,0 +1,37 @@
+import { apiFetch } from "./api";
+function isServiceOperationsEnabled() {
+  return process.env.NEXT_PUBLIC_SERVICE_OPERATIONS_ENABLED !== "0";
+}
+const basePath = "/service-operations/support-cases";
+const serviceOperationsApi = {
+  list(tenantSlug, params = {}) {
+    const query = new URLSearchParams();
+    if (params.status) query.set("status", params.status);
+    if (params.search) query.set("search", params.search);
+    if (params.page) query.set("page", String(params.page));
+    const suffix = query.size ? `?${query.toString()}` : "";
+    return apiFetch(`${basePath}${suffix}`, { tenantSlug });
+  },
+  get(tenantSlug, caseId) {
+    return apiFetch(`${basePath}/${caseId}`, { tenantSlug });
+  },
+  create(tenantSlug, input) {
+    return apiFetch(basePath, {
+      method: "POST",
+      tenantSlug,
+      body: JSON.stringify(input)
+    });
+  },
+  reply(tenantSlug, caseId, message, attachments) {
+    return apiFetch(`${basePath}/${caseId}/messages`, {
+      method: "POST",
+      tenantSlug,
+      body: JSON.stringify({ message, attachments })
+    });
+  }
+};
+export {
+  isServiceOperationsEnabled,
+  serviceOperationsApi
+};
+//# sourceMappingURL=service-operations-api.js.map

package/dist/service-operations-api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/service-operations-api.ts"],"sourcesContent":["import { apiFetch } from './api';\n\nexport type ServiceCaseStatus =\n  | 'open'\n  | 'waiting_on_potter'\n  | 'waiting_on_tenant'\n  | 'waiting_on_customer'\n  | 'resolved'\n  | 'closed';\n\nexport type ServiceCaseCategory =\n  | 'account_access'\n  | 'billing'\n  | 'technical'\n  | 'feature_request'\n  | 'order_issue'\n  | 'booking_issue'\n  | 'delivery_issue'\n  | 'refund_request'\n  | 'product_question'\n  | 'general';\n\nexport interface ServiceCaseAttachment {\n  url: string;\n  name: string;\n  mimeType: string;\n  size: number;\n}\n\nexport interface ServiceCaseMessage {\n  id: string;\n  authorType: 'merchant' | 'platform_admin' | 'system';\n  authorId: string | null;\n  visibility: 'participants';\n  body: string;\n  attachments: ServiceCaseAttachment[];\n  createdAt: string;\n}\n\nexport interface ServiceCase {\n  id: string;\n  reference: string;\n  type: 'potter_support';\n  tenantId: string;\n  reporterName: string;\n  reporterEmail: string;\n  subject: string;\n  description: string;\n  category: ServiceCaseCategory;\n  priority: 'low' | 'normal' | 'high' | 'urgent';\n  status: ServiceCaseStatus;\n  firstResponseDueAt: string | null;\n  resolutionDueAt: string | null;\n  firstRespondedAt: string | null;\n  resolvedAt: string | null;\n  closedAt: string | null;\n  createdAt: string;\n  updatedAt: string;\n  messages?: ServiceCaseMessage[];\n}\n\nexport interface ServiceCasePage {\n  items: ServiceCase[];\n  total: number;\n  page: number;\n  pageSize: number;\n}\n\nexport interface CreateServiceCaseInput {\n  subject: string;\n  message: string;\n  /**\n   * Optional, and the merchant is never asked for one. Ten categories above a\n   * message box hands our triage to the person with the problem; a case lands\n   * as `general` and is re-filed from the sentence it was written in.\n   */\n  category?: ServiceCaseCategory;\n  /** A voice note, a screenshot, or both, on the case's first message. */\n  attachments?: ServiceCaseAttachment[];\n}\n\n/**\n * ON UNLESS TURNED OFF, and the inversion is deliberate.\n *\n * This read `=== '1'`, which is the right shape for a feature being rolled out\n * and the wrong one for a feature that is finished: `/dashboard/support`\n * answers 404 until somebody remembers an environment variable, and a merchant\n * who followed a notification into a case would land on \"page not found\"\n * rather than on their case. Off is still one variable away —\n * `NEXT_PUBLIC_SERVICE_OPERATIONS_ENABLED=0` — and it must match the api's\n * `SERVICE_OPERATIONS_ENABLED`, which defaults the same way.\n */\nexport function isServiceOperationsEnabled() {\n  return process.env.NEXT_PUBLIC_SERVICE_OPERATIONS_ENABLED !== '0';\n}\n\nconst basePath = '/service-operations/support-cases';\n\nexport const serviceOperationsApi = {\n  list(\n    tenantSlug: string,\n    params: { status?: ServiceCaseStatus; search?: string; page?: number } = {},\n  ) {\n    const query = new URLSearchParams();\n    if (params.status) query.set('status', params.status);\n    if (params.search) query.set('search', params.search);\n    if (params.page) query.set('page', String(params.page));\n    const suffix = query.size ? `?${query.toString()}` : '';\n    return apiFetch<ServiceCasePage>(`${basePath}${suffix}`, { tenantSlug });\n  },\n\n  get(tenantSlug: string, caseId: string) {\n    return apiFetch<ServiceCase>(`${basePath}/${caseId}`, { tenantSlug });\n  },\n\n  create(tenantSlug: string, input: CreateServiceCaseInput) {\n    return apiFetch<ServiceCase>(basePath, {\n      method: 'POST',\n      tenantSlug,\n      body: JSON.stringify(input),\n    });\n  },\n\n  reply(\n    tenantSlug: string,\n    caseId: string,\n    message: string,\n    attachments?: ServiceCaseAttachment[],\n  ) {\n    return apiFetch<ServiceCase>(`${basePath}/${caseId}/messages`, {\n      method: 'POST',\n      tenantSlug,\n      body: JSON.stringify({ message, attachments }),\n    });\n  },\n};\n"],"mappings":"AAAA,SAAS,gBAAgB;AA4FlB,SAAS,6BAA6B;AAC3C,SAAO,QAAQ,IAAI,2CAA2C;AAChE;AAEA,MAAM,WAAW;AAEV,MAAM,uBAAuB;AAAA,EAClC,KACE,YACA,SAAyE,CAAC,GAC1E;AACA,UAAM,QAAQ,IAAI,gBAAgB;AAClC,QAAI,OAAO,OAAQ,OAAM,IAAI,UAAU,OAAO,MAAM;AACpD,QAAI,OAAO,OAAQ,OAAM,IAAI,UAAU,OAAO,MAAM;AACpD,QAAI,OAAO,KAAM,OAAM,IAAI,QAAQ,OAAO,OAAO,IAAI,CAAC;AACtD,UAAM,SAAS,MAAM,OAAO,IAAI,MAAM,SAAS,CAAC,KAAK;AACrD,WAAO,SAA0B,GAAG,QAAQ,GAAG,MAAM,IAAI,EAAE,WAAW,CAAC;AAAA,EACzE;AAAA,EAEA,IAAI,YAAoB,QAAgB;AACtC,WAAO,SAAsB,GAAG,QAAQ,IAAI,MAAM,IAAI,EAAE,WAAW,CAAC;AAAA,EACtE;AAAA,EAEA,OAAO,YAAoB,OAA+B;AACxD,WAAO,SAAsB,UAAU;AAAA,MACrC,QAAQ;AAAA,MACR;AAAA,MACA,MAAM,KAAK,UAAU,KAAK;AAAA,IAC5B,CAAC;AAAA,EACH;AAAA,EAEA,MACE,YACA,QACA,SACA,aACA;AACA,WAAO,SAAsB,GAAG,QAAQ,IAAI,MAAM,aAAa;AAAA,MAC7D,QAAQ;AAAA,MACR;AAAA,MACA,MAAM,KAAK,UAAU,EAAE,SAAS,YAAY,CAAC;AAAA,IAC/C,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/settings-relevance.d.ts

@@ -0,0 +1,64 @@
+import type { ContentBehavior } from '@withpotter/lib/template-types';
+/**
+ * Settings relevance — the ONE place that decides which settings a given
+ * business type sees, and the ONE function that evaluates it.
+ *
+ * The problem this solves: settings-nav gating used to be hand-rolled in every
+ * surface that renders it (the desktop rail, the hub tabs, the mobile hub), so
+ * the rules drifted — a business could get Shipping in one place and not in
+ * another. Every surface now imports {@link passesGate} / {@link isSettingRelevant}
+ * and the atomic rules live in {@link SETTINGS_RELEVANCE}.
+ *
+ * A settings surface is either **universal** (relevant to any business with a
+ * storefront) or **situational** (only meaningful for certain operating models).
+ * Only situational settings appear in the map below; anything absent is
+ * universal and always shown.
+ *
+ * Design rationale (senior commerce review, 2026-07):
+ * - Shipping   → only businesses that physically ship goods (`shippable`). A
+ *                service, bookings, digital, or subscription business never
+ *                ships, so the surface is pure noise for them.
+ * - Hours      → only businesses that run on a bookable schedule or a venue with
+ *                opening hours (`bookable`).
+ * - Locations  → any business with a physical footprint: a venue to book, or a
+ *                place goods ship from / are picked up (`bookable` OR `shippable`).
+ * - Operations → the desktop rail merges Hours + Locations into one entry, so it
+ *                inherits the union (`bookable` OR `shippable`).
+ *
+ * Deliberately NOT gated (universal), and why hiding them would be wrong:
+ * - Taxes, Checkout — every monetized storefront can owe tax and take payment;
+ *   you cannot infer "no tax / no checkout" from an operating model.
+ * - Policies, Domains, Notifications, Team, Billing, Features, Activity, General
+ *   — apply to any storefront regardless of what it sells.
+ */
+export type BehaviorGate = {
+    /** Show only when the business has ALL of these behaviors. */
+    requires?: ContentBehavior | ContentBehavior[];
+    /** Show when the business has AT LEAST ONE of these. */
+    requiresAny?: ContentBehavior[];
+};
+/** Canonical atomic rules, keyed by settings id. Unlisted ids are universal. */
+export declare const SETTINGS_RELEVANCE: Record<string, BehaviorGate>;
+/**
+ * The gate shape the evaluator accepts. Looser than {@link BehaviorGate} (plain
+ * `string`s) so callers whose items already declare `requires`/`requiresAny` as
+ * strings — the sidebar's `SettingsItem`, hub-tabs' `HubTab` — pass without a
+ * cast, while {@link SETTINGS_RELEVANCE} stays authored with typed behaviors.
+ */
+type LooseGate = {
+    requires?: string | readonly string[];
+    requiresAny?: readonly string[];
+};
+/**
+ * Does a business with `behaviors` pass this gate?
+ *
+ * Fail-open: when `behaviors` is null/undefined (operating model unknown) we
+ * return true. Showing a rarely-used setting beats hiding one a business needs.
+ */
+export declare function passesGate(gate: LooseGate, behaviors: readonly string[] | null | undefined): boolean;
+/**
+ * Is a settings surface relevant to a business with `behaviors`?
+ * `id` is the settings id (e.g. 'shipping'); unlisted ids are universal → true.
+ */
+export declare function isSettingRelevant(id: string, behaviors: readonly string[] | null | undefined): boolean;
+export {};

package/dist/settings-relevance.js

@@ -0,0 +1,25 @@
+const SETTINGS_RELEVANCE = {
+  shipping: { requires: "shippable" },
+  hours: { requires: "bookable" },
+  locations: { requiresAny: ["bookable", "shippable"] },
+  operations: { requiresAny: ["bookable", "shippable"] }
+};
+const asArray = (v) => v == null ? [] : Array.isArray(v) ? v : [v];
+function passesGate(gate, behaviors) {
+  if (!behaviors) return true;
+  const requiresAll = asArray(gate.requires).every(
+    (b) => behaviors.includes(b)
+  );
+  const requiresAny = !gate.requiresAny || gate.requiresAny.some((b) => behaviors.includes(b));
+  return requiresAll && requiresAny;
+}
+function isSettingRelevant(id, behaviors) {
+  const gate = SETTINGS_RELEVANCE[id];
+  return gate ? passesGate(gate, behaviors) : true;
+}
+export {
+  SETTINGS_RELEVANCE,
+  isSettingRelevant,
+  passesGate
+};
+//# sourceMappingURL=settings-relevance.js.map

package/dist/settings-relevance.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/settings-relevance.ts"],"sourcesContent":["import type { ContentBehavior } from '@withpotter/lib/template-types';\n\n/**\n * Settings relevance — the ONE place that decides which settings a given\n * business type sees, and the ONE function that evaluates it.\n *\n * The problem this solves: settings-nav gating used to be hand-rolled in every\n * surface that renders it (the desktop rail, the hub tabs, the mobile hub), so\n * the rules drifted — a business could get Shipping in one place and not in\n * another. Every surface now imports {@link passesGate} / {@link isSettingRelevant}\n * and the atomic rules live in {@link SETTINGS_RELEVANCE}.\n *\n * A settings surface is either **universal** (relevant to any business with a\n * storefront) or **situational** (only meaningful for certain operating models).\n * Only situational settings appear in the map below; anything absent is\n * universal and always shown.\n *\n * Design rationale (senior commerce review, 2026-07):\n * - Shipping   → only businesses that physically ship goods (`shippable`). A\n *                service, bookings, digital, or subscription business never\n *                ships, so the surface is pure noise for them.\n * - Hours      → only businesses that run on a bookable schedule or a venue with\n *                opening hours (`bookable`).\n * - Locations  → any business with a physical footprint: a venue to book, or a\n *                place goods ship from / are picked up (`bookable` OR `shippable`).\n * - Operations → the desktop rail merges Hours + Locations into one entry, so it\n *                inherits the union (`bookable` OR `shippable`).\n *\n * Deliberately NOT gated (universal), and why hiding them would be wrong:\n * - Taxes, Checkout — every monetized storefront can owe tax and take payment;\n *   you cannot infer \"no tax / no checkout\" from an operating model.\n * - Policies, Domains, Notifications, Team, Billing, Features, Activity, General\n *   — apply to any storefront regardless of what it sells.\n */\n\nexport type BehaviorGate = {\n  /** Show only when the business has ALL of these behaviors. */\n  requires?: ContentBehavior | ContentBehavior[];\n  /** Show when the business has AT LEAST ONE of these. */\n  requiresAny?: ContentBehavior[];\n};\n\n/** Canonical atomic rules, keyed by settings id. Unlisted ids are universal. */\nexport const SETTINGS_RELEVANCE: Record<string, BehaviorGate> = {\n  shipping: { requires: 'shippable' },\n  hours: { requires: 'bookable' },\n  locations: { requiresAny: ['bookable', 'shippable'] },\n  operations: { requiresAny: ['bookable', 'shippable'] },\n};\n\n/**\n * The gate shape the evaluator accepts. Looser than {@link BehaviorGate} (plain\n * `string`s) so callers whose items already declare `requires`/`requiresAny` as\n * strings — the sidebar's `SettingsItem`, hub-tabs' `HubTab` — pass without a\n * cast, while {@link SETTINGS_RELEVANCE} stays authored with typed behaviors.\n */\ntype LooseGate = {\n  requires?: string | readonly string[];\n  requiresAny?: readonly string[];\n};\n\nconst asArray = (\n  v: string | readonly string[] | undefined,\n): readonly string[] => (v == null ? [] : Array.isArray(v) ? v : [v as string]);\n\n/**\n * Does a business with `behaviors` pass this gate?\n *\n * Fail-open: when `behaviors` is null/undefined (operating model unknown) we\n * return true. Showing a rarely-used setting beats hiding one a business needs.\n */\nexport function passesGate(\n  gate: LooseGate,\n  behaviors: readonly string[] | null | undefined,\n): boolean {\n  if (!behaviors) return true;\n  const requiresAll = asArray(gate.requires).every((b) =>\n    behaviors.includes(b),\n  );\n  const requiresAny =\n    !gate.requiresAny || gate.requiresAny.some((b) => behaviors.includes(b));\n  return requiresAll && requiresAny;\n}\n\n/**\n * Is a settings surface relevant to a business with `behaviors`?\n * `id` is the settings id (e.g. 'shipping'); unlisted ids are universal → true.\n */\nexport function isSettingRelevant(\n  id: string,\n  behaviors: readonly string[] | null | undefined,\n): boolean {\n  const gate = SETTINGS_RELEVANCE[id];\n  return gate ? passesGate(gate, behaviors) : true;\n}\n"],"mappings":"AA2CO,MAAM,qBAAmD;AAAA,EAC9D,UAAU,EAAE,UAAU,YAAY;AAAA,EAClC,OAAO,EAAE,UAAU,WAAW;AAAA,EAC9B,WAAW,EAAE,aAAa,CAAC,YAAY,WAAW,EAAE;AAAA,EACpD,YAAY,EAAE,aAAa,CAAC,YAAY,WAAW,EAAE;AACvD;AAaA,MAAM,UAAU,CACd,MACuB,KAAK,OAAO,CAAC,IAAI,MAAM,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAW;AAQtE,SAAS,WACd,MACA,WACS;AACT,MAAI,CAAC,UAAW,QAAO;AACvB,QAAM,cAAc,QAAQ,KAAK,QAAQ,EAAE;AAAA,IAAM,CAAC,MAChD,UAAU,SAAS,CAAC;AAAA,EACtB;AACA,QAAM,cACJ,CAAC,KAAK,eAAe,KAAK,YAAY,KAAK,CAAC,MAAM,UAAU,SAAS,CAAC,CAAC;AACzE,SAAO,eAAe;AACxB;AAMO,SAAS,kBACd,IACA,WACS;AACT,QAAM,OAAO,mBAAmB,EAAE;AAClC,SAAO,OAAO,WAAW,MAAM,SAAS,IAAI;AAC9C;","names":[]}

package/dist/singularise.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The singular of a merchant's own plural noun.
+ *
+ * Module labels are stored as plurals — "Guests", "Clients", "Patients" — because
+ * that is what a nav row and a page title need. An action needs the singular:
+ * a page headed **Guests** with a button reading **Add customer** is the word
+ * being taken and then ignored, which is the exact failure `useModuleLabel`
+ * exists to prevent.
+ *
+ * English, deliberately naive, and bounded. This handles the shapes a merchant
+ * actually types for a group of people or things they sell. It is NOT a general
+ * inflector, and it must never mangle a word it does not recognise: anything
+ * unmatched comes back unchanged, because "Add Staff" reads fine and
+ * "Add Staf" does not.
+ */
+export declare function singularise(plural: string): string;

package/dist/singularise.js

@@ -0,0 +1,37 @@
+const UNCHANGED = /* @__PURE__ */ new Set([
+  "staff",
+  "people",
+  "crew",
+  "team",
+  "clientele",
+  "series",
+  "species"
+]);
+const IRREGULAR = {
+  people: "person",
+  children: "child",
+  women: "woman",
+  men: "man"
+};
+function singularise(plural) {
+  const word = plural.trim();
+  if (!word) return word;
+  const lower = word.toLowerCase();
+  if (IRREGULAR[lower]) return matchCase(word, IRREGULAR[lower]);
+  if (UNCHANGED.has(lower)) return word;
+  if (/[^aeiou]ies$/i.test(word)) return word.slice(0, -3) + "y";
+  if (/(ch|sh|s|x|z)es$/i.test(word)) return word.slice(0, -2);
+  if (/[^s]s$/i.test(word)) return word.slice(0, -1);
+  return word;
+}
+function matchCase(source, replacement) {
+  if (source === source.toUpperCase()) return replacement.toUpperCase();
+  if (source[0] === source[0]?.toUpperCase()) {
+    return replacement[0].toUpperCase() + replacement.slice(1);
+  }
+  return replacement;
+}
+export {
+  singularise
+};
+//# sourceMappingURL=singularise.js.map

package/dist/singularise.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/singularise.ts"],"sourcesContent":["/**\n * The singular of a merchant's own plural noun.\n *\n * Module labels are stored as plurals — \"Guests\", \"Clients\", \"Patients\" — because\n * that is what a nav row and a page title need. An action needs the singular:\n * a page headed **Guests** with a button reading **Add customer** is the word\n * being taken and then ignored, which is the exact failure `useModuleLabel`\n * exists to prevent.\n *\n * English, deliberately naive, and bounded. This handles the shapes a merchant\n * actually types for a group of people or things they sell. It is NOT a general\n * inflector, and it must never mangle a word it does not recognise: anything\n * unmatched comes back unchanged, because \"Add Staff\" reads fine and\n * \"Add Staf\" does not.\n */\n\n/** Words that are already singular, or identical in both. */\nconst UNCHANGED = new Set([\n  'staff',\n  'people',\n  'crew',\n  'team',\n  'clientele',\n  'series',\n  'species',\n]);\n\n/** Irregulars worth knowing, in the register merchants use. */\nconst IRREGULAR: Record<string, string> = {\n  people: 'person',\n  children: 'child',\n  women: 'woman',\n  men: 'man',\n};\n\nexport function singularise(plural: string): string {\n  const word = plural.trim();\n  if (!word) return word;\n\n  const lower = word.toLowerCase();\n\n  // \"People\" stays \"People\" as a heading, but \"Add person\" is the right action,\n  // so an irregular beats the unchanged list when one exists.\n  if (IRREGULAR[lower]) return matchCase(word, IRREGULAR[lower]);\n  if (UNCHANGED.has(lower)) return word;\n\n  // Companies → Company, Parties → Party, Agencies → Agency.\n  //\n  // This also turns Movies into \"Movy\", and nothing short of a dictionary\n  // separates the two: \"Companies\" comes from \"Company\", \"Movies\" from\n  // \"Movie\". The -y reading wins because the nouns this exists for name people\n  // and things a merchant sells, not media. Pinned in the tests so it is a\n  // decision rather than a surprise.\n  if (/[^aeiou]ies$/i.test(word)) return word.slice(0, -3) + 'y';\n\n  // Boxes, Churches, Dishes, Classes → drop the whole \"es\".\n  if (/(ch|sh|s|x|z)es$/i.test(word)) return word.slice(0, -2);\n\n  // Guests, Clients, Patients, Members. \"ss\" is not a plural marker.\n  if (/[^s]s$/i.test(word)) return word.slice(0, -1);\n\n  return word;\n}\n\n/** Keep the shape the merchant typed: Guests → Guest, GUESTS → GUEST. */\nfunction matchCase(source: string, replacement: string): string {\n  if (source === source.toUpperCase()) return replacement.toUpperCase();\n  if (source[0] === source[0]?.toUpperCase()) {\n    return replacement[0].toUpperCase() + replacement.slice(1);\n  }\n  return replacement;\n}\n"],"mappings":"AAiBA,MAAM,YAAY,oBAAI,IAAI;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAGD,MAAM,YAAoC;AAAA,EACxC,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,OAAO;AAAA,EACP,KAAK;AACP;AAEO,SAAS,YAAY,QAAwB;AAClD,QAAM,OAAO,OAAO,KAAK;AACzB,MAAI,CAAC,KAAM,QAAO;AAElB,QAAM,QAAQ,KAAK,YAAY;AAI/B,MAAI,UAAU,KAAK,EAAG,QAAO,UAAU,MAAM,UAAU,KAAK,CAAC;AAC7D,MAAI,UAAU,IAAI,KAAK,EAAG,QAAO;AASjC,MAAI,gBAAgB,KAAK,IAAI,EAAG,QAAO,KAAK,MAAM,GAAG,EAAE,IAAI;AAG3D,MAAI,oBAAoB,KAAK,IAAI,EAAG,QAAO,KAAK,MAAM,GAAG,EAAE;AAG3D,MAAI,UAAU,KAAK,IAAI,EAAG,QAAO,KAAK,MAAM,GAAG,EAAE;AAEjD,SAAO;AACT;AAGA,SAAS,UAAU,QAAgB,aAA6B;AAC9D,MAAI,WAAW,OAAO,YAAY,EAAG,QAAO,YAAY,YAAY;AACpE,MAAI,OAAO,CAAC,MAAM,OAAO,CAAC,GAAG,YAAY,GAAG;AAC1C,WAAO,YAAY,CAAC,EAAE,YAAY,IAAI,YAAY,MAAM,CAAC;AAAA,EAC3D;AACA,SAAO;AACT;","names":[]}