viyv-db-core 0.1.0 → 0.3.0

package/dist/errors.d.ts

@@ -20,4 +20,9 @@ export declare class SqlValidationError extends ViyvDbError {
 export declare class SemanticSearchNotEnabledError extends ViyvDbError {
     constructor();
 }
+export declare class RateLimitError extends ViyvDbError {
+    readonly retryAfterMs: number;
+    readonly limit: number;
+    constructor(retryAfterMs: number, limit: number);
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;aAGpB,IAAI,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM;CAK7B;AAED,qBAAa,iBAAkB,SAAQ,WAAW;gBACrC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAOhE;AAED,qBAAa,kBAAmB,SAAQ,WAAW;gBACtC,KAAK,EAAE,MAAM;CAIzB;AAED,qBAAa,gBAAiB,SAAQ,WAAW;gBACpC,KAAK,EAAE,MAAM;CAOzB;AAED,qBAAa,cAAe,SAAQ,WAAW;gBAClC,OAAO,EAAE,MAAM;CAI3B;AAED,qBAAa,kBAAmB,SAAQ,WAAW;gBACtC,OAAO,EAAE,MAAM;CAI3B;AAED,qBAAa,6BAA8B,SAAQ,WAAW;;CAK7D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;aAGpB,IAAI,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM;CAK7B;AAED,qBAAa,iBAAkB,SAAQ,WAAW;gBACrC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAOhE;AAED,qBAAa,kBAAmB,SAAQ,WAAW;gBACtC,KAAK,EAAE,MAAM;CAIzB;AAED,qBAAa,gBAAiB,SAAQ,WAAW;gBACpC,KAAK,EAAE,MAAM;CAOzB;AAED,qBAAa,cAAe,SAAQ,WAAW;gBAClC,OAAO,EAAE,MAAM;CAI3B;AAED,qBAAa,kBAAmB,SAAQ,WAAW;gBACtC,OAAO,EAAE,MAAM;CAI3B;AAED,qBAAa,6BAA8B,SAAQ,WAAW;;CAK7D;AAED,qBAAa,cAAe,SAAQ,WAAW;aAE7B,YAAY,EAAE,MAAM;aACpB,KAAK,EAAE,MAAM;gBADb,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM;CAQ9B"}

package/dist/errors.js

@@ -42,4 +42,14 @@ export class SemanticSearchNotEnabledError extends ViyvDbError {
         this.name = 'SemanticSearchNotEnabledError';
     }
 }
+export class RateLimitError extends ViyvDbError {
+    retryAfterMs;
+    limit;
+    constructor(retryAfterMs, limit) {
+        super(`Rate limit exceeded (limit: ${limit} requests/window). Retry after ${retryAfterMs}ms`, 'RATE_LIMIT_EXCEEDED');
+        this.retryAfterMs = retryAfterMs;
+        this.limit = limit;
+        this.name = 'RateLimitError';
+    }
+}
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGpB;IAFjB,YACC,OAAe,EACC,IAAY;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAJ,IAAI,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC3B,CAAC;CACD;AAED,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IACjD,YAAY,SAAiB,EAAE,QAAgB,EAAE,OAAe;QAC/D,KAAK,CACJ,mBAAmB,SAAS,eAAe,QAAQ,sBAAsB,OAAO,GAAG,EACnF,eAAe,CACf,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACjC,CAAC;CACD;AAED,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IAClD,YAAY,KAAa;QACxB,KAAK,CAAC,qBAAqB,KAAK,GAAG,EAAE,iBAAiB,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IAClC,CAAC;CACD;AAED,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAChD,YAAY,KAAa;QACxB,KAAK,CACJ,gCAAgC,KAAK,0DAA0D,EAC/F,cAAc,CACd,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IAChC,CAAC;CACD;AAED,MAAM,OAAO,cAAe,SAAQ,WAAW;IAC9C,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC9B,CAAC;CACD;AAED,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IAClD,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IAClC,CAAC;CACD;AAED,MAAM,OAAO,6BAA8B,SAAQ,WAAW;IAC7D;QACC,KAAK,CAAC,gDAAgD,EAAE,6BAA6B,CAAC,CAAC;QACvF,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC7C,CAAC;CACD"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGpB;IAFjB,YACC,OAAe,EACC,IAAY;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAJ,IAAI,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC3B,CAAC;CACD;AAED,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IACjD,YAAY,SAAiB,EAAE,QAAgB,EAAE,OAAe;QAC/D,KAAK,CACJ,mBAAmB,SAAS,eAAe,QAAQ,sBAAsB,OAAO,GAAG,EACnF,eAAe,CACf,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACjC,CAAC;CACD;AAED,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IAClD,YAAY,KAAa;QACxB,KAAK,CAAC,qBAAqB,KAAK,GAAG,EAAE,iBAAiB,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IAClC,CAAC;CACD;AAED,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAChD,YAAY,KAAa;QACxB,KAAK,CACJ,gCAAgC,KAAK,0DAA0D,EAC/F,cAAc,CACd,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IAChC,CAAC;CACD;AAED,MAAM,OAAO,cAAe,SAAQ,WAAW;IAC9C,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC9B,CAAC;CACD;AAED,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IAClD,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IAClC,CAAC;CACD;AAED,MAAM,OAAO,6BAA8B,SAAQ,WAAW;IAC7D;QACC,KAAK,CAAC,gDAAgD,EAAE,6BAA6B,CAAC,CAAC;QACvF,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC7C,CAAC;CACD;AAED,MAAM,OAAO,cAAe,SAAQ,WAAW;IAE7B;IACA;IAFjB,YACiB,YAAoB,EACpB,KAAa;QAE7B,KAAK,CACJ,+BAA+B,KAAK,kCAAkC,YAAY,IAAI,EACtF,qBAAqB,CACrB,CAAC;QANc,iBAAY,GAAZ,YAAY,CAAQ;QACpB,UAAK,GAAL,KAAK,CAAQ;QAM7B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC9B,CAAC;CACD"}

package/dist/index.d.ts

@@ -9,4 +9,5 @@ export { classifySql } from './sql-classifier.js';
 export type { SqlType } from './sql-classifier.js';
 export * from './auth/index.js';
 export * from './embedding.js';
+export * from './rate-limit.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACrF,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7E,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACrF,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7E,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -6,4 +6,5 @@ export { BaseConfigSchema, AccessLevelSchema, hasAccess } from './config.js';
 export { classifySql } from './sql-classifier.js';
 export * from './auth/index.js';
 export * from './embedding.js';
+export * from './rate-limit.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7E,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7E,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}

package/dist/rate-limit.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Rate limit check result (discriminated union, same pattern as AccessDecision).
+ */
+export type RateLimitDecision = {
+    readonly allowed: true;
+    readonly remaining: number;
+    readonly resetMs: number;
+} | {
+    readonly allowed: false;
+    readonly retryAfterMs: number;
+    readonly limit: number;
+};
+/**
+ * Rate limiter interface.
+ * Async to support both in-memory and external stores (Redis, etc.).
+ * `close()` is intentionally not part of this interface — resource management
+ * is an infrastructure concern, not a domain concern. Concrete implementations
+ * in the server package may add `close()` as needed.
+ */
+export interface IRateLimiter {
+    check(key: string): Promise<RateLimitDecision>;
+}
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../src/rate-limit.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAC1B;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAChF;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC5B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/C"}

package/dist/rate-limit.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rate-limit.js.map

package/dist/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../src/rate-limit.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,40 +1,47 @@
 {
-  "name": "viyv-db-core",
-  "version": "0.1.0",
-  "type": "module",
-  "description": "Core types and interfaces for viyv-db",
-  "license": "MIT",
-  "author": "viyv",
-  "engines": {
-    "node": ">=20"
-  },
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    },
-    "./rpc": {
-      "types": "./dist/rpc.d.ts",
-      "default": "./dist/rpc.js"
-    }
-  },
-  "files": [
-    "dist",
-    "!dist/__tests__"
-  ],
-  "dependencies": {
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.7.0",
-    "vitest": "^2.1.0"
-  },
-  "scripts": {
-    "build": "tsc",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "clean": "rm -rf dist"
-  }
-}
+	"name": "viyv-db-core",
+	"version": "0.3.0",
+	"type": "module",
+	"description": "Core types and interfaces for viyv-db",
+	"license": "MIT",
+	"author": "viyv",
+	"engines": { "node": ">=20" },
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"development": "./src/index.ts",
+			"default": "./dist/index.js"
+		},
+		"./rpc": {
+			"development": "./src/rpc.ts",
+			"default": "./dist/rpc.js"
+		}
+	},
+	"publishConfig": {
+		"exports": {
+			".": {
+				"types": "./dist/index.d.ts",
+				"default": "./dist/index.js"
+			},
+			"./rpc": {
+				"types": "./dist/rpc.d.ts",
+				"default": "./dist/rpc.js"
+			}
+		}
+	},
+	"files": ["dist", "!dist/__tests__"],
+	"scripts": {
+		"build": "tsc",
+		"typecheck": "tsc --noEmit",
+		"test": "vitest run",
+		"clean": "rm -rf dist"
+	},
+	"dependencies": {
+		"zod": "^3.23.0"
+	},
+	"devDependencies": {
+		"typescript": "^5.7.0",
+		"vitest": "^2.1.0"
+	}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 viyv
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.