@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/storage/quota/UsageTrackingStore.js

@@ -0,0 +1,355 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageTrackingStore = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+const node_stream_1 = require("node:stream");
+const community_server_1 = require("@solid/community-server");
+const db_1 = require("../../identity/drizzle/db");
+const PodLookupRepository_1 = require("../../identity/drizzle/PodLookupRepository");
+const UsageRepository_1 = require("./UsageRepository");
+const BandwidthThrottleTransform_1 = require("../../util/stream/BandwidthThrottleTransform");
+class UsageTrackingStore extends community_server_1.PassthroughStore {
+    constructor(source, options) {
+        super(source);
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.defaultBandwidthLimit = this.normalizeLimit(options.defaultAccountBandwidthLimitBps);
+        if (options.identityDbUrl) {
+            const db = (0, db_1.getIdentityDatabase)(options.identityDbUrl);
+            this.podLookup = new PodLookupRepository_1.PodLookupRepository(db);
+            this.usageRepo = new UsageRepository_1.UsageRepository(db);
+        }
+    }
+    async addResource(container, representation, conditions) {
+        const context = await this.resolveContext(container);
+        if (!context) {
+            return super.addResource(container, representation, conditions);
+        }
+        const previousSize = await this.getExistingSize(container);
+        const limit = await this.resolveBandwidthLimit(context);
+        const { wrapped, sizePromise } = this.measureRepresentation(representation, limit);
+        const change = await super.addResource(container, wrapped, conditions);
+        await this.applyMeasuredWriteUsage(context, previousSize, representation, sizePromise);
+        return change;
+    }
+    async setRepresentation(identifier, representation, conditions) {
+        const context = await this.resolveContext(identifier);
+        if (!context) {
+            return super.setRepresentation(identifier, representation, conditions);
+        }
+        const previousSize = await this.getExistingSize(identifier);
+        const limit = await this.resolveBandwidthLimit(context);
+        const { wrapped, sizePromise } = this.measureRepresentation(representation, limit);
+        const change = await super.setRepresentation(identifier, wrapped, conditions);
+        await this.applyMeasuredWriteUsage(context, previousSize, representation, sizePromise);
+        return change;
+    }
+    async getRepresentation(identifier, preferences, conditions) {
+        const representation = await super.getRepresentation(identifier, preferences, conditions);
+        const context = await this.resolveContext(identifier);
+        if (!context || !representation?.data) {
+            return representation;
+        }
+        const limit = await this.resolveBandwidthLimit(context);
+        const { wrapped, sizePromise } = this.measureRepresentation(representation, limit);
+        void sizePromise
+            .then((size) => this.recordBandwidth(context, 0, size))
+            .catch(() => undefined);
+        return wrapped;
+    }
+    async deleteResource(identifier, conditions) {
+        const context = await this.resolveContext(identifier);
+        if (!context) {
+            return super.deleteResource(identifier, conditions);
+        }
+        const previousSize = await this.getExistingSize(identifier);
+        const change = await super.deleteResource(identifier, conditions);
+        await this.applyStorageUpdate(context, previousSize, 0);
+        return change;
+    }
+    measureRepresentation(representation, limit) {
+        if (!representation.data || representation.isEmpty) {
+            return {
+                wrapped: representation,
+                sizePromise: Promise.resolve(this.extractSize(representation)),
+            };
+        }
+        let countedBytes = 0;
+        const binary = representation.binary ?? false;
+        const counter = binary ?
+            new node_stream_1.Transform({
+                transform(chunk, encoding, callback) {
+                    if (chunk instanceof Buffer) {
+                        countedBytes += chunk.length;
+                    }
+                    else if (typeof chunk === 'string') {
+                        countedBytes += Buffer.byteLength(chunk, encoding);
+                    }
+                    callback(null, chunk);
+                },
+            }) :
+            new node_stream_1.Transform({
+                objectMode: true,
+                transform: (chunk, _encoding, callback) => {
+                    countedBytes += UsageTrackingStore.measureObjectChunkSize(chunk);
+                    callback(null, chunk);
+                },
+            });
+        const transforms = [];
+        const normalizedLimit = this.normalizeLimit(limit);
+        if (normalizedLimit) {
+            transforms.push((0, BandwidthThrottleTransform_1.createBandwidthThrottleTransform)({
+                bytesPerSecond: normalizedLimit,
+                objectMode: !binary,
+                measure: binary ?
+                    undefined :
+                    (chunk) => UsageTrackingStore.measureObjectChunkSize(chunk),
+            }));
+        }
+        transforms.push(counter);
+        let instrumented = representation.data;
+        for (const transform of transforms) {
+            instrumented = instrumented.pipe(transform);
+        }
+        const countedStream = (0, community_server_1.guardStream)(instrumented);
+        const sizePromise = new Promise((resolve, reject) => {
+            countedStream.on('end', () => resolve(countedBytes));
+            countedStream.on('close', () => resolve(countedBytes));
+            countedStream.on('error', reject);
+            counter.on('error', reject);
+        });
+        return {
+            wrapped: {
+                ...representation,
+                data: countedStream,
+            },
+            sizePromise: sizePromise.then((size) => (size !== 0 ? size : this.extractSize(representation)))
+                .catch(() => this.extractSize(representation)),
+        };
+    }
+    async applyMeasuredWriteUsage(context, previousSize, representation, sizePromise) {
+        const estimatedSize = Math.max(0, Math.trunc(this.extractSize(representation)));
+        await this.applyStorageUpdate(context, previousSize, estimatedSize);
+        await this.recordBandwidth(context, estimatedSize, 0);
+        if (!context || !this.usageRepo) {
+            return;
+        }
+        void sizePromise
+            .then((measuredSize) => this.reconcileWriteUsage(context, estimatedSize, measuredSize))
+            .catch((error) => this.logger.warn(`Failed to resolve measured write usage: ${String(error)}`));
+    }
+    async reconcileWriteUsage(context, estimatedSize, measuredSize) {
+        if (!this.usageRepo) {
+            return;
+        }
+        const normalizedMeasured = Math.max(0, Math.trunc(measuredSize));
+        const correction = normalizedMeasured - estimatedSize;
+        if (correction === 0) {
+            return;
+        }
+        await this.usageRepo.incrementUsage(context.accountId, context.podId, correction, correction, 0);
+    }
+    extractSize(representation) {
+        const meta = representation;
+        const candidate = meta.metadata?.contentLength;
+        if (typeof candidate === 'number') {
+            return candidate;
+        }
+        if (typeof candidate === 'string') {
+            const parsed = Number(candidate);
+            return Number.isNaN(parsed) ? 0 : parsed;
+        }
+        return 0;
+    }
+    async applyStorageUpdate(context, previousSize, newSize) {
+        if (!context || !this.usageRepo) {
+            return;
+        }
+        const normalizedPrevious = Math.max(0, Math.trunc(previousSize ?? 0));
+        const normalizedNew = Math.max(0, Math.trunc(newSize ?? 0));
+        const delta = normalizedNew - normalizedPrevious;
+        if (delta !== 0) {
+            await this.usageRepo.incrementUsage(context.accountId, context.podId, delta, 0, 0);
+        }
+    }
+    async getExistingSize(identifier) {
+        if (!this.podLookup) {
+            return 0;
+        }
+        try {
+            const representation = await this.source.getRepresentation(identifier, {});
+            return await this.computeRepresentationSize(representation);
+        }
+        catch {
+            return 0;
+        }
+    }
+    async computeRepresentationSize(representation) {
+        if (!representation.data) {
+            return this.extractSize(representation);
+        }
+        const binary = representation.binary ?? false;
+        const stream = representation.data;
+        let countedBytes = 0;
+        return await new Promise((resolve, reject) => {
+            const removeListener = typeof stream.off === 'function' ?
+                (event, handler) => { stream.off(event, handler); } :
+                (event, handler) => { stream.removeListener(event, handler); };
+            const onData = (chunk) => {
+                if (binary) {
+                    if (chunk instanceof Buffer) {
+                        countedBytes += chunk.length;
+                    }
+                    else if (typeof chunk === 'string') {
+                        countedBytes += Buffer.byteLength(chunk);
+                    }
+                }
+                else {
+                    countedBytes += UsageTrackingStore.measureObjectChunkSize(chunk);
+                }
+            };
+            const cleanup = () => {
+                removeListener('data', onData);
+                removeListener('error', onError);
+                removeListener('end', onEnd);
+                removeListener('close', onEnd);
+            };
+            const onEnd = () => {
+                cleanup();
+                resolve(countedBytes !== 0 ? countedBytes : this.extractSize(representation));
+            };
+            const onError = (error) => {
+                cleanup();
+                reject(error);
+            };
+            stream.on('data', onData);
+            stream.once('error', onError);
+            stream.once('end', onEnd);
+            stream.once('close', onEnd);
+            if (typeof stream.resume === 'function') {
+                stream.resume();
+            }
+        }).catch(() => this.extractSize(representation));
+    }
+    async resolveContext(identifier) {
+        if (!this.podLookup) {
+            return undefined;
+        }
+        const pod = await this.podLookup.findByResourceIdentifier(identifier.path);
+        if (!pod) {
+            return undefined;
+        }
+        return {
+            accountId: pod.accountId,
+            podId: pod.podId,
+        };
+    }
+    async resolveBandwidthLimit(context) {
+        if (!this.usageRepo) {
+            return this.defaultBandwidthLimit;
+        }
+        const podRecord = await this.usageRepo.getPodUsage(context.podId);
+        if (podRecord && podRecord.bandwidthLimitBps !== undefined) {
+            return this.normalizeLimit(podRecord.bandwidthLimitBps);
+        }
+        const accountRecord = await this.usageRepo.getAccountUsage(context.accountId);
+        if (accountRecord && accountRecord.bandwidthLimitBps !== undefined) {
+            return this.normalizeLimit(accountRecord.bandwidthLimitBps);
+        }
+        return this.defaultBandwidthLimit;
+    }
+    async recordBandwidth(context, ingress, egress) {
+        if (!context || !this.usageRepo) {
+            return;
+        }
+        const normalizedIngress = this.normalizeBandwidthDelta(ingress);
+        const normalizedEgress = this.normalizeBandwidthDelta(egress);
+        if (normalizedIngress === 0 && normalizedEgress === 0) {
+            return;
+        }
+        await this.usageRepo.incrementUsage(context.accountId, context.podId, 0, normalizedIngress, normalizedEgress);
+    }
+    normalizeLimit(limit) {
+        if (limit == null) {
+            return null;
+        }
+        const numeric = Number(limit);
+        if (!Number.isFinite(numeric) || numeric <= 0) {
+            return null;
+        }
+        return Math.max(0, Math.trunc(numeric));
+    }
+    normalizeBandwidthDelta(value) {
+        if (!Number.isFinite(value) || value <= 0) {
+            return 0;
+        }
+        return Math.trunc(value);
+    }
+    static measureObjectChunkSize(chunk) {
+        if (chunk == null) {
+            return 0;
+        }
+        if (chunk instanceof Buffer) {
+            return chunk.length;
+        }
+        if (typeof chunk === 'string') {
+            return Buffer.byteLength(chunk, 'utf8');
+        }
+        if (UsageTrackingStore.isQuad(chunk)) {
+            const serialized = UsageTrackingStore.quadToNQuads(chunk);
+            return Buffer.byteLength(serialized, 'utf8');
+        }
+        return 0;
+    }
+    static isQuad(candidate) {
+        if (!candidate || typeof candidate !== 'object') {
+            return false;
+        }
+        const quad = candidate;
+        return !!quad.subject && !!quad.predicate && !!quad.object && quad.graph !== undefined;
+    }
+    static quadToNQuads(quad) {
+        const subject = UsageTrackingStore.termToNQuads(quad.subject);
+        const predicate = UsageTrackingStore.termToNQuads(quad.predicate);
+        const object = UsageTrackingStore.termToNQuads(quad.object);
+        const graph = quad.graph.termType === 'DefaultGraph' ? '' : ` ${UsageTrackingStore.termToNQuads(quad.graph)}`;
+        return `${subject} ${predicate} ${object}${graph} .\n`;
+    }
+    static termToNQuads(term) {
+        switch (term.termType) {
+            case 'NamedNode':
+                return `<${term.value}>`;
+            case 'BlankNode':
+                return `_:${term.value}`;
+            case 'Literal':
+                return UsageTrackingStore.literalToNQuads(term);
+            case 'DefaultGraph':
+                return '';
+            default:
+                return `<${term.value}>`;
+        }
+    }
+    static literalToNQuads(literal) {
+        const escaped = UsageTrackingStore.escapeLiteral(literal.value);
+        if (literal.language) {
+            return `"${escaped}"@${literal.language}`;
+        }
+        const datatype = literal.datatype?.value;
+        if (datatype && datatype !== UsageTrackingStore.XSD_STRING) {
+            return `"${escaped}"^^<${datatype}>`;
+        }
+        return `"${escaped}"`;
+    }
+    static escapeLiteral(value) {
+        return value
+            .replace(/\\/g, '\\\\')
+            .replace(/\"/g, '\\"')
+            .replace(/\n/g, '\\n')
+            .replace(/\r/g, '\\r')
+            .replace(/\t/g, '\\t')
+            .replace(/\f/g, '\\f')
+            .replace(/\b/g, '\\b');
+    }
+}
+exports.UsageTrackingStore = UsageTrackingStore;
+UsageTrackingStore.XSD_STRING = 'http://www.w3.org/2001/XMLSchema#string';
+//# sourceMappingURL=UsageTrackingStore.js.map

package/dist/storage/quota/UsageTrackingStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsageTrackingStore.js","sourceRoot":"","sources":["../../../src/storage/quota/UsageTrackingStore.ts"],"names":[],"mappings":"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","sourcesContent":["import { getLoggerFor } from 'global-logger-factory';\nimport { Transform, Readable } from 'node:stream';\nimport {\n  PassthroughStore,\n  guardStream,\n} from '@solid/community-server';\nimport type {\n  ChangeMap,\n  Representation,\n  RepresentationPreferences,\n  ResourceIdentifier,\n  Conditions,\n  ResourceStore,\n} from '@solid/community-server';\nimport type { Quad, Term, Literal } from '@rdfjs/types';\nimport { getIdentityDatabase } from '../../identity/drizzle/db';\nimport { PodLookupRepository } from '../../identity/drizzle/PodLookupRepository';\nimport { UsageRepository } from './UsageRepository';\nimport { createBandwidthThrottleTransform } from '../../util/stream/BandwidthThrottleTransform';\n\ninterface UsageTrackingStoreOptions {\n  identityDbUrl?: string;\n  defaultAccountBandwidthLimitBps?: number | null;\n}\n\ntype UsageContext = {\n  accountId: string;\n  podId: string;\n};\n\nexport class UsageTrackingStore<T extends ResourceStore = ResourceStore> extends PassthroughStore<T> {\n  protected readonly logger = getLoggerFor(this);\n  private readonly usageRepo?: UsageRepository;\n  private readonly podLookup?: PodLookupRepository;\n  private readonly defaultBandwidthLimit?: number | null;\n  private static readonly XSD_STRING = 'http://www.w3.org/2001/XMLSchema#string';\n\n  public constructor(source: T, options: UsageTrackingStoreOptions) {\n    super(source);\n    this.defaultBandwidthLimit = this.normalizeLimit(options.defaultAccountBandwidthLimitBps);\n    if (options.identityDbUrl) {\n      const db = getIdentityDatabase(options.identityDbUrl);\n      this.podLookup = new PodLookupRepository(db);\n      this.usageRepo = new UsageRepository(db);\n    }\n  }\n\n  public override async addResource(container: ResourceIdentifier, representation: Representation, conditions?: Conditions): Promise<ChangeMap> {\n    const context = await this.resolveContext(container);\n    if (!context) {\n      return super.addResource(container, representation, conditions);\n    }\n\n    const previousSize = await this.getExistingSize(container);\n    const limit = await this.resolveBandwidthLimit(context);\n    const { wrapped, sizePromise } = this.measureRepresentation(representation, limit);\n    const change = await super.addResource(container, wrapped, conditions);\n    await this.applyMeasuredWriteUsage(context, previousSize, representation, sizePromise);\n    return change;\n  }\n\n  public override async setRepresentation(identifier: ResourceIdentifier, representation: Representation, conditions?: Conditions): Promise<ChangeMap> {\n    const context = await this.resolveContext(identifier);\n    if (!context) {\n      return super.setRepresentation(identifier, representation, conditions);\n    }\n\n    const previousSize = await this.getExistingSize(identifier);\n    const limit = await this.resolveBandwidthLimit(context);\n    const { wrapped, sizePromise } = this.measureRepresentation(representation, limit);\n    const change = await super.setRepresentation(identifier, wrapped, conditions);\n    await this.applyMeasuredWriteUsage(context, previousSize, representation, sizePromise);\n    return change;\n  }\n\n  public override async getRepresentation(identifier: ResourceIdentifier, preferences: RepresentationPreferences, conditions?: Conditions): Promise<Representation> {\n    const representation = await super.getRepresentation(identifier, preferences, conditions);\n    const context = await this.resolveContext(identifier);\n    if (!context || !representation?.data) {\n      return representation;\n    }\n    const limit = await this.resolveBandwidthLimit(context);\n    const { wrapped, sizePromise } = this.measureRepresentation(representation, limit);\n    void sizePromise\n      .then((size) => this.recordBandwidth(context, 0, size))\n      .catch(() => undefined);\n    return wrapped;\n  }\n\n  public override async deleteResource(identifier: ResourceIdentifier, conditions?: Conditions): Promise<ChangeMap> {\n    const context = await this.resolveContext(identifier);\n    if (!context) {\n      return super.deleteResource(identifier, conditions);\n    }\n\n    const previousSize = await this.getExistingSize(identifier);\n    const change = await super.deleteResource(identifier, conditions);\n    await this.applyStorageUpdate(context, previousSize, 0);\n    return change;\n  }\n\n  private measureRepresentation(representation: Representation, limit?: number | null): { wrapped: Representation; sizePromise: Promise<number> } {\n    if (!representation.data || representation.isEmpty) {\n      return {\n        wrapped: representation,\n        sizePromise: Promise.resolve(this.extractSize(representation)),\n      };\n    }\n\n    let countedBytes = 0;\n    const binary = representation.binary ?? false;\n    const counter = binary ?\n      new Transform({\n        transform(chunk: unknown, encoding, callback): void {\n          if (chunk instanceof Buffer) {\n            countedBytes += chunk.length;\n          } else if (typeof chunk === 'string') {\n            countedBytes += Buffer.byteLength(chunk, encoding);\n          }\n          callback(null, chunk as any);\n        },\n      }) :\n      new Transform({\n        objectMode: true,\n        transform: (chunk: unknown, _encoding, callback): void => {\n          countedBytes += UsageTrackingStore.measureObjectChunkSize(chunk);\n          callback(null, chunk as any);\n        },\n      });\n\n    const transforms: Transform[] = [];\n    const normalizedLimit = this.normalizeLimit(limit);\n    if (normalizedLimit) {\n      transforms.push(createBandwidthThrottleTransform({\n        bytesPerSecond: normalizedLimit,\n        objectMode: !binary,\n        measure: binary ?\n          undefined :\n          (chunk: unknown): number => UsageTrackingStore.measureObjectChunkSize(chunk),\n      }));\n    }\n    transforms.push(counter);\n\n    let instrumented = representation.data as unknown as Readable;\n    for (const transform of transforms) {\n      instrumented = instrumented.pipe(transform) as unknown as Readable;\n    }\n\n    const countedStream = guardStream(instrumented);\n    const sizePromise = new Promise<number>((resolve, reject) => {\n      countedStream.on('end', () => resolve(countedBytes));\n      countedStream.on('close', () => resolve(countedBytes));\n      countedStream.on('error', reject);\n      counter.on('error', reject);\n    });\n\n    return {\n      wrapped: {\n        ...representation,\n        data: countedStream,\n      },\n      sizePromise: sizePromise.then((size) => (size !== 0 ? size : this.extractSize(representation)))\n        .catch(() => this.extractSize(representation)),\n    };\n  }\n\n  private async applyMeasuredWriteUsage(\n    context: UsageContext | undefined,\n    previousSize: number,\n    representation: Representation,\n    sizePromise: Promise<number>,\n  ): Promise<void> {\n    const estimatedSize = Math.max(0, Math.trunc(this.extractSize(representation)));\n\n    await this.applyStorageUpdate(context, previousSize, estimatedSize);\n    await this.recordBandwidth(context, estimatedSize, 0);\n\n    if (!context || !this.usageRepo) {\n      return;\n    }\n\n    void sizePromise\n      .then((measuredSize) => this.reconcileWriteUsage(context, estimatedSize, measuredSize))\n      .catch((error: unknown) => this.logger.warn(`Failed to resolve measured write usage: ${String(error)}`));\n  }\n\n  private async reconcileWriteUsage(context: UsageContext, estimatedSize: number, measuredSize: number): Promise<void> {\n    if (!this.usageRepo) {\n      return;\n    }\n\n    const normalizedMeasured = Math.max(0, Math.trunc(measuredSize));\n    const correction = normalizedMeasured - estimatedSize;\n    if (correction === 0) {\n      return;\n    }\n\n    await this.usageRepo.incrementUsage(context.accountId, context.podId, correction, correction, 0);\n  }\n\n  private extractSize(representation: Representation): number {\n    const meta: any = representation as any;\n    const candidate = meta.metadata?.contentLength;\n    if (typeof candidate === 'number') {\n      return candidate;\n    }\n    if (typeof candidate === 'string') {\n      const parsed = Number(candidate);\n      return Number.isNaN(parsed) ? 0 : parsed;\n    }\n    return 0;\n  }\n\n  private async applyStorageUpdate(context: UsageContext | undefined, previousSize: number, newSize: number): Promise<void> {\n    if (!context || !this.usageRepo) {\n      return;\n    }\n    const normalizedPrevious = Math.max(0, Math.trunc(previousSize ?? 0));\n    const normalizedNew = Math.max(0, Math.trunc(newSize ?? 0));\n    const delta = normalizedNew - normalizedPrevious;\n    if (delta !== 0) {\n      await this.usageRepo.incrementUsage(context.accountId, context.podId, delta, 0, 0);\n    }\n  }\n\n  private async getExistingSize(identifier: ResourceIdentifier): Promise<number> {\n    if (!this.podLookup) {\n      return 0;\n    }\n    try {\n      const representation = await this.source.getRepresentation(identifier, {} as RepresentationPreferences);\n      return await this.computeRepresentationSize(representation);\n    } catch {\n      return 0;\n    }\n  }\n\n  private async computeRepresentationSize(representation: Representation): Promise<number> {\n    if (!representation.data) {\n      return this.extractSize(representation);\n    }\n    const binary = representation.binary ?? false;\n    const stream = representation.data;\n    let countedBytes = 0;\n\n    return await new Promise<number>((resolve, reject) => {\n      const removeListener = typeof (stream as any).off === 'function' ?\n        (event: string, handler: (...args: any[]) => void): void => { (stream as any).off(event, handler); } :\n        (event: string, handler: (...args: any[]) => void): void => { (stream as any).removeListener(event, handler); };\n      const onData = (chunk: unknown): void => {\n        if (binary) {\n          if (chunk instanceof Buffer) {\n            countedBytes += chunk.length;\n          } else if (typeof chunk === 'string') {\n            countedBytes += Buffer.byteLength(chunk);\n          }\n        } else {\n          countedBytes += UsageTrackingStore.measureObjectChunkSize(chunk);\n        }\n      };\n\n      const cleanup = (): void => {\n        removeListener('data', onData);\n        removeListener('error', onError);\n        removeListener('end', onEnd);\n        removeListener('close', onEnd);\n      };\n\n      const onEnd = (): void => {\n        cleanup();\n        resolve(countedBytes !== 0 ? countedBytes : this.extractSize(representation));\n      };\n      const onError = (error: unknown): void => {\n        cleanup();\n        reject(error);\n      };\n\n      stream.on('data', onData);\n      stream.once('error', onError);\n      stream.once('end', onEnd);\n      stream.once('close', onEnd);\n      if (typeof (stream as any).resume === 'function') {\n        (stream as any).resume();\n      }\n    }).catch(() => this.extractSize(representation));\n  }\n\n  private async resolveContext(identifier: ResourceIdentifier): Promise<UsageContext | undefined> {\n    if (!this.podLookup) {\n      return undefined;\n    }\n    const pod = await this.podLookup.findByResourceIdentifier(identifier.path);\n    if (!pod) {\n      return undefined;\n    }\n    return {\n      accountId: pod.accountId,\n      podId: pod.podId,\n    };\n  }\n\n  private async resolveBandwidthLimit(context: UsageContext): Promise<number | null | undefined> {\n    if (!this.usageRepo) {\n      return this.defaultBandwidthLimit;\n    }\n    const podRecord = await this.usageRepo.getPodUsage(context.podId);\n    if (podRecord && podRecord.bandwidthLimitBps !== undefined) {\n      return this.normalizeLimit(podRecord.bandwidthLimitBps);\n    }\n    const accountRecord = await this.usageRepo.getAccountUsage(context.accountId);\n    if (accountRecord && accountRecord.bandwidthLimitBps !== undefined) {\n      return this.normalizeLimit(accountRecord.bandwidthLimitBps);\n    }\n    return this.defaultBandwidthLimit;\n  }\n\n  private async recordBandwidth(context: UsageContext | undefined, ingress: number, egress: number): Promise<void> {\n    if (!context || !this.usageRepo) {\n      return;\n    }\n    const normalizedIngress = this.normalizeBandwidthDelta(ingress);\n    const normalizedEgress = this.normalizeBandwidthDelta(egress);\n    if (normalizedIngress === 0 && normalizedEgress === 0) {\n      return;\n    }\n    await this.usageRepo.incrementUsage(context.accountId, context.podId, 0, normalizedIngress, normalizedEgress);\n  }\n\n  private normalizeLimit(limit?: number | null): number | null {\n    if (limit == null) {\n      return null;\n    }\n    const numeric = Number(limit);\n    if (!Number.isFinite(numeric) || numeric <= 0) {\n      return null;\n    }\n    return Math.max(0, Math.trunc(numeric));\n  }\n\n  private normalizeBandwidthDelta(value: number): number {\n    if (!Number.isFinite(value) || value <= 0) {\n      return 0;\n    }\n    return Math.trunc(value);\n  }\n\n  private static measureObjectChunkSize(chunk: unknown): number {\n    if (chunk == null) {\n      return 0;\n    }\n    if (chunk instanceof Buffer) {\n      return chunk.length;\n    }\n    if (typeof chunk === 'string') {\n      return Buffer.byteLength(chunk, 'utf8');\n    }\n    if (UsageTrackingStore.isQuad(chunk)) {\n      const serialized = UsageTrackingStore.quadToNQuads(chunk);\n      return Buffer.byteLength(serialized, 'utf8');\n    }\n    return 0;\n  }\n\n  private static isQuad(candidate: unknown): candidate is Quad {\n    if (!candidate || typeof candidate !== 'object') {\n      return false;\n    }\n    const quad = candidate as Partial<Quad>;\n    return !!quad.subject && !!quad.predicate && !!quad.object && quad.graph !== undefined;\n  }\n\n  private static quadToNQuads(quad: Quad): string {\n    const subject = UsageTrackingStore.termToNQuads(quad.subject);\n    const predicate = UsageTrackingStore.termToNQuads(quad.predicate);\n    const object = UsageTrackingStore.termToNQuads(quad.object);\n    const graph = quad.graph.termType === 'DefaultGraph' ? '' : ` ${UsageTrackingStore.termToNQuads(quad.graph)}`;\n    return `${subject} ${predicate} ${object}${graph} .\\n`;\n  }\n\n  private static termToNQuads(term: Term): string {\n    switch (term.termType) {\n      case 'NamedNode':\n        return `<${term.value}>`;\n      case 'BlankNode':\n        return `_:${term.value}`;\n      case 'Literal':\n        return UsageTrackingStore.literalToNQuads(term as Literal);\n      case 'DefaultGraph':\n        return '';\n      default:\n        return `<${term.value}>`;\n    }\n  }\n\n  private static literalToNQuads(literal: Literal): string {\n    const escaped = UsageTrackingStore.escapeLiteral(literal.value);\n    if (literal.language) {\n      return `\"${escaped}\"@${literal.language}`;\n    }\n    const datatype = literal.datatype?.value;\n    if (datatype && datatype !== UsageTrackingStore.XSD_STRING) {\n      return `\"${escaped}\"^^<${datatype}>`;\n    }\n    return `\"${escaped}\"`;\n  }\n\n  private static escapeLiteral(value: string): string {\n    return value\n      .replace(/\\\\/g, '\\\\\\\\')\n      .replace(/\\\"/g, '\\\\\"')\n      .replace(/\\n/g, '\\\\n')\n      .replace(/\\r/g, '\\\\r')\n      .replace(/\\t/g, '\\\\t')\n      .replace(/\\f/g, '\\\\f')\n      .replace(/\\b/g, '\\\\b');\n  }\n}\n"]}

package/dist/storage/quota/UsageTrackingStore.jsonld

@@ -0,0 +1,193 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld",
+    "https://linkedsoftwaredependencies.org/bundles/npm/@solid/community-server/^8.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore",
+      "@type": "Class",
+      "requireElement": "UsageTrackingStore",
+      "extends": [
+        {
+          "@type": "GenericComponentExtension",
+          "component": "css:dist/storage/PassthroughStore.jsonld#PassthroughStore",
+          "genericTypeInstances": [
+            {
+              "@type": "ParameterRangeGenericTypeReference",
+              "parameterRangeGenericType": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__generic_T"
+            }
+          ]
+        }
+      ],
+      "genericTypeParameters": [
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__generic_T",
+          "range": "css:dist/storage/ResourceStore.jsonld#ResourceStore",
+          "default": "css:dist/storage/ResourceStore.jsonld#ResourceStore"
+        }
+      ],
+      "parameters": [
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore_source",
+          "range": {
+            "@type": "ParameterRangeGenericTypeReference",
+            "parameterRangeGenericType": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__generic_T"
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore_options_identityDbUrl",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore_options_defaultAccountBandwidthLimitBps",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:number",
+              {
+                "@type": "ParameterRangeWildcard"
+              },
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_usageRepo",
+          "memberFieldName": "usageRepo"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_podLookup",
+          "memberFieldName": "podLookup"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_defaultBandwidthLimit",
+          "memberFieldName": "defaultBandwidthLimit"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_XSD_STRING",
+          "memberFieldName": "XSD_STRING"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_addResource",
+          "memberFieldName": "addResource"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_setRepresentation",
+          "memberFieldName": "setRepresentation"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_getRepresentation",
+          "memberFieldName": "getRepresentation"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_deleteResource",
+          "memberFieldName": "deleteResource"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_measureRepresentation",
+          "memberFieldName": "measureRepresentation"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_extractSize",
+          "memberFieldName": "extractSize"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_applyStorageUpdate",
+          "memberFieldName": "applyStorageUpdate"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_getExistingSize",
+          "memberFieldName": "getExistingSize"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_computeRepresentationSize",
+          "memberFieldName": "computeRepresentationSize"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_resolveContext",
+          "memberFieldName": "resolveContext"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_resolveBandwidthLimit",
+          "memberFieldName": "resolveBandwidthLimit"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_recordBandwidth",
+          "memberFieldName": "recordBandwidth"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_normalizeLimit",
+          "memberFieldName": "normalizeLimit"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_normalizeBandwidthDelta",
+          "memberFieldName": "normalizeBandwidthDelta"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_measureObjectChunkSize",
+          "memberFieldName": "measureObjectChunkSize"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_isQuad",
+          "memberFieldName": "isQuad"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_quadToNQuads",
+          "memberFieldName": "quadToNQuads"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_termToNQuads",
+          "memberFieldName": "termToNQuads"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_literalToNQuads",
+          "memberFieldName": "literalToNQuads"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore__member_escapeLiteral",
+          "memberFieldName": "escapeLiteral"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore_source"
+        },
+        {
+          "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "identityDbUrl",
+              "value": {
+                "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore_options_identityDbUrl"
+              }
+            },
+            {
+              "keyRaw": "defaultAccountBandwidthLimitBps",
+              "value": {
+                "@id": "undefineds:dist/storage/quota/UsageTrackingStore.jsonld#UsageTrackingStore_options_defaultAccountBandwidthLimitBps"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/storage/sparql/AlgebraUtils.d.ts

@@ -0,0 +1,48 @@
+/**
+ * AlgebraUtils - SPARQL algebra tree traversal utilities
+ *
+ * Provides helper functions for working with SPARQL algebra trees:
+ * - Variable extraction
+ * - Term extraction from expressions
+ * - Literal value extraction
+ */
+import type { Term, Variable } from '@rdfjs/types';
+import type { Algebra } from 'sparqlalgebrajs';
+/**
+ * Extract variable name from an expression
+ * Returns the variable name (without ?) if it's a variable, null otherwise
+ */
+export declare function extractVariable(expr: Algebra.Expression): string | null;
+/**
+ * Extract variable name from STR(?var) expression
+ * Handles both direct variable and STR() wrapped variable
+ */
+export declare function extractStrVariable(expr: Algebra.Expression): string | null;
+/**
+ * Extract literal value from an expression
+ * Returns the string value if it's a literal, null otherwise
+ */
+export declare function extractLiteralValue(expr: Algebra.Expression): string | null;
+/**
+ * Extract literal with datatype from an expression
+ */
+export declare function extractLiteral(expr: Algebra.Expression): {
+    value: string;
+    datatype?: string;
+} | null;
+/**
+ * Extract a term from an expression
+ */
+export declare function extractTerm(expr: Algebra.Expression): Term | null;
+/**
+ * Extract all variables from a pattern
+ */
+export declare function extractVariables(pattern: Algebra.Pattern): Variable[];
+/**
+ * Check if a variable is used in a pattern position
+ */
+export declare function isVariableInPattern(varName: string, pattern: Algebra.Pattern): boolean;
+/**
+ * Get the position of a variable in a pattern
+ */
+export declare function getVariablePosition(varName: string, pattern: Algebra.Pattern): 'subject' | 'predicate' | 'object' | 'graph' | null;