alepha 0.23.0 → 0.24.0

package/dist/server/swagger/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/server/swagger/primitives/$swagger.ts","../../../src/server/swagger/providers/ServerSwaggerProvider.ts","../../../src/server/swagger/index.ts"],"sourcesContent":["import { createPrimitive, KIND, Primitive } from \"alepha\";\n\n/**\n * Creates an OpenAPI/Swagger documentation primitive with interactive UI.\n *\n * Automatically generates API documentation from your $action primitives and serves\n * an interactive Swagger UI for testing endpoints. Supports customization, tag filtering,\n * and OAuth configuration.\n *\n * @example\n * ```ts\n * class App {\n *   docs = $swagger({\n *     prefix: \"/api-docs\",\n *     info: {\n *       title: \"My API\",\n *       version: \"1.0.0\",\n *       description: \"REST API documentation\"\n *     },\n *     excludeTags: [\"internal\"],\n *     ui: { root: \"/swagger\" }\n *   });\n * }\n * ```\n */\nexport const $swagger = (\n  options: SwaggerPrimitiveOptions = {},\n): SwaggerPrimitive => {\n  return createPrimitive(SwaggerPrimitive, options);\n};\n\nexport interface SwaggerPrimitiveOptions {\n  info?: OpenApiDocument[\"info\"];\n\n  /**\n   * @default: \"/docs\"\n   */\n  prefix?: string;\n\n  /**\n   * If true, docs will be disabled.\n   */\n  disabled?: boolean;\n\n  /**\n   * Tags to exclude from the documentation.\n   */\n  excludeTags?: string[];\n\n  /**\n   * Server URLs for the API.\n   * If not provided, the server hostname is used automatically.\n   */\n  servers?: OpenApiServer[];\n\n  /**\n   * Enable Swagger UI.\n   *\n   * @default true\n   */\n  ui?: boolean | SwaggerUiOptions;\n\n  /**\n   * Function to rewrite the OpenAPI document before serving it.\n   */\n  rewrite?: (doc: OpenApiDocument) => void;\n}\n\nexport interface OpenApiServer {\n  url: string;\n  description?: string;\n}\n\nexport interface SwaggerUiOptions {\n  root?: string;\n\n  /**\n   * If true, the authorization data is persisted in browser localStorage.\n   *\n   * @default true\n   */\n  persistAuthorization?: boolean;\n\n  initOAuth?: {\n    /**\n     * Default clientId.\n     */\n    clientId?: string;\n\n    /**\n     * realm query parameter (for oauth1) added to authorizationUrl and tokenUrl.\n     */\n    realm?: string;\n\n    /**\n     * application name, displayed in authorization popup.\n     */\n    appName?: string;\n\n    /**\n     * scope separator for passing scopes, encoded before calling, default\n     * value is a space (encoded value %20).\n     *\n     * @default ' '\n     */\n    scopeSeparator?: string;\n\n    /**\n     * string array or scope separator (i.e. space) separated string of\n     * initially selected oauth scopes\n     *\n     * @default []\n     */\n    scopes?: string | string[];\n\n    /**\n     * Additional query parameters added to authorizationUrl and tokenUrl.\n     * MUST be an object\n     */\n    additionalQueryStringParams?: { [key: string]: any };\n\n    /**\n     * Only activated for the accessCode flow. During the authorization_code\n     * request to the tokenUrl, pass the Client Password using the HTTP Basic\n     * Authentication scheme (Authorization header with Basic\n     * base64encode(client_id + client_secret)).\n     *\n     * @default false\n     */\n    useBasicAuthenticationWithAccessCodeGrant?: boolean;\n\n    /**\n     * Only applies to Authorization Code flows. Proof Key for Code Exchange\n     * brings enhanced security for OAuth public clients.\n     *\n     * @default false\n     */\n    usePkceWithAuthorizationCodeGrant?: boolean;\n  };\n}\n\nexport class SwaggerPrimitive extends Primitive<SwaggerPrimitiveOptions> {}\n\n$swagger[KIND] = SwaggerPrimitive;\n\nexport interface OpenApiDocument {\n  openapi: string;\n  info: {\n    title: string;\n    version: string;\n    description?: string;\n  };\n  servers?: OpenApiServer[];\n  paths: Record<string, any>;\n  components?: {\n    schemas?: Record<string, any>;\n    securitySchemes?: Record<string, any>;\n  };\n}\n\nexport interface OpenApiOperation {\n  tags?: string[];\n  summary?: string;\n  description?: string;\n  operationId?: string;\n  deprecated?: boolean;\n  parameters?: Array<{\n    name: string;\n    in: \"query\" | \"header\" | \"path\" | \"cookie\";\n    description?: string;\n    required?: boolean;\n    schema: any;\n  }>;\n  requestBody?: {\n    description?: string;\n    content: Record<\n      string,\n      {\n        schema: any;\n      }\n    >;\n    required?: boolean;\n  };\n  responses: Record<\n    string,\n    {\n      description: string;\n      content?: Record<\n        string,\n        {\n          schema: any;\n        }\n      >;\n    }\n  >;\n  security?: Array<Record<string, any[]>>;\n}\n","import { join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n  $atom,\n  $hook,\n  $inject,\n  $state,\n  Alepha,\n  isTypeFile,\n  type Static,\n  type TObject,\n  type TSchema,\n  t,\n} from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport {\n  $action,\n  type ActionPrimitive,\n  type RequestConfigSchema,\n  ServerProvider,\n  ServerRouterProvider,\n} from \"alepha/server\";\nimport { ServerStaticProvider } from \"alepha/server/static\";\nimport { FileSystemProvider } from \"alepha/system\";\nimport {\n  $swagger,\n  type OpenApiDocument,\n  type OpenApiOperation,\n  type SwaggerPrimitiveOptions,\n} from \"../primitives/$swagger.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Swagger provider configuration atom\n */\nexport const swaggerOptions = $atom({\n  name: \"alepha.server.swagger.options\",\n  schema: t.object({\n    excludeKeys: t.optional(\n      t.array(t.string(), {\n        description: \"Keys to exclude from swagger schema\",\n      }),\n    ),\n  }),\n  default: {\n    excludeKeys: [],\n  },\n});\n\nexport type ServerSwaggerProviderOptions = Static<typeof swaggerOptions.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [swaggerOptions.key]: ServerSwaggerProviderOptions;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class ServerSwaggerProvider {\n  protected readonly serverStaticProvider = $inject(ServerStaticProvider);\n  protected readonly serverRouterProvider = $inject(ServerRouterProvider);\n  protected readonly serverProvider = $inject(ServerProvider);\n  protected readonly alepha = $inject(Alepha);\n  protected readonly log = $logger();\n  protected readonly options = $state(swaggerOptions);\n  protected readonly fs = $inject(FileSystemProvider);\n\n  public json?: OpenApiDocument;\n\n  protected readonly configure = $hook({\n    on: \"configure\",\n    priority: \"last\", // wait for all configurations, sometimes some actions are registered late!\n    handler: async (alepha) => {\n      const options = alepha.primitives($swagger)?.[0]?.options;\n      if (!options) {\n        return;\n      }\n\n      this.json = await this.setupSwaggerPlugin(options);\n    },\n  });\n\n  public generateSwaggerDoc(options: SwaggerPrimitiveOptions): OpenApiDocument {\n    const json = this.configureOpenApi(\n      this.alepha.primitives($action),\n      options,\n    );\n\n    if (options.rewrite) {\n      options.rewrite(json);\n    }\n\n    return json;\n  }\n\n  protected async setupSwaggerPlugin(\n    options: SwaggerPrimitiveOptions,\n  ): Promise<OpenApiDocument | undefined> {\n    if (options.disabled) {\n      return;\n    }\n\n    const json = this.generateSwaggerDoc(options);\n\n    const prefix = options.prefix ?? \"/docs\";\n\n    this.configureSwaggerApi(prefix, json);\n\n    if (options.ui !== false) {\n      await this.configureSwaggerUi(prefix, options);\n    } else {\n      this.log.info(`Swagger API available at ${prefix}/json`);\n    }\n\n    return json;\n  }\n\n  protected configureOpenApi(\n    actions: ActionPrimitive<RequestConfigSchema>[],\n    doc: SwaggerPrimitiveOptions,\n  ): OpenApiDocument {\n    const openApi: OpenApiDocument = {\n      openapi: \"3.0.0\",\n      info: doc.info ?? {\n        title: \"API Documentation\",\n        version: \"1.0.0\",\n      },\n      servers: doc.servers ?? [{ url: this.serverProvider.hostname }],\n      paths: {},\n      components: {},\n    };\n\n    let hasSecurity = false;\n    const excludeTags = doc.excludeTags ?? [];\n    const schemas: Record<string, any> = {};\n\n    const schema = (source: TSchema) => {\n      if (\"title\" in source && typeof source.title === \"string\") {\n        schemas[source.title] = copy(source);\n        return { $ref: `#/components/schemas/${source.title}` };\n      }\n      return copy(source);\n    };\n\n    const copy = (obj: any) => {\n      const newValue = JSON.parse(JSON.stringify(obj));\n      this.removePrivateFields(newValue, [\n        ...(this.options.excludeKeys || []),\n        \"~options\",\n      ]);\n      return newValue;\n    };\n\n    for (const route of actions) {\n      if (!route.options.schema) {\n        continue;\n      }\n\n      const response = this.getResponseSchema(route);\n      if (!response) {\n        continue;\n      }\n\n      if (excludeTags.includes(route.group)) {\n        continue;\n      }\n\n      if (route.options.hide) {\n        continue;\n      }\n\n      const operation: OpenApiOperation = {\n        operationId: route.name,\n        summary: route.options.summary,\n        description: route.options.description,\n        deprecated: route.options.deprecated || undefined,\n        tags: [route.group.replaceAll(\":\", \" / \")],\n        responses: {\n          [response.status]: {\n            description: this.getStatusDescription(response.status),\n            content: response.type\n              ? {\n                  [response.type]: {\n                    schema: schema(response.schema),\n                  },\n                }\n              : undefined,\n          },\n        },\n      };\n\n      const isSecured = route.middlewares.some((m) => m?.name === \"$secure\");\n\n      if (isSecured) {\n        operation.security = [{ bearerAuth: [] }];\n        operation.responses[\"401\"] = {\n          description: \"Unauthorized\",\n        };\n        hasSecurity = true;\n      }\n\n      if (\n        t.schema.isObject(route.options.schema.body) ||\n        t.schema.isArray(route.options.schema.body)\n      ) {\n        if (\n          t.schema.isObject(route.options.schema.body) &&\n          this.isBodyMultipart(route.options.schema.body)\n        ) {\n          operation.requestBody = {\n            required: true,\n            content: {\n              \"multipart/form-data\": {\n                schema: schema(route.options.schema.body),\n              },\n            },\n          };\n        } else {\n          operation.requestBody = {\n            required: true,\n            content: {\n              \"application/json\": {\n                schema: schema(route.options.schema.body),\n              },\n            },\n          };\n        }\n      }\n\n      if (t.schema.isObject(route.options.schema.query)) {\n        operation.parameters ??= [];\n        const requiredKeys: string[] =\n          route.options.schema.query.required ?? [];\n        for (const [key, value] of Object.entries(\n          route.options.schema.query.properties,\n        )) {\n          const param: any = {\n            name: key,\n            in: \"query\",\n            required: requiredKeys.includes(key),\n            schema: schema(value),\n          };\n          const example = this.extractExample(value);\n          if (example !== undefined) param.example = example;\n          operation.parameters.push(param);\n        }\n      }\n\n      if (t.schema.isObject(route.options.schema.params)) {\n        operation.parameters ??= [];\n        for (const [key, value] of Object.entries(\n          route.options.schema.params.properties,\n        )) {\n          const description =\n            \"description\" in value && typeof value.description === \"string\"\n              ? value.description\n              : undefined;\n          const ref = schema(value);\n          ref.description = undefined;\n          const param: any = {\n            name: key,\n            in: \"path\",\n            required: true,\n            description,\n            schema: ref,\n          };\n          const example = this.extractExample(value);\n          if (example !== undefined) param.example = example;\n          operation.parameters.push(param);\n        }\n      }\n\n      const hasValidation =\n        operation.requestBody || operation.parameters?.length;\n      if (hasValidation) {\n        operation.responses[\"400\"] = {\n          description: \"Bad Request\",\n        };\n      }\n\n      const url = route.prefix + this.replacePathParams(route.path);\n\n      openApi.paths[url] = {\n        ...openApi.paths[url],\n        [route.method.toLowerCase()]: operation,\n      };\n    }\n\n    if (hasSecurity && openApi.components) {\n      openApi.components.securitySchemes = {\n        bearerAuth: {\n          type: \"http\",\n          scheme: \"bearer\",\n          bearerFormat: \"JWT\",\n          description:\n            \"Enter a JWT token or API key. Both are accepted as Bearer tokens.\",\n        },\n      };\n    }\n\n    if (openApi.components) openApi.components.schemas = schemas;\n\n    return JSON.parse(JSON.stringify(openApi));\n  }\n\n  public isBodyMultipart(schema: TObject): boolean {\n    for (const key in schema.properties) {\n      if (isTypeFile(schema.properties[key])) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  public replacePathParams(url: string): string {\n    return url.replace(/:\\w+/g, (match) => {\n      const paramName = match.slice(1);\n      return `{${paramName}}`;\n    });\n  }\n\n  public getResponseSchema(route: ActionPrimitive<RequestConfigSchema>):\n    | {\n        type?: string;\n        schema?: any;\n        status: number;\n      }\n    | undefined {\n    const schema: any = route.options.schema?.response;\n    if (!schema) {\n      return {\n        status: 204,\n      };\n    }\n\n    if (t.schema.isObject(schema) || t.schema.isArray(schema)) {\n      return {\n        schema,\n        status: 200,\n        type: \"application/json\",\n      };\n    }\n\n    if (t.schema.isString(schema)) {\n      return {\n        schema,\n        status: 200,\n        type: \"text/plain\",\n      };\n    }\n\n    if (\n      t.schema.isNumber(schema) ||\n      t.schema.isInteger(schema) ||\n      t.schema.isBoolean(schema)\n    ) {\n      return {\n        schema,\n        status: 200,\n        type: \"application/json\",\n      };\n    }\n\n    if (isTypeFile(schema)) {\n      return {\n        schema,\n        status: 200,\n        type: \"application/octet-stream\",\n      };\n    }\n\n    // Status-code-keyed map: e.g. { 201: t.object({...}) }\n    const status = Object.keys(schema)[0];\n    if (status && !Number.isNaN(Number(status))) {\n      const inner = schema[status];\n      return {\n        schema: inner,\n        status: Number(status),\n        type: this.getContentType(inner),\n      };\n    }\n  }\n\n  protected extractExample(schema: any): any {\n    if (\"examples\" in schema && Array.isArray(schema.examples)) {\n      return schema.examples[0];\n    }\n    if (\"default\" in schema) {\n      return schema.default;\n    }\n    return undefined;\n  }\n\n  protected getStatusDescription(status: number): string {\n    switch (status) {\n      case 200:\n        return \"OK\";\n      case 201:\n        return \"Created\";\n      case 204:\n        return \"No Content\";\n      case 400:\n        return \"Bad Request\";\n      case 401:\n        return \"Unauthorized\";\n      case 403:\n        return \"Forbidden\";\n      case 404:\n        return \"Not Found\";\n      case 500:\n        return \"Internal Server Error\";\n      default:\n        return \"\";\n    }\n  }\n\n  protected getContentType(schema: any): string | undefined {\n    if (!schema) return undefined;\n    if (t.schema.isObject(schema) || t.schema.isArray(schema)) {\n      return \"application/json\";\n    }\n    if (t.schema.isString(schema)) return \"text/plain\";\n    if (\n      t.schema.isNumber(schema) ||\n      t.schema.isInteger(schema) ||\n      t.schema.isBoolean(schema)\n    ) {\n      return \"application/json\";\n    }\n    if (isTypeFile(schema)) return \"application/octet-stream\";\n    return \"application/json\";\n  }\n\n  protected configureSwaggerApi(prefix: string, json: OpenApiDocument): void {\n    this.serverRouterProvider.createRoute({\n      method: \"GET\",\n      path: `${prefix}/json`,\n      schema: {\n        response: t.json(),\n      },\n      handler: () => json,\n    });\n  }\n\n  protected async configureSwaggerUi(\n    prefix: string,\n    options: SwaggerPrimitiveOptions,\n  ): Promise<void> {\n    const ui = typeof options.ui === \"object\" ? options.ui : {};\n    const persistAuth = ui.persistAuthorization !== false;\n    const initializer = `\nwindow.onload = function() {\n\twindow.ui = SwaggerUIBundle({\n\t\turl: \"${prefix}/json\",\n\t\tdom_id: '#swagger-ui',\n\t\tdeepLinking: true,\n\t\tpersistAuthorization: ${persistAuth},\n\t\tpresets: [\n\t\t\tSwaggerUIBundle.presets.apis,\n\t\t\tSwaggerUIStandalonePreset\n\t\t],\n\t\tplugins: [\n\t\t\tSwaggerUIBundle.plugins.DownloadUrl\n\t\t],\n\t\tlayout: \"BaseLayout\"\n\t});\n\n  document.body.style.backgroundColor = \"#f2f2f2\";\n\n\tconst options = ${JSON.stringify(ui)};\n\n\tif (options.initOAuth) {\n\t\tui.initOAuth(options.initOAuth);\n\t}\n};\n\t\t`.trim();\n\n    if (!this.alepha.isServerless()) {\n      const dirname = fileURLToPath(import.meta.url);\n\n      const root = await this.getAssetPath(\n        ui.root,\n        // TODO: this is shitty, take time to get the correct path\n        join(dirname, \"../../assets/swagger-ui\"),\n        join(dirname, \"../../../assets/swagger-ui\"),\n        join(dirname, \"../../../../assets/swagger-ui\"),\n        join(dirname, \"../../../../../assets/swagger-ui\"),\n      );\n\n      if (!root) {\n        this.log.warn(`Failed to locate Swagger UI assets for path ${prefix}`);\n        return;\n      }\n\n      await this.serverStaticProvider.createStaticServer({\n        path: prefix,\n        root,\n      });\n    }\n\n    this.serverRouterProvider.createRoute({\n      method: \"GET\",\n      path: `${prefix}/swagger-initializer.js`,\n      handler: ({ reply }) => {\n        reply.headers[\"content-type\"] = \"application/javascript; charset=utf-8\";\n        return initializer;\n      },\n    });\n\n    this.log.info(\"SwaggerUI OK\", {\n      url: `${this.serverProvider.hostname}${prefix}`,\n    });\n  }\n\n  protected async getAssetPath(\n    ...paths: (string | undefined)[]\n  ): Promise<string | undefined> {\n    for (const path of paths) {\n      if (!path) continue;\n      const exists = await this.fs.exists(path);\n      if (exists) {\n        return path;\n      }\n    }\n  }\n\n  public removePrivateFields<T extends Record<string, any>>(\n    obj: T,\n    excludeList: string[],\n  ): T {\n    if (obj === null || typeof obj !== \"object\") return obj;\n\n    const visited = new WeakSet();\n\n    const traverse = (o: any): void => {\n      if (visited.has(o)) return;\n      visited.add(o);\n\n      if (Array.isArray(o)) {\n        for (let i = 0; i < o.length; i++) {\n          const item = o[i];\n          if (item !== null && typeof item === \"object\") {\n            traverse(item);\n          }\n        }\n      } else {\n        for (const excludeKey of excludeList) {\n          if (excludeKey in o) {\n            delete o[excludeKey];\n          }\n        }\n        for (const key in o) {\n          const item = o[key];\n          if (item !== null && typeof item === \"object\") {\n            traverse(item);\n          }\n        }\n      }\n    };\n\n    traverse(obj);\n    return obj;\n  }\n}\n","import \"alepha/security\";\nimport { $module } from \"alepha\";\nimport { AlephaServer, type RequestConfigSchema } from \"alepha/server\";\nimport { AlephaServerEtag } from \"alepha/server/etag\";\nimport { AlephaServerStatic } from \"alepha/server/static\";\nimport { $swagger } from \"./primitives/$swagger.ts\";\nimport { ServerSwaggerProvider } from \"./providers/ServerSwaggerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./primitives/$swagger.ts\";\nexport * from \"./providers/ServerSwaggerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha/server\" {\n  interface ActionPrimitiveOptions<TConfig extends RequestConfigSchema> {\n    /**\n     * Short description of the route.\n     */\n    summary?: string;\n\n    /**\n     * Don't include this action in the Swagger documentation.\n     */\n    hide?: boolean;\n\n    /**\n     * Mark this action as deprecated in the documentation.\n     */\n    deprecated?: boolean;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Automatic API documentation generation.\n *\n * **Features:**\n * - Swagger/OpenAPI configuration\n * - Routes: `GET /swagger/ui`, `GET /swagger.json`\n *\n * @module alepha.server.swagger\n */\nexport const AlephaServerSwagger = $module({\n  name: \"alepha.server.swagger\",\n  primitives: [$swagger],\n  services: [ServerSwaggerProvider],\n  register: (alepha) => {\n    alepha.with(AlephaServer);\n    alepha.with(AlephaServerEtag);\n    alepha.with(AlephaServerStatic);\n    alepha.with(ServerSwaggerProvider);\n    alepha.store.push(\"alepha.build.assets\", \"alepha\");\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,MAAa,YACX,UAAmC,CAAC,MACf;CACrB,OAAO,gBAAgB,kBAAkB,OAAO;AAClD;AAgHA,IAAa,mBAAb,cAAsC,UAAmC,CAAC;AAE1E,SAAS,QAAQ;;;;;;AC3GjB,MAAa,iBAAiB,MAAM;CAClC,MAAM;CACN,QAAQ,EAAE,OAAO,EACf,aAAa,EAAE,SACb,EAAE,MAAM,EAAE,OAAO,GAAG,EAClB,aAAa,sCACf,CAAC,CACH,EACF,CAAC;CACD,SAAS,EACP,aAAa,CAAC,EAChB;AACF,CAAC;AAYD,IAAa,wBAAb,MAAmC;CACjC,uBAA0C,QAAQ,oBAAoB;CACtE,uBAA0C,QAAQ,oBAAoB;CACtE,iBAAoC,QAAQ,cAAc;CAC1D,SAA4B,QAAQ,MAAM;CAC1C,MAAyB,QAAQ;CACjC,UAA6B,OAAO,cAAc;CAClD,KAAwB,QAAQ,kBAAkB;CAElD;CAEA,YAA+B,MAAM;EACnC,IAAI;EACJ,UAAU;EACV,SAAS,OAAO,WAAW;GACzB,MAAM,UAAU,OAAO,WAAW,QAAQ,IAAI,IAAI;GAClD,IAAI,CAAC,SACH;GAGF,KAAK,OAAO,MAAM,KAAK,mBAAmB,OAAO;EACnD;CACF,CAAC;CAED,mBAA0B,SAAmD;EAC3E,MAAM,OAAO,KAAK,iBAChB,KAAK,OAAO,WAAW,OAAO,GAC9B,OACF;EAEA,IAAI,QAAQ,SACV,QAAQ,QAAQ,IAAI;EAGtB,OAAO;CACT;CAEA,MAAgB,mBACd,SACsC;EACtC,IAAI,QAAQ,UACV;EAGF,MAAM,OAAO,KAAK,mBAAmB,OAAO;EAE5C,MAAM,SAAS,QAAQ,UAAU;EAEjC,KAAK,oBAAoB,QAAQ,IAAI;EAErC,IAAI,QAAQ,OAAO,OACjB,MAAM,KAAK,mBAAmB,QAAQ,OAAO;OAE7C,KAAK,IAAI,KAAK,4BAA4B,OAAO,MAAM;EAGzD,OAAO;CACT;CAEA,iBACE,SACA,KACiB;EACjB,MAAM,UAA2B;GAC/B,SAAS;GACT,MAAM,IAAI,QAAQ;IAChB,OAAO;IACP,SAAS;GACX;GACA,SAAS,IAAI,WAAW,CAAC,EAAE,KAAK,KAAK,eAAe,SAAS,CAAC;GAC9D,OAAO,CAAC;GACR,YAAY,CAAC;EACf;EAEA,IAAI,cAAc;EAClB,MAAM,cAAc,IAAI,eAAe,CAAC;EACxC,MAAM,UAA+B,CAAC;EAEtC,MAAM,UAAU,WAAoB;GAClC,IAAI,WAAW,UAAU,OAAO,OAAO,UAAU,UAAU;IACzD,QAAQ,OAAO,SAAS,KAAK,MAAM;IACnC,OAAO,EAAE,MAAM,wBAAwB,OAAO,QAAQ;GACxD;GACA,OAAO,KAAK,MAAM;EACpB;EAEA,MAAM,QAAQ,QAAa;GACzB,MAAM,WAAW,KAAK,MAAM,KAAK,UAAU,GAAG,CAAC;GAC/C,KAAK,oBAAoB,UAAU,CACjC,GAAI,KAAK,QAAQ,eAAe,CAAC,GACjC,UACF,CAAC;GACD,OAAO;EACT;EAEA,KAAK,MAAM,SAAS,SAAS;GAC3B,IAAI,CAAC,MAAM,QAAQ,QACjB;GAGF,MAAM,WAAW,KAAK,kBAAkB,KAAK;GAC7C,IAAI,CAAC,UACH;GAGF,IAAI,YAAY,SAAS,MAAM,KAAK,GAClC;GAGF,IAAI,MAAM,QAAQ,MAChB;GAGF,MAAM,YAA8B;IAClC,aAAa,MAAM;IACnB,SAAS,MAAM,QAAQ;IACvB,aAAa,MAAM,QAAQ;IAC3B,YAAY,MAAM,QAAQ,cAAc,KAAA;IACxC,MAAM,CAAC,MAAM,MAAM,WAAW,KAAK,KAAK,CAAC;IACzC,WAAW,GACR,SAAS,SAAS;KACjB,aAAa,KAAK,qBAAqB,SAAS,MAAM;KACtD,SAAS,SAAS,OACd,GACG,SAAS,OAAO,EACf,QAAQ,OAAO,SAAS,MAAM,EAChC,EACF,IACA,KAAA;IACN,EACF;GACF;GAIA,IAFkB,MAAM,YAAY,MAAM,MAAM,GAAG,SAAS,SAEhD,GAAG;IACb,UAAU,WAAW,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC;IACxC,UAAU,UAAU,SAAS,EAC3B,aAAa,eACf;IACA,cAAc;GAChB;GAEA,IACE,EAAE,OAAO,SAAS,MAAM,QAAQ,OAAO,IAAI,KAC3C,EAAE,OAAO,QAAQ,MAAM,QAAQ,OAAO,IAAI,GAE1C,IACE,EAAE,OAAO,SAAS,MAAM,QAAQ,OAAO,IAAI,KAC3C,KAAK,gBAAgB,MAAM,QAAQ,OAAO,IAAI,GAE9C,UAAU,cAAc;IACtB,UAAU;IACV,SAAS,EACP,uBAAuB,EACrB,QAAQ,OAAO,MAAM,QAAQ,OAAO,IAAI,EAC1C,EACF;GACF;QAEA,UAAU,cAAc;IACtB,UAAU;IACV,SAAS,EACP,oBAAoB,EAClB,QAAQ,OAAO,MAAM,QAAQ,OAAO,IAAI,EAC1C,EACF;GACF;GAIJ,IAAI,EAAE,OAAO,SAAS,MAAM,QAAQ,OAAO,KAAK,GAAG;IACjD,UAAU,eAAe,CAAC;IAC1B,MAAM,eACJ,MAAM,QAAQ,OAAO,MAAM,YAAY,CAAC;IAC1C,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAChC,MAAM,QAAQ,OAAO,MAAM,UAC7B,GAAG;KACD,MAAM,QAAa;MACjB,MAAM;MACN,IAAI;MACJ,UAAU,aAAa,SAAS,GAAG;MACnC,QAAQ,OAAO,KAAK;KACtB;KACA,MAAM,UAAU,KAAK,eAAe,KAAK;KACzC,IAAI,YAAY,KAAA,GAAW,MAAM,UAAU;KAC3C,UAAU,WAAW,KAAK,KAAK;IACjC;GACF;GAEA,IAAI,EAAE,OAAO,SAAS,MAAM,QAAQ,OAAO,MAAM,GAAG;IAClD,UAAU,eAAe,CAAC;IAC1B,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAChC,MAAM,QAAQ,OAAO,OAAO,UAC9B,GAAG;KACD,MAAM,cACJ,iBAAiB,SAAS,OAAO,MAAM,gBAAgB,WACnD,MAAM,cACN,KAAA;KACN,MAAM,MAAM,OAAO,KAAK;KACxB,IAAI,cAAc,KAAA;KAClB,MAAM,QAAa;MACjB,MAAM;MACN,IAAI;MACJ,UAAU;MACV;MACA,QAAQ;KACV;KACA,MAAM,UAAU,KAAK,eAAe,KAAK;KACzC,IAAI,YAAY,KAAA,GAAW,MAAM,UAAU;KAC3C,UAAU,WAAW,KAAK,KAAK;IACjC;GACF;GAIA,IADE,UAAU,eAAe,UAAU,YAAY,QAE/C,UAAU,UAAU,SAAS,EAC3B,aAAa,cACf;GAGF,MAAM,MAAM,MAAM,SAAS,KAAK,kBAAkB,MAAM,IAAI;GAE5D,QAAQ,MAAM,OAAO;IACnB,GAAG,QAAQ,MAAM;KAChB,MAAM,OAAO,YAAY,IAAI;GAChC;EACF;EAEA,IAAI,eAAe,QAAQ,YACzB,QAAQ,WAAW,kBAAkB,EACnC,YAAY;GACV,MAAM;GACN,QAAQ;GACR,cAAc;GACd,aACE;EACJ,EACF;EAGF,IAAI,QAAQ,YAAY,QAAQ,WAAW,UAAU;EAErD,OAAO,KAAK,MAAM,KAAK,UAAU,OAAO,CAAC;CAC3C;CAEA,gBAAuB,QAA0B;EAC/C,KAAK,MAAM,OAAO,OAAO,YACvB,IAAI,WAAW,OAAO,WAAW,IAAI,GACnC,OAAO;EAGX,OAAO;CACT;CAEA,kBAAyB,KAAqB;EAC5C,OAAO,IAAI,QAAQ,UAAU,UAAU;GAErC,OAAO,IADW,MAAM,MAAM,CACX,EAAE;EACvB,CAAC;CACH;CAEA,kBAAyB,OAMX;EACZ,MAAM,SAAc,MAAM,QAAQ,QAAQ;EAC1C,IAAI,CAAC,QACH,OAAO,EACL,QAAQ,IACV;EAGF,IAAI,EAAE,OAAO,SAAS,MAAM,KAAK,EAAE,OAAO,QAAQ,MAAM,GACtD,OAAO;GACL;GACA,QAAQ;GACR,MAAM;EACR;EAGF,IAAI,EAAE,OAAO,SAAS,MAAM,GAC1B,OAAO;GACL;GACA,QAAQ;GACR,MAAM;EACR;EAGF,IACE,EAAE,OAAO,SAAS,MAAM,KACxB,EAAE,OAAO,UAAU,MAAM,KACzB,EAAE,OAAO,UAAU,MAAM,GAEzB,OAAO;GACL;GACA,QAAQ;GACR,MAAM;EACR;EAGF,IAAI,WAAW,MAAM,GACnB,OAAO;GACL;GACA,QAAQ;GACR,MAAM;EACR;EAIF,MAAM,SAAS,OAAO,KAAK,MAAM,EAAE;EACnC,IAAI,UAAU,CAAC,OAAO,MAAM,OAAO,MAAM,CAAC,GAAG;GAC3C,MAAM,QAAQ,OAAO;GACrB,OAAO;IACL,QAAQ;IACR,QAAQ,OAAO,MAAM;IACrB,MAAM,KAAK,eAAe,KAAK;GACjC;EACF;CACF;CAEA,eAAyB,QAAkB;EACzC,IAAI,cAAc,UAAU,MAAM,QAAQ,OAAO,QAAQ,GACvD,OAAO,OAAO,SAAS;EAEzB,IAAI,aAAa,QACf,OAAO,OAAO;CAGlB;CAEA,qBAA+B,QAAwB;EACrD,QAAQ,QAAR;GACE,KAAK,KACH,OAAO;GACT,KAAK,KACH,OAAO;GACT,KAAK,KACH,OAAO;GACT,KAAK,KACH,OAAO;GACT,KAAK,KACH,OAAO;GACT,KAAK,KACH,OAAO;GACT,KAAK,KACH,OAAO;GACT,KAAK,KACH,OAAO;GACT,SACE,OAAO;EACX;CACF;CAEA,eAAyB,QAAiC;EACxD,IAAI,CAAC,QAAQ,OAAO,KAAA;EACpB,IAAI,EAAE,OAAO,SAAS,MAAM,KAAK,EAAE,OAAO,QAAQ,MAAM,GACtD,OAAO;EAET,IAAI,EAAE,OAAO,SAAS,MAAM,GAAG,OAAO;EACtC,IACE,EAAE,OAAO,SAAS,MAAM,KACxB,EAAE,OAAO,UAAU,MAAM,KACzB,EAAE,OAAO,UAAU,MAAM,GAEzB,OAAO;EAET,IAAI,WAAW,MAAM,GAAG,OAAO;EAC/B,OAAO;CACT;CAEA,oBAA8B,QAAgB,MAA6B;EACzE,KAAK,qBAAqB,YAAY;GACpC,QAAQ;GACR,MAAM,GAAG,OAAO;GAChB,QAAQ,EACN,UAAU,EAAE,KAAK,EACnB;GACA,eAAe;EACjB,CAAC;CACH;CAEA,MAAgB,mBACd,QACA,SACe;EACf,MAAM,KAAK,OAAO,QAAQ,OAAO,WAAW,QAAQ,KAAK,CAAC;EAE1D,MAAM,cAAc;;;UAGd,OAAO;;;0BAJO,GAAG,yBAAyB,MAOd;;;;;;;;;;;;;mBAanB,KAAK,UAAU,EAAE,EAAE;;;;;;IAMlC,KAAK;EAEL,IAAI,CAAC,KAAK,OAAO,aAAa,GAAG;GAC/B,MAAM,UAAU,cAAc,OAAO,KAAK,GAAG;GAE7C,MAAM,OAAO,MAAM,KAAK,aACtB,GAAG,MAEH,KAAK,SAAS,yBAAyB,GACvC,KAAK,SAAS,4BAA4B,GAC1C,KAAK,SAAS,+BAA+B,GAC7C,KAAK,SAAS,kCAAkC,CAClD;GAEA,IAAI,CAAC,MAAM;IACT,KAAK,IAAI,KAAK,+CAA+C,QAAQ;IACrE;GACF;GAEA,MAAM,KAAK,qBAAqB,mBAAmB;IACjD,MAAM;IACN;GACF,CAAC;EACH;EAEA,KAAK,qBAAqB,YAAY;GACpC,QAAQ;GACR,MAAM,GAAG,OAAO;GAChB,UAAU,EAAE,YAAY;IACtB,MAAM,QAAQ,kBAAkB;IAChC,OAAO;GACT;EACF,CAAC;EAED,KAAK,IAAI,KAAK,gBAAgB,EAC5B,KAAK,GAAG,KAAK,eAAe,WAAW,SACzC,CAAC;CACH;CAEA,MAAgB,aACd,GAAG,OAC0B;EAC7B,KAAK,MAAM,QAAQ,OAAO;GACxB,IAAI,CAAC,MAAM;GAEX,IAAI,MADiB,KAAK,GAAG,OAAO,IAAI,GAEtC,OAAO;EAEX;CACF;CAEA,oBACE,KACA,aACG;EACH,IAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU,OAAO;EAEpD,MAAM,0BAAU,IAAI,QAAQ;EAE5B,MAAM,YAAY,MAAiB;GACjC,IAAI,QAAQ,IAAI,CAAC,GAAG;GACpB,QAAQ,IAAI,CAAC;GAEb,IAAI,MAAM,QAAQ,CAAC,GACjB,KAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK;IACjC,MAAM,OAAO,EAAE;IACf,IAAI,SAAS,QAAQ,OAAO,SAAS,UACnC,SAAS,IAAI;GAEjB;QACK;IACL,KAAK,MAAM,cAAc,aACvB,IAAI,cAAc,GAChB,OAAO,EAAE;IAGb,KAAK,MAAM,OAAO,GAAG;KACnB,MAAM,OAAO,EAAE;KACf,IAAI,SAAS,QAAQ,OAAO,SAAS,UACnC,SAAS,IAAI;IAEjB;GACF;EACF;EAEA,SAAS,GAAG;EACZ,OAAO;CACT;AACF;;;;;;;;;;;;ACxgBA,MAAa,sBAAsB,QAAQ;CACzC,MAAM;CACN,YAAY,CAAC,QAAQ;CACrB,UAAU,CAAC,qBAAqB;CAChC,WAAW,WAAW;EACpB,OAAO,KAAK,YAAY;EACxB,OAAO,KAAK,gBAAgB;EAC5B,OAAO,KAAK,kBAAkB;EAC9B,OAAO,KAAK,qBAAqB;EACjC,OAAO,MAAM,KAAK,uBAAuB,QAAQ;CACnD;AACF,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/server/swagger/primitives/$swagger.ts","../../../src/server/swagger/providers/ServerSwaggerProvider.ts","../../../src/server/swagger/index.ts"],"sourcesContent":["import { createPrimitive, KIND, Primitive } from \"alepha\";\n\n/**\n * Creates an OpenAPI/Swagger documentation primitive with interactive UI.\n *\n * Automatically generates API documentation from your $action primitives and serves\n * an interactive Swagger UI for testing endpoints. Supports customization, tag filtering,\n * and OAuth configuration.\n *\n * @example\n * ```ts\n * class App {\n *   docs = $swagger({\n *     prefix: \"/api-docs\",\n *     info: {\n *       title: \"My API\",\n *       version: \"1.0.0\",\n *       description: \"REST API documentation\"\n *     },\n *     excludeTags: [\"internal\"],\n *     ui: { root: \"/swagger\" }\n *   });\n * }\n * ```\n */\nexport const $swagger = (\n  options: SwaggerPrimitiveOptions = {},\n): SwaggerPrimitive => {\n  return createPrimitive(SwaggerPrimitive, options);\n};\n\nexport interface SwaggerPrimitiveOptions {\n  info?: OpenApiDocument[\"info\"];\n\n  /**\n   * @default: \"/docs\"\n   */\n  prefix?: string;\n\n  /**\n   * If true, docs will be disabled.\n   */\n  disabled?: boolean;\n\n  /**\n   * Tags to exclude from the documentation.\n   */\n  excludeTags?: string[];\n\n  /**\n   * Server URLs for the API.\n   * If not provided, the server hostname is used automatically.\n   */\n  servers?: OpenApiServer[];\n\n  /**\n   * Enable Swagger UI.\n   *\n   * @default true\n   */\n  ui?: boolean | SwaggerUiOptions;\n\n  /**\n   * Function to rewrite the OpenAPI document before serving it.\n   */\n  rewrite?: (doc: OpenApiDocument) => void;\n}\n\nexport interface OpenApiServer {\n  url: string;\n  description?: string;\n}\n\nexport interface SwaggerUiOptions {\n  root?: string;\n\n  /**\n   * If true, the authorization data is persisted in browser localStorage.\n   *\n   * @default true\n   */\n  persistAuthorization?: boolean;\n\n  initOAuth?: {\n    /**\n     * Default clientId.\n     */\n    clientId?: string;\n\n    /**\n     * realm query parameter (for oauth1) added to authorizationUrl and tokenUrl.\n     */\n    realm?: string;\n\n    /**\n     * application name, displayed in authorization popup.\n     */\n    appName?: string;\n\n    /**\n     * scope separator for passing scopes, encoded before calling, default\n     * value is a space (encoded value %20).\n     *\n     * @default ' '\n     */\n    scopeSeparator?: string;\n\n    /**\n     * string array or scope separator (i.e. space) separated string of\n     * initially selected oauth scopes\n     *\n     * @default []\n     */\n    scopes?: string | string[];\n\n    /**\n     * Additional query parameters added to authorizationUrl and tokenUrl.\n     * MUST be an object\n     */\n    additionalQueryStringParams?: { [key: string]: any };\n\n    /**\n     * Only activated for the accessCode flow. During the authorization_code\n     * request to the tokenUrl, pass the Client Password using the HTTP Basic\n     * Authentication scheme (Authorization header with Basic\n     * base64encode(client_id + client_secret)).\n     *\n     * @default false\n     */\n    useBasicAuthenticationWithAccessCodeGrant?: boolean;\n\n    /**\n     * Only applies to Authorization Code flows. Proof Key for Code Exchange\n     * brings enhanced security for OAuth public clients.\n     *\n     * @default false\n     */\n    usePkceWithAuthorizationCodeGrant?: boolean;\n  };\n}\n\nexport class SwaggerPrimitive extends Primitive<SwaggerPrimitiveOptions> {}\n\n$swagger[KIND] = SwaggerPrimitive;\n\nexport interface OpenApiDocument {\n  openapi: string;\n  info: {\n    title: string;\n    version: string;\n    description?: string;\n  };\n  servers?: OpenApiServer[];\n  paths: Record<string, any>;\n  components?: {\n    schemas?: Record<string, any>;\n    securitySchemes?: Record<string, any>;\n  };\n}\n\nexport interface OpenApiOperation {\n  tags?: string[];\n  summary?: string;\n  description?: string;\n  operationId?: string;\n  deprecated?: boolean;\n  parameters?: Array<{\n    name: string;\n    in: \"query\" | \"header\" | \"path\" | \"cookie\";\n    description?: string;\n    required?: boolean;\n    schema: any;\n  }>;\n  requestBody?: {\n    description?: string;\n    content: Record<\n      string,\n      {\n        schema: any;\n      }\n    >;\n    required?: boolean;\n  };\n  responses: Record<\n    string,\n    {\n      description: string;\n      content?: Record<\n        string,\n        {\n          schema: any;\n        }\n      >;\n    }\n  >;\n  security?: Array<Record<string, any[]>>;\n}\n","import { join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n  $atom,\n  $hook,\n  $inject,\n  $state,\n  Alepha,\n  isTypeFile,\n  type Static,\n  type TObject,\n  type TSchema,\n  z,\n} from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport {\n  $action,\n  type ActionPrimitive,\n  type RequestConfigSchema,\n  ServerProvider,\n  ServerRouterProvider,\n} from \"alepha/server\";\nimport { ServerStaticProvider } from \"alepha/server/static\";\nimport { FileSystemProvider } from \"alepha/system\";\nimport {\n  $swagger,\n  type OpenApiDocument,\n  type OpenApiOperation,\n  type SwaggerPrimitiveOptions,\n} from \"../primitives/$swagger.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Swagger provider configuration atom\n */\nexport const swaggerOptions = $atom({\n  name: \"alepha.server.swagger.options\",\n  schema: z.object({\n    excludeKeys: z\n      .array(z.string())\n      .describe(\"Keys to exclude from swagger schema\")\n      .optional(),\n  }),\n  default: {\n    excludeKeys: [],\n  },\n});\n\nexport type ServerSwaggerProviderOptions = Static<typeof swaggerOptions.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [swaggerOptions.key]: ServerSwaggerProviderOptions;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class ServerSwaggerProvider {\n  protected readonly serverStaticProvider = $inject(ServerStaticProvider);\n  protected readonly serverRouterProvider = $inject(ServerRouterProvider);\n  protected readonly serverProvider = $inject(ServerProvider);\n  protected readonly alepha = $inject(Alepha);\n  protected readonly log = $logger();\n  protected readonly options = $state(swaggerOptions);\n  protected readonly fs = $inject(FileSystemProvider);\n\n  public json?: OpenApiDocument;\n\n  protected readonly configure = $hook({\n    on: \"configure\",\n    priority: \"last\", // wait for all configurations, sometimes some actions are registered late!\n    handler: async (alepha) => {\n      const options = alepha.primitives($swagger)?.[0]?.options;\n      if (!options) {\n        return;\n      }\n\n      this.json = await this.setupSwaggerPlugin(options);\n    },\n  });\n\n  public generateSwaggerDoc(options: SwaggerPrimitiveOptions): OpenApiDocument {\n    const json = this.configureOpenApi(\n      this.alepha.primitives($action),\n      options,\n    );\n\n    if (options.rewrite) {\n      options.rewrite(json);\n    }\n\n    return json;\n  }\n\n  protected async setupSwaggerPlugin(\n    options: SwaggerPrimitiveOptions,\n  ): Promise<OpenApiDocument | undefined> {\n    if (options.disabled) {\n      return;\n    }\n\n    const json = this.generateSwaggerDoc(options);\n\n    const prefix = options.prefix ?? \"/docs\";\n\n    this.configureSwaggerApi(prefix, json);\n\n    if (options.ui !== false) {\n      await this.configureSwaggerUi(prefix, options);\n    } else {\n      this.log.info(`Swagger API available at ${prefix}/json`);\n    }\n\n    return json;\n  }\n\n  protected configureOpenApi(\n    actions: ActionPrimitive<RequestConfigSchema>[],\n    doc: SwaggerPrimitiveOptions,\n  ): OpenApiDocument {\n    const openApi: OpenApiDocument = {\n      openapi: \"3.0.0\",\n      info: doc.info ?? {\n        title: \"API Documentation\",\n        version: \"1.0.0\",\n      },\n      servers: doc.servers ?? [{ url: this.serverProvider.hostname }],\n      paths: {},\n      components: {},\n    };\n\n    let hasSecurity = false;\n    const excludeTags = doc.excludeTags ?? [];\n    const schemas: Record<string, any> = {};\n\n    const toJson = (source: TSchema): any => {\n      let json: any;\n      try {\n        json = z.toJSONSchema(source as any);\n      } catch {\n        json = {};\n      }\n      // zod stamps a `$schema` dialect URL we don't want in OpenAPI fragments.\n      json.$schema = undefined;\n      this.removePrivateFields(json, [\n        ...(this.options.excludeKeys || []),\n        \"~options\",\n      ]);\n      return json;\n    };\n\n    const schema = (source: TSchema): any => {\n      const json = toJson(source);\n      // A titled schema is hoisted into `components/schemas` and referenced.\n      const title =\n        (typeof (source as any)?.meta === \"function\"\n          ? (source as any).meta()?.title\n          : undefined) ?? json.title;\n      if (typeof title === \"string\") {\n        schemas[title] = json;\n        return { $ref: `#/components/schemas/${title}` };\n      }\n      return json;\n    };\n\n    for (const route of actions) {\n      if (!route.options.schema) {\n        continue;\n      }\n\n      const response = this.getResponseSchema(route);\n      if (!response) {\n        continue;\n      }\n\n      if (excludeTags.includes(route.group)) {\n        continue;\n      }\n\n      if (route.options.hide) {\n        continue;\n      }\n\n      const operation: OpenApiOperation = {\n        operationId: route.name,\n        summary: route.options.summary,\n        description: route.options.description,\n        deprecated: route.options.deprecated || undefined,\n        tags: [route.group.replaceAll(\":\", \" / \")],\n        responses: {\n          [response.status]: {\n            description: this.getStatusDescription(response.status),\n            content: response.type\n              ? {\n                  [response.type]: {\n                    schema: schema(response.schema),\n                  },\n                }\n              : undefined,\n          },\n        },\n      };\n\n      const isSecured = route.middlewares.some((m) => m?.name === \"$secure\");\n\n      if (isSecured) {\n        operation.security = [{ bearerAuth: [] }];\n        operation.responses[\"401\"] = {\n          description: \"Unauthorized\",\n        };\n        hasSecurity = true;\n      }\n\n      if (\n        z.schema.isObject(route.options.schema.body) ||\n        z.schema.isArray(route.options.schema.body)\n      ) {\n        if (\n          z.schema.isObject(route.options.schema.body) &&\n          this.isBodyMultipart(route.options.schema.body)\n        ) {\n          operation.requestBody = {\n            required: true,\n            content: {\n              \"multipart/form-data\": {\n                schema: schema(route.options.schema.body),\n              },\n            },\n          };\n        } else {\n          operation.requestBody = {\n            required: true,\n            content: {\n              \"application/json\": {\n                schema: schema(route.options.schema.body),\n              },\n            },\n          };\n        }\n      }\n\n      if (z.schema.isObject(route.options.schema.query)) {\n        operation.parameters ??= [];\n        const requiredKeys: string[] = z.schema.requiredKeys(\n          route.options.schema.query,\n        );\n        for (const [key, value] of Object.entries(\n          route.options.schema.query.properties,\n        )) {\n          const param: any = {\n            name: key,\n            in: \"query\",\n            required: requiredKeys.includes(key),\n            schema: schema(value),\n          };\n          const example = this.extractExample(value);\n          if (example !== undefined) param.example = example;\n          operation.parameters.push(param);\n        }\n      }\n\n      if (z.schema.isObject(route.options.schema.params)) {\n        operation.parameters ??= [];\n        for (const [key, value] of Object.entries(\n          route.options.schema.params.properties,\n        )) {\n          const valueMeta =\n            typeof (value as any)?.meta === \"function\"\n              ? ((value as any).meta() ?? {})\n              : {};\n          const description =\n            typeof valueMeta.description === \"string\"\n              ? valueMeta.description\n              : undefined;\n          const ref = schema(value);\n          ref.description = undefined;\n          const param: any = {\n            name: key,\n            in: \"path\",\n            required: true,\n            description,\n            schema: ref,\n          };\n          const example = this.extractExample(value);\n          if (example !== undefined) param.example = example;\n          operation.parameters.push(param);\n        }\n      }\n\n      const hasValidation =\n        operation.requestBody || operation.parameters?.length;\n      if (hasValidation) {\n        operation.responses[\"400\"] = {\n          description: \"Bad Request\",\n        };\n      }\n\n      const url = route.prefix + this.replacePathParams(route.path);\n\n      openApi.paths[url] = {\n        ...openApi.paths[url],\n        [route.method.toLowerCase()]: operation,\n      };\n    }\n\n    if (hasSecurity && openApi.components) {\n      openApi.components.securitySchemes = {\n        bearerAuth: {\n          type: \"http\",\n          scheme: \"bearer\",\n          bearerFormat: \"JWT\",\n          description:\n            \"Enter a JWT token or API key. Both are accepted as Bearer tokens.\",\n        },\n      };\n    }\n\n    if (openApi.components) openApi.components.schemas = schemas;\n\n    return JSON.parse(JSON.stringify(openApi));\n  }\n\n  public isBodyMultipart(schema: TObject): boolean {\n    for (const key in schema.properties) {\n      if (isTypeFile(schema.properties[key])) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  public replacePathParams(url: string): string {\n    return url.replace(/:\\w+/g, (match) => {\n      const paramName = match.slice(1);\n      return `{${paramName}}`;\n    });\n  }\n\n  public getResponseSchema(route: ActionPrimitive<RequestConfigSchema>):\n    | {\n        type?: string;\n        schema?: any;\n        status: number;\n      }\n    | undefined {\n    const schema: any = route.options.schema?.response;\n    if (!schema) {\n      return {\n        status: 204,\n      };\n    }\n\n    if (z.schema.isObject(schema) || z.schema.isArray(schema)) {\n      return {\n        schema,\n        status: 200,\n        type: \"application/json\",\n      };\n    }\n\n    if (z.schema.isString(schema)) {\n      return {\n        schema,\n        status: 200,\n        type: \"text/plain\",\n      };\n    }\n\n    if (\n      z.schema.isNumber(schema) ||\n      z.schema.isInteger(schema) ||\n      z.schema.isBoolean(schema)\n    ) {\n      return {\n        schema,\n        status: 200,\n        type: \"application/json\",\n      };\n    }\n\n    if (isTypeFile(schema)) {\n      return {\n        schema,\n        status: 200,\n        type: \"application/octet-stream\",\n      };\n    }\n\n    // Status-code-keyed map: e.g. { 201: z.object({...}) }\n    const status = Object.keys(schema)[0];\n    if (status && !Number.isNaN(Number(status))) {\n      const inner = schema[status];\n      return {\n        schema: inner,\n        status: Number(status),\n        type: this.getContentType(inner),\n      };\n    }\n  }\n\n  protected extractExample(schema: any): any {\n    const meta =\n      typeof schema?.meta === \"function\" ? (schema.meta() ?? {}) : {};\n    if (Array.isArray(meta.examples) && meta.examples.length > 0) {\n      return meta.examples[0];\n    }\n    if (meta.example !== undefined) {\n      return meta.example;\n    }\n    const def = z.schema.getDefault(schema);\n    if (def !== undefined) {\n      return def;\n    }\n    return undefined;\n  }\n\n  protected getStatusDescription(status: number): string {\n    switch (status) {\n      case 200:\n        return \"OK\";\n      case 201:\n        return \"Created\";\n      case 204:\n        return \"No Content\";\n      case 400:\n        return \"Bad Request\";\n      case 401:\n        return \"Unauthorized\";\n      case 403:\n        return \"Forbidden\";\n      case 404:\n        return \"Not Found\";\n      case 500:\n        return \"Internal Server Error\";\n      default:\n        return \"\";\n    }\n  }\n\n  protected getContentType(schema: any): string | undefined {\n    if (!schema) return undefined;\n    if (z.schema.isObject(schema) || z.schema.isArray(schema)) {\n      return \"application/json\";\n    }\n    if (z.schema.isString(schema)) return \"text/plain\";\n    if (\n      z.schema.isNumber(schema) ||\n      z.schema.isInteger(schema) ||\n      z.schema.isBoolean(schema)\n    ) {\n      return \"application/json\";\n    }\n    if (isTypeFile(schema)) return \"application/octet-stream\";\n    return \"application/json\";\n  }\n\n  protected configureSwaggerApi(prefix: string, json: OpenApiDocument): void {\n    this.serverRouterProvider.createRoute({\n      method: \"GET\",\n      path: `${prefix}/json`,\n      schema: {\n        response: z.json(),\n      },\n      handler: () => json,\n    });\n  }\n\n  protected async configureSwaggerUi(\n    prefix: string,\n    options: SwaggerPrimitiveOptions,\n  ): Promise<void> {\n    const ui = typeof options.ui === \"object\" ? options.ui : {};\n    const persistAuth = ui.persistAuthorization !== false;\n    const initializer = `\nwindow.onload = function() {\n\twindow.ui = SwaggerUIBundle({\n\t\turl: \"${prefix}/json\",\n\t\tdom_id: '#swagger-ui',\n\t\tdeepLinking: true,\n\t\tpersistAuthorization: ${persistAuth},\n\t\tpresets: [\n\t\t\tSwaggerUIBundle.presets.apis,\n\t\t\tSwaggerUIStandalonePreset\n\t\t],\n\t\tplugins: [\n\t\t\tSwaggerUIBundle.plugins.DownloadUrl\n\t\t],\n\t\tlayout: \"BaseLayout\"\n\t});\n\n  document.body.style.backgroundColor = \"#f2f2f2\";\n\n\tconst options = ${JSON.stringify(ui)};\n\n\tif (options.initOAuth) {\n\t\tui.initOAuth(options.initOAuth);\n\t}\n};\n\t\t`.trim();\n\n    if (!this.alepha.isServerless()) {\n      const dirname = fileURLToPath(import.meta.url);\n\n      const root = await this.getAssetPath(\n        ui.root,\n        // TODO: this is shitty, take time to get the correct path\n        join(dirname, \"../../assets/swagger-ui\"),\n        join(dirname, \"../../../assets/swagger-ui\"),\n        join(dirname, \"../../../../assets/swagger-ui\"),\n        join(dirname, \"../../../../../assets/swagger-ui\"),\n      );\n\n      if (!root) {\n        this.log.warn(`Failed to locate Swagger UI assets for path ${prefix}`);\n        return;\n      }\n\n      await this.serverStaticProvider.createStaticServer({\n        path: prefix,\n        root,\n      });\n    }\n\n    this.serverRouterProvider.createRoute({\n      method: \"GET\",\n      path: `${prefix}/swagger-initializer.js`,\n      handler: ({ reply }) => {\n        reply.headers[\"content-type\"] = \"application/javascript; charset=utf-8\";\n        return initializer;\n      },\n    });\n\n    this.log.info(\"SwaggerUI OK\", {\n      url: `${this.serverProvider.hostname}${prefix}`,\n    });\n  }\n\n  protected async getAssetPath(\n    ...paths: (string | undefined)[]\n  ): Promise<string | undefined> {\n    for (const path of paths) {\n      if (!path) continue;\n      const exists = await this.fs.exists(path);\n      if (exists) {\n        return path;\n      }\n    }\n  }\n\n  public removePrivateFields<T extends Record<string, any>>(\n    obj: T,\n    excludeList: string[],\n  ): T {\n    if (obj === null || typeof obj !== \"object\") return obj;\n\n    const visited = new WeakSet();\n\n    const traverse = (o: any): void => {\n      if (visited.has(o)) return;\n      visited.add(o);\n\n      if (Array.isArray(o)) {\n        for (let i = 0; i < o.length; i++) {\n          const item = o[i];\n          if (item !== null && typeof item === \"object\") {\n            traverse(item);\n          }\n        }\n      } else {\n        for (const excludeKey of excludeList) {\n          if (excludeKey in o) {\n            delete o[excludeKey];\n          }\n        }\n        for (const key in o) {\n          const item = o[key];\n          if (item !== null && typeof item === \"object\") {\n            traverse(item);\n          }\n        }\n      }\n    };\n\n    traverse(obj);\n    return obj;\n  }\n}\n","import \"alepha/security\";\nimport { $module } from \"alepha\";\nimport { AlephaServer, type RequestConfigSchema } from \"alepha/server\";\nimport { AlephaServerEtag } from \"alepha/server/etag\";\nimport { AlephaServerStatic } from \"alepha/server/static\";\nimport { $swagger } from \"./primitives/$swagger.ts\";\nimport { ServerSwaggerProvider } from \"./providers/ServerSwaggerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./primitives/$swagger.ts\";\nexport * from \"./providers/ServerSwaggerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha/server\" {\n  interface ActionPrimitiveOptions<TConfig extends RequestConfigSchema> {\n    /**\n     * Short description of the route.\n     */\n    summary?: string;\n\n    /**\n     * Don't include this action in the Swagger documentation.\n     */\n    hide?: boolean;\n\n    /**\n     * Mark this action as deprecated in the documentation.\n     */\n    deprecated?: boolean;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Automatic API documentation generation.\n *\n * **Features:**\n * - Swagger/OpenAPI configuration\n * - Routes: `GET /swagger/ui`, `GET /swagger.json`\n *\n * @module alepha.server.swagger\n */\nexport const AlephaServerSwagger = $module({\n  name: \"alepha.server.swagger\",\n  primitives: [$swagger],\n  services: [ServerSwaggerProvider],\n  register: (alepha) => {\n    alepha.with(AlephaServer);\n    alepha.with(AlephaServerEtag);\n    alepha.with(AlephaServerStatic);\n    alepha.with(ServerSwaggerProvider);\n    alepha.store.push(\"alepha.build.assets\", \"alepha\");\n  },\n});\n"],"mappings":"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"}

package/dist/sms/index.d.ts

@@ -1,6 +1,5 @@
 import { AlephaError, InstantiableClass, KIND, Primitive } from "alepha";
 import { FileSystemProvider } from "alepha/system";
-
 //#region ../../src/sms/providers/SmsProvider.d.ts
 /**
  * SMS provider interface.

package/dist/sms/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/sms/providers/SmsProvider.ts","../../src/sms/errors/SmsError.ts","../../src/sms/primitives/$sms.ts","../../src/sms/providers/LocalSmsProvider.ts","../../src/sms/providers/MemorySmsProvider.ts","../../src/sms/index.ts"],"mappings":";;;;;;;;AAKA;uBAAsB,WAAA;;;;;;WAMJ,IAAA,CAAK,OAAA,EAAS,cAAA,GAAiB,OAAO;AAAA;AAAA,KAG5C,cAAA;EACV,EAAA;EACA,OAAO;AAAA;;;cCdI,QAAA,SAAiB,WAAW;cAC3B,OAAA,UAAiB,KAAA,GAAQ,KAAA;AAAA;;;cCU1B,IAAA;EAAA,WAAiB,mBAAA,GAAmB,YAAA;EAAA;;UAKhC,mBAAA;EACf,IAAA;EACA,QAAA,GAAW,iBAAiB,CAAC,WAAA;AAAA;;;AFTyB;AAGxD;;;;AAES;;;;ACdT;;;;;;cCwCa,YAAA,SAAqB,SAAA,CAAU,mBAAA;EAAA,mBACvB,QAAA,EAAQ,WAAA;EAAA,IAEhB,IAAA;ED1C+B;AAAA;;ECiD7B,IAAA,CAAK,OAAA,EAAS,cAAA,GAAiB,OAAA;EAAA,UAoBlC,SAAA,IAAa,WAAA;AAAA;;;UClER,uBAAA;;AHDjB;;;EGME,SAAS;AAAA;AAAA,cAGE,gBAAA,YAA4B,WAAA;EAAA,mBACpB,GAAA,0BAAG,MAAA;EAAA,mBACH,EAAA,EAAE,kBAAA;EAAA,mBACF,SAAA;cAEP,OAAA,GAAS,uBAAA;EAIR,IAAA,CAAK,OAAA,EAAS,cAAA,GAAiB,OAAA;EA+BrC,aAAA,CAAc,OAAA;IAAW,EAAA;IAAY,OAAA;EAAA;IAC1C,EAAA;IACA,OAAA;IACA,MAAA;EAAA;AAAA;;;UCtDa,SAAA;EACf,EAAA;EACA,OAAA;EACA,MAAA,EAAQ,IAAI;AAAA;AAAA,cAGD,iBAAA,YAA6B,WAAA;EAAA,mBACrB,GAAA,0BAAG,MAAA;EACf,OAAA,EAAS,SAAA;EAEH,IAAA,CAAK,OAAA,EAAS,cAAA,GAAiB,OAAA;EJFvB;;;EAAA,IIkBV,IAAA,IAAQ,SAAA;AAAA;;;;YCZT,KAAA;IACR,aAAA;MACE,EAAA;MACA,QAAA;MACA,SAAA,EAAW,MAAA;MACX,QAAA,EAAU,WAAA;MACV,KAAA;IAAA;IAEF,UAAA;MACE,EAAA;MACA,QAAA;MACA,QAAA,EAAU,WAAA;IAAA;EAAA;AAAA;AJ1BhB;;;;;;;;;;AAAA,cI2Ca,SAAA,mBAAS,OAAA,kBAAA,MAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/sms/providers/SmsProvider.ts","../../src/sms/errors/SmsError.ts","../../src/sms/primitives/$sms.ts","../../src/sms/providers/LocalSmsProvider.ts","../../src/sms/providers/MemorySmsProvider.ts","../../src/sms/index.ts"],"mappings":";;;;;;;;uBAKsB;;;;;;WAMJ,KAAK,SAAS,iBAAiB;;KAGrC;EACV;EACA;;;;cCdW,iBAAiB;EAC5B,YAAY,iBAAiB,QAAQ;;;;cCU1B;aAAiB,sBAAmB;;;UAKhC;EACf;EACA,WAAW,kBAAkB;;;;;;;;;;;;;;;;;;;cAsBlB,qBAAqB,UAAU;qBACvB,UAAQ;MAEhB;;;;EAOE,KAAK,SAAS,iBAAiB;YAoBlC,aAAa;;;;UClER;;;;;EAKf;;cAGW,4BAA4B;qBACpB,6BAAG;qBACH,IAAE;qBACF;EAEnB,YAAY,UAAS;EAIR,KAAK,SAAS,iBAAiB;EA+BrC,cAAc;IAAW;IAAY;;IAC1C;IACA;IACA;;;;;UCtDa;EACf;EACA;EACA,QAAQ;;cAGG,6BAA6B;qBACrB,6BAAG;EACf,SAAS;EAEH,KAAK,SAAS,iBAAiB;;;;MAgBjC,QAAQ;;;;;YCZT;IACR;MACE;MACA;MACA,WAAW;MACX,UAAU;MACV;;IAEF;MACE;MACA;MACA,UAAU;;;;;;;;;;;;;;cAiBH,4BAAS,yBAAA"}

package/dist/sms/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/sms/providers/MemorySmsProvider.ts","../../src/sms/providers/SmsProvider.ts","../../src/sms/primitives/$sms.ts","../../src/sms/errors/SmsError.ts","../../src/sms/providers/LocalSmsProvider.ts","../../src/sms/index.ts"],"sourcesContent":["import { $logger } from \"alepha/logger\";\nimport type { SmsProvider, SmsSendOptions } from \"./SmsProvider.ts\";\n\nexport interface SmsRecord {\n  to: string;\n  message: string;\n  sentAt: Date;\n}\n\nexport class MemorySmsProvider implements SmsProvider {\n  protected readonly log = $logger();\n  public records: SmsRecord[] = [];\n\n  public async send(options: SmsSendOptions): Promise<void> {\n    const { to, message } = options;\n    this.log.debug(\"Sending SMS to memory store\", { to, message });\n\n    for (const recipient of Array.isArray(to) ? to : [to]) {\n      this.records.push({\n        to: recipient,\n        message,\n        sentAt: new Date(),\n      });\n    }\n  }\n\n  /**\n   * Get the last SMS sent (for testing purposes).\n   */\n  public get last(): SmsRecord | undefined {\n    return this.records[this.records.length - 1];\n  }\n}\n","/**\n * SMS provider interface.\n *\n * All methods are asynchronous and return promises.\n */\nexport abstract class SmsProvider {\n  /**\n   * Send an SMS.\n   *\n   * @return Promise that resolves when the SMS is sent.\n   */\n  public abstract send(options: SmsSendOptions): Promise<void>;\n}\n\nexport type SmsSendOptions = {\n  to: string | string[];\n  message: string;\n};\n","import {\n  AlephaError,\n  createPrimitive,\n  type InstantiableClass,\n  KIND,\n  Primitive,\n} from \"alepha\";\nimport { MemorySmsProvider } from \"../providers/MemorySmsProvider.ts\";\nimport type { SmsSendOptions } from \"../providers/SmsProvider.ts\";\nimport { SmsProvider } from \"../providers/SmsProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const $sms = (options: SmsPrimitiveOptions = {}) =>\n  createPrimitive(SmsPrimitive, options);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface SmsPrimitiveOptions {\n  name?: string;\n  provider?: InstantiableClass<SmsProvider> | \"memory\";\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * SMS primitive for sending SMS messages through various providers.\n *\n * Usage:\n * ```typescript\n * class MyService {\n *   private readonly welcomeSms = $sms({ name: \"welcome\" });\n *\n *   async sendWelcome(phoneNumber: string, userName: string) {\n *     await this.welcomeSms.send({\n *       to: phoneNumber,\n *       message: `Hello ${userName}! Welcome to our service.`\n *     });\n *   }\n * }\n * ```\n */\nexport class SmsPrimitive extends Primitive<SmsPrimitiveOptions> {\n  protected readonly provider = this.$provider();\n\n  public get name() {\n    return this.options.name ?? `${this.config.propertyKey}`;\n  }\n\n  /**\n   * Send an SMS using the configured provider.\n   */\n  public async send(options: SmsSendOptions): Promise<void> {\n    await this.alepha.events.emit(\"sms:sending\", {\n      to: options.to,\n      template: this.name,\n      variables: {},\n      provider: this.provider,\n      abort: () => {\n        throw new AlephaError(\"SMS sending aborted by hook\");\n      },\n    });\n\n    await this.provider.send(options);\n\n    await this.alepha.events.emit(\"sms:sent\", {\n      to: options.to,\n      template: this.name,\n      provider: this.provider,\n    });\n  }\n\n  protected $provider(): SmsProvider {\n    if (!this.options.provider) {\n      return this.alepha.inject(SmsProvider);\n    }\n    if (this.options.provider === \"memory\") {\n      return this.alepha.inject(MemorySmsProvider);\n    }\n    return this.alepha.inject(this.options.provider);\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n$sms[KIND] = SmsPrimitive;\n","import { AlephaError } from \"alepha\";\n\nexport class SmsError extends AlephaError {\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = \"SmsError\";\n    this.cause = cause;\n  }\n}\n","import { $inject } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { FileSystemProvider } from \"alepha/system\";\nimport { SmsError } from \"../errors/SmsError.ts\";\nimport type { SmsProvider, SmsSendOptions } from \"./SmsProvider.ts\";\n\nexport interface LocalSmsProviderOptions {\n  /**\n   * Directory to save SMS files.\n   * @default \"node_modules/.alepha/sms\" (relative to project root)\n   */\n  directory?: string;\n}\n\nexport class LocalSmsProvider implements SmsProvider {\n  protected readonly log = $logger();\n  protected readonly fs = $inject(FileSystemProvider);\n  protected readonly directory: string;\n\n  constructor(options: LocalSmsProviderOptions = {}) {\n    this.directory = options.directory ?? \"node_modules/.alepha/sms\";\n  }\n\n  public async send(options: SmsSendOptions): Promise<void> {\n    const { to, message } = options;\n\n    this.log.debug(\"Sending SMS to local file\", {\n      to,\n      message,\n      directory: this.directory,\n    });\n\n    try {\n      // Ensure directory exists\n      await this.fs.mkdir(this.directory, { recursive: true });\n\n      const timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n      for (const recipient of Array.isArray(to) ? to : [to]) {\n        const sanitizedPhone = recipient.replace(/[^0-9+]/g, \"_\");\n        const filename = `${sanitizedPhone},${timestamp}.sms.json`;\n        const filepath = this.fs.join(this.directory, filename);\n\n        const content = this.createSmsJson({ to: recipient, message });\n        await this.fs.writeFile(filepath, JSON.stringify(content, null, 2));\n\n        this.log.info(\"SMS saved to local file\", { filepath, to });\n      }\n    } catch (error) {\n      const message = `Failed to save SMS to local file: ${error instanceof Error ? error.message : String(error)}`;\n      this.log.error(message, { to, directory: this.directory });\n      throw new SmsError(message, error instanceof Error ? error : undefined);\n    }\n  }\n\n  public createSmsJson(options: { to: string; message: string }): {\n    to: string;\n    message: string;\n    sentAt: string;\n  } {\n    return {\n      to: options.to,\n      message: options.message,\n      sentAt: new Date().toISOString(),\n    };\n  }\n}\n","import { $module } from \"alepha\";\nimport { $sms } from \"./primitives/$sms.ts\";\nimport { LocalSmsProvider } from \"./providers/LocalSmsProvider.ts\";\nimport { MemorySmsProvider } from \"./providers/MemorySmsProvider.ts\";\nimport { SmsProvider } from \"./providers/SmsProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./errors/SmsError.ts\";\nexport * from \"./primitives/$sms.ts\";\nexport * from \"./providers/LocalSmsProvider.ts\";\nexport * from \"./providers/MemorySmsProvider.ts\";\nexport * from \"./providers/SmsProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface Hooks {\n    \"sms:sending\": {\n      to: string | string[];\n      template: string;\n      variables: Record<string, unknown>;\n      provider: SmsProvider;\n      abort(): void;\n    };\n    \"sms:sent\": {\n      to: string | string[];\n      template: string;\n      provider: SmsProvider;\n    };\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * SMS delivery with multiple provider support.\n *\n * **Features:**\n * - Send SMS with templates\n * - Multiple recipients\n * - Provider abstraction\n *\n * @module alepha.sms\n */\nexport const AlephaSms = $module({\n  name: \"alepha.sms\",\n  primitives: [$sms],\n  services: [SmsProvider, MemorySmsProvider, LocalSmsProvider],\n  register: (alepha) =>\n    alepha.with({\n      optional: true,\n      provide: SmsProvider,\n      use: MemorySmsProvider,\n    }),\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/sms/providers/MemorySmsProvider.ts","../../src/sms/providers/SmsProvider.ts","../../src/sms/primitives/$sms.ts","../../src/sms/errors/SmsError.ts","../../src/sms/providers/LocalSmsProvider.ts","../../src/sms/index.ts"],"sourcesContent":["import { $logger } from \"alepha/logger\";\nimport type { SmsProvider, SmsSendOptions } from \"./SmsProvider.ts\";\n\nexport interface SmsRecord {\n  to: string;\n  message: string;\n  sentAt: Date;\n}\n\nexport class MemorySmsProvider implements SmsProvider {\n  protected readonly log = $logger();\n  public records: SmsRecord[] = [];\n\n  public async send(options: SmsSendOptions): Promise<void> {\n    const { to, message } = options;\n    this.log.debug(\"Sending SMS to memory store\", { to, message });\n\n    for (const recipient of Array.isArray(to) ? to : [to]) {\n      this.records.push({\n        to: recipient,\n        message,\n        sentAt: new Date(),\n      });\n    }\n  }\n\n  /**\n   * Get the last SMS sent (for testing purposes).\n   */\n  public get last(): SmsRecord | undefined {\n    return this.records[this.records.length - 1];\n  }\n}\n","/**\n * SMS provider interface.\n *\n * All methods are asynchronous and return promises.\n */\nexport abstract class SmsProvider {\n  /**\n   * Send an SMS.\n   *\n   * @return Promise that resolves when the SMS is sent.\n   */\n  public abstract send(options: SmsSendOptions): Promise<void>;\n}\n\nexport type SmsSendOptions = {\n  to: string | string[];\n  message: string;\n};\n","import {\n  AlephaError,\n  createPrimitive,\n  type InstantiableClass,\n  KIND,\n  Primitive,\n} from \"alepha\";\nimport { MemorySmsProvider } from \"../providers/MemorySmsProvider.ts\";\nimport type { SmsSendOptions } from \"../providers/SmsProvider.ts\";\nimport { SmsProvider } from \"../providers/SmsProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const $sms = (options: SmsPrimitiveOptions = {}) =>\n  createPrimitive(SmsPrimitive, options);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface SmsPrimitiveOptions {\n  name?: string;\n  provider?: InstantiableClass<SmsProvider> | \"memory\";\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * SMS primitive for sending SMS messages through various providers.\n *\n * Usage:\n * ```typescript\n * class MyService {\n *   private readonly welcomeSms = $sms({ name: \"welcome\" });\n *\n *   async sendWelcome(phoneNumber: string, userName: string) {\n *     await this.welcomeSms.send({\n *       to: phoneNumber,\n *       message: `Hello ${userName}! Welcome to our service.`\n *     });\n *   }\n * }\n * ```\n */\nexport class SmsPrimitive extends Primitive<SmsPrimitiveOptions> {\n  protected readonly provider = this.$provider();\n\n  public get name() {\n    return this.options.name ?? `${this.config.propertyKey}`;\n  }\n\n  /**\n   * Send an SMS using the configured provider.\n   */\n  public async send(options: SmsSendOptions): Promise<void> {\n    await this.alepha.events.emit(\"sms:sending\", {\n      to: options.to,\n      template: this.name,\n      variables: {},\n      provider: this.provider,\n      abort: () => {\n        throw new AlephaError(\"SMS sending aborted by hook\");\n      },\n    });\n\n    await this.provider.send(options);\n\n    await this.alepha.events.emit(\"sms:sent\", {\n      to: options.to,\n      template: this.name,\n      provider: this.provider,\n    });\n  }\n\n  protected $provider(): SmsProvider {\n    if (!this.options.provider) {\n      return this.alepha.inject(SmsProvider);\n    }\n    if (this.options.provider === \"memory\") {\n      return this.alepha.inject(MemorySmsProvider);\n    }\n    return this.alepha.inject(this.options.provider);\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n$sms[KIND] = SmsPrimitive;\n","import { AlephaError } from \"alepha\";\n\nexport class SmsError extends AlephaError {\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = \"SmsError\";\n    this.cause = cause;\n  }\n}\n","import { $inject } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { FileSystemProvider } from \"alepha/system\";\nimport { SmsError } from \"../errors/SmsError.ts\";\nimport type { SmsProvider, SmsSendOptions } from \"./SmsProvider.ts\";\n\nexport interface LocalSmsProviderOptions {\n  /**\n   * Directory to save SMS files.\n   * @default \"node_modules/.alepha/sms\" (relative to project root)\n   */\n  directory?: string;\n}\n\nexport class LocalSmsProvider implements SmsProvider {\n  protected readonly log = $logger();\n  protected readonly fs = $inject(FileSystemProvider);\n  protected readonly directory: string;\n\n  constructor(options: LocalSmsProviderOptions = {}) {\n    this.directory = options.directory ?? \"node_modules/.alepha/sms\";\n  }\n\n  public async send(options: SmsSendOptions): Promise<void> {\n    const { to, message } = options;\n\n    this.log.debug(\"Sending SMS to local file\", {\n      to,\n      message,\n      directory: this.directory,\n    });\n\n    try {\n      // Ensure directory exists\n      await this.fs.mkdir(this.directory, { recursive: true });\n\n      const timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n      for (const recipient of Array.isArray(to) ? to : [to]) {\n        const sanitizedPhone = recipient.replace(/[^0-9+]/g, \"_\");\n        const filename = `${sanitizedPhone},${timestamp}.sms.json`;\n        const filepath = this.fs.join(this.directory, filename);\n\n        const content = this.createSmsJson({ to: recipient, message });\n        await this.fs.writeFile(filepath, JSON.stringify(content, null, 2));\n\n        this.log.info(\"SMS saved to local file\", { filepath, to });\n      }\n    } catch (error) {\n      const message = `Failed to save SMS to local file: ${error instanceof Error ? error.message : String(error)}`;\n      this.log.error(message, { to, directory: this.directory });\n      throw new SmsError(message, error instanceof Error ? error : undefined);\n    }\n  }\n\n  public createSmsJson(options: { to: string; message: string }): {\n    to: string;\n    message: string;\n    sentAt: string;\n  } {\n    return {\n      to: options.to,\n      message: options.message,\n      sentAt: new Date().toISOString(),\n    };\n  }\n}\n","import { $module } from \"alepha\";\nimport { $sms } from \"./primitives/$sms.ts\";\nimport { LocalSmsProvider } from \"./providers/LocalSmsProvider.ts\";\nimport { MemorySmsProvider } from \"./providers/MemorySmsProvider.ts\";\nimport { SmsProvider } from \"./providers/SmsProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./errors/SmsError.ts\";\nexport * from \"./primitives/$sms.ts\";\nexport * from \"./providers/LocalSmsProvider.ts\";\nexport * from \"./providers/MemorySmsProvider.ts\";\nexport * from \"./providers/SmsProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface Hooks {\n    \"sms:sending\": {\n      to: string | string[];\n      template: string;\n      variables: Record<string, unknown>;\n      provider: SmsProvider;\n      abort(): void;\n    };\n    \"sms:sent\": {\n      to: string | string[];\n      template: string;\n      provider: SmsProvider;\n    };\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * SMS delivery with multiple provider support.\n *\n * **Features:**\n * - Send SMS with templates\n * - Multiple recipients\n * - Provider abstraction\n *\n * @module alepha.sms\n */\nexport const AlephaSms = $module({\n  name: \"alepha.sms\",\n  primitives: [$sms],\n  services: [SmsProvider, MemorySmsProvider, LocalSmsProvider],\n  register: (alepha) =>\n    alepha.with({\n      optional: true,\n      provide: SmsProvider,\n      use: MemorySmsProvider,\n    }),\n});\n"],"mappings":"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"}