sashiko 0.1.0 → 0.3.0

package/dist/utils/content-type.js

@@ -2,6 +2,48 @@
 export function mediaType(header) {
     return header ? header.split(';', 1)[0].trim().toLowerCase() : '';
 }
+/**
+ * Escolhe, entre os tipos `available` (em ordem de preferência do servidor), o melhor para o
+ * header `Accept` (F-31). Respeita q-values e curingas (`text/*`, `*\/*`). Sem `Accept`,
+ * devolve o primeiro. Retorna `undefined` quando nenhum é aceitável (→ 406).
+ */
+export function negotiate(accept, available) {
+    if (!accept || !accept.trim())
+        return available[0];
+    const ranges = accept
+        .split(',')
+        .map((part, index) => {
+        const [range = '', ...params] = part.trim().toLowerCase().split(';');
+        const q = Number(params.map((p) => p.trim()).find((p) => p.startsWith('q='))?.slice(2) ?? '1');
+        return { range: range.trim(), q: Number.isFinite(q) ? q : 1, index };
+    })
+        .filter((r) => r.range && r.q > 0)
+        .sort((a, b) => b.q - a.q || specificity(b.range) - specificity(a.range) || a.index - b.index);
+    for (const { range } of ranges) {
+        const match = available.find((type) => matches(range, mediaType(type)));
+        if (match)
+            return match;
+    }
+    return undefined;
+}
+function specificity(range) {
+    if (range === '*/*')
+        return 0;
+    return range.endsWith('/*') ? 1 : 2;
+}
+function matches(range, type) {
+    if (range === '*/*' || range === type)
+        return true;
+    return range.endsWith('/*') && type.startsWith(range.slice(0, -1));
+}
+/** Acrescenta `charset=utf-8` a tipos textuais sem charset. */
+export function withCharset(type) {
+    if (/;\s*charset=/i.test(type))
+        return type;
+    const base = mediaType(type);
+    const textual = base.startsWith('text/') || isJsonContentType(base) || /\+xml$|\/xml$|yaml$/.test(base);
+    return textual ? `${type}; charset=utf-8` : type;
+}
 /** `application/json` ou `application/*+json`, com parâmetros opcionais (B-11). */
 export function isJsonContentType(header) {
     const type = mediaType(header);

package/dist/utils/content-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"content-type.js","sourceRoot":"","sources":["../../src/utils/content-type.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAC7G,MAAM,UAAU,SAAS,CAAC,MAA0B;IAClD,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACrE,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,iBAAiB,CAAC,MAA0B;IAC1D,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,OAAO,IAAI,KAAK,kBAAkB,IAAI,wCAAwC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5F,CAAC"}
+{"version":3,"file":"content-type.js","sourceRoot":"","sources":["../../src/utils/content-type.ts"],"names":[],"mappings":"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"}

package/dist/utils/index.d.ts

@@ -1,4 +1,4 @@
-export { isJsonContentType, mediaType } from './content-type.ts';
+export { isJsonContentType, mediaType, negotiate, withCharset } from './content-type.ts';
 export { joinPaths } from './path.ts';
 export { DEFAULT_MAX_QUERY_KEYS, parseQuery, type ParsedQuery } from './query.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/index.js

@@ -1,4 +1,4 @@
-export { isJsonContentType, mediaType } from './content-type.js';
+export { isJsonContentType, mediaType, negotiate, withCharset } from './content-type.js';
 export { joinPaths } from './path.js';
 export { DEFAULT_MAX_QUERY_KEYS, parseQuery } from './query.js';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAoB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAoB,MAAM,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sashiko",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Micro-framework HTTP para Node.js com decorators TC39 nativos, schema-first (TypeBox + Ajv) e defaults seguros.",
   "keywords": [
     "http",

package/dist/decorators/use.d.ts

@@ -1,26 +0,0 @@
-import type { Middleware } from '../core/compose.ts';
-import type { Guard } from '../core/guard.ts';
-type ClassOrMethodContext = ClassDecoratorContext | ClassMethodDecoratorContext;
-/**
- * Middlewares por classe ou por rota (F-01). Rodam depois dos globais e antes dos guards.
- *
- * ```ts
- * @Use(rateLimit({ max: 10 }))          // todas as rotas da classe
- * @Router('/auth')
- * class AuthRoutes {
- *   @Use(audit) @Post('/login') login() {}
- * }
- * ```
- */
-export declare function Use(...middlewares: Middleware[]): (_value: unknown, context: ClassOrMethodContext) => void;
-/**
- * Guards por classe ou por rota (F-01). Rodam antes da validação; `false` responde 403.
- *
- * ```ts
- * const isAdmin: Guard = (ctx) => ctx.state.user?.role === 'admin';
- * @UseGuards(isAdmin) @Delete('/:id') remove() {}
- * ```
- */
-export declare function UseGuards(...guards: Guard[]): (_value: unknown, context: ClassOrMethodContext) => void;
-export {};
-//# sourceMappingURL=use.d.ts.map

package/dist/decorators/use.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"use.d.ts","sourceRoot":"","sources":["../../src/decorators/use.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C,KAAK,oBAAoB,GAAG,qBAAqB,GAAG,2BAA2B,CAAC;AAchF;;;;;;;;;;GAUG;AACH,wBAAgB,GAAG,CAAC,GAAG,WAAW,EAAE,UAAU,EAAE,YAlBrB,OAAO,WAAW,oBAAoB,KAAG,IAAI,CAoBvE;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,YA9BjB,OAAO,WAAW,oBAAoB,KAAG,IAAI,CAgCvE"}

package/dist/decorators/use.js

@@ -1,38 +0,0 @@
-import { getOrCreateMethod, metadataFor } from '../core/metadata.js';
-/**
- * Aplica `items` na classe (todas as rotas) ou no método. Decorators são avaliados de baixo para
- * cima; inserimos no início para que a ordem de execução siga a ordem de leitura (de cima para baixo).
- */
-function register(decorator, pick, items) {
-    return function (_value, context) {
-        const meta = metadataFor(context, decorator);
-        const target = context.kind === 'class' ? meta : getOrCreateMethod(meta, context.name);
-        target[pick].unshift(...items);
-    };
-}
-/**
- * Middlewares por classe ou por rota (F-01). Rodam depois dos globais e antes dos guards.
- *
- * ```ts
- * @Use(rateLimit({ max: 10 }))          // todas as rotas da classe
- * @Router('/auth')
- * class AuthRoutes {
- *   @Use(audit) @Post('/login') login() {}
- * }
- * ```
- */
-export function Use(...middlewares) {
-    return register('Use', 'middlewares', middlewares);
-}
-/**
- * Guards por classe ou por rota (F-01). Rodam antes da validação; `false` responde 403.
- *
- * ```ts
- * const isAdmin: Guard = (ctx) => ctx.state.user?.role === 'admin';
- * @UseGuards(isAdmin) @Delete('/:id') remove() {}
- * ```
- */
-export function UseGuards(...guards) {
-    return register('UseGuards', 'guards', guards);
-}
-//# sourceMappingURL=use.js.map

package/dist/decorators/use.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"use.js","sourceRoot":"","sources":["../../src/decorators/use.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIrE;;;GAGG;AACH,SAAS,QAAQ,CAAC,SAAiB,EAAE,IAA8B,EAAE,KAAyB;IAC5F,OAAO,UAAU,MAAe,EAAE,OAA6B;QAC7D,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACtF,MAAM,CAAC,IAAI,CAAe,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,GAAG,CAAC,GAAG,WAAyB;IAC9C,OAAO,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,GAAG,MAAe;IAC1C,OAAO,QAAQ,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC"}