@pikku/addon-aws-s3 0.0.2

package/dist/.pikku/function/pikku-function-types.gen.js

@@ -0,0 +1,334 @@
+/**
+ * This file was generated by @pikku/cli@0.12.54
+ */
+/**
+ * Core function, middleware, and permission types for all wirings
+ */
+import { pikkuAuth as pikkuAuthCore } from '@pikku/core/function';
+import { addTagMiddleware as addTagMiddlewareCore, addGlobalMiddleware as addGlobalMiddlewareCore, addTagPermission as addTagPermissionCore, addGlobalPermission as addGlobalPermissionCore, } from '@pikku/core/middleware';
+import { pikkuState as __pikkuState } from '@pikku/core/internal';
+/**
+ * Factory function for creating permissions with tree-shaking support.
+ * Supports both direct function and configuration object syntax.
+ *
+ * @example
+ * ```typescript
+ * // Direct function syntax
+ * const permission = pikkuPermission(async ({ logger }, data, { session }) => {
+ *   const session = await session?.get()
+ *   return session?.role === 'admin'
+ * })
+ *
+ * // Configuration object syntax with metadata
+ * const adminPermission = pikkuPermission({
+ *   name: 'Admin Permission',
+ *   description: 'Checks if user has admin role',
+ *   func: async ({ logger }, data, { session }) => {
+ *     const session = await session?.get()
+ *     return session?.role === 'admin'
+ *   }
+ * })
+ * ```
+ */
+export const pikkuPermission = (permission) => {
+    return typeof permission === 'function' ? permission : permission.func;
+};
+/**
+ * Factory function for creating auth-only permissions with tree-shaking support.
+ * Auth permissions only receive services and session (no request data),
+ * making them evaluable before request data is available.
+ *
+ * @example
+ * \`\`\`typescript
+ * const isAuthenticated = pikkuAuth(async ({ logger }, session) => {
+ *   return !!session
+ * })
+ *
+ * const isAdmin = pikkuAuth({
+ *   name: 'Admin Auth',
+ *   description: 'Checks if user is an admin',
+ *   func: async ({ logger }, session) => {
+ *     return session?.role === 'admin'
+ *   }
+ * })
+ * \`\`\`
+ */
+export const pikkuAuth = (auth) => {
+    return pikkuAuthCore(auth);
+};
+/**
+ * Factory function for creating middleware with tree-shaking support.
+ * Supports both direct function and configuration object syntax.
+ *
+ * @example
+ * ```typescript
+ * // Direct function syntax
+ * const middleware = pikkuMiddleware(({ logger }, wires, next) => {
+ *   logger.info('Middleware executed')
+ *   await next()
+ * })
+ *
+ * // Configuration object syntax with metadata
+ * const logMiddleware = pikkuMiddleware({
+ *   name: 'Request Logger',
+ *   description: 'Logs all incoming requests',
+ *   func: async ({ logger }, wires, next) => {
+ *     logger.info('Request started')
+ *     await next()
+ *   }
+ * })
+ * ```
+ */
+export const pikkuMiddleware = (middleware) => {
+    return typeof middleware === 'function' ? middleware : middleware.func;
+};
+/**
+ * Factory function for creating middleware factories
+ * Use this when your middleware needs configuration/input parameters
+ *
+ * @example
+ * ```typescript
+ * export const logMiddleware = pikkuMiddlewareFactory<LogOptions>(({
+ *   message,
+ *   level = 'info'
+ * }) => {
+ *   return pikkuMiddleware(async ({ logger }, next) => {
+ *     logger[level](message)
+ *     await next()
+ *   })
+ * })
+ * ```
+ */
+export const pikkuMiddlewareFactory = (factory) => {
+    return factory;
+};
+/**
+ * Factory function for creating permission factories
+ * Use this when your permission needs configuration/input parameters
+ *
+ * @example
+ * ```typescript
+ * export const requireRole = pikkuPermissionFactory<{ role: string }>(({
+ *   role
+ * }) => {
+ *   return pikkuPermission(async ({ logger }, data, { session }) => {
+ *     if (!session || session.role !== role) {
+ *       logger.warn(`Permission denied: required role '${role}'`)
+ *       return false
+ *     }
+ *     return true
+ *   })
+ * })
+ * ```
+ */
+export const pikkuPermissionFactory = (factory) => {
+    return factory;
+};
+/**
+ * Factory function for creating approval description functions with tree-shaking support.
+ *
+ * @example
+ * ```typescript
+ * export const deleteTodoApproval = pikkuApprovalDescription(
+ *   async ({ todoStore }, { id }) => {
+ *     const todo = await todoStore.get(id)
+ *     return \`Delete todo: "${todo.title}"\`
+ *   }
+ * )
+ * ```
+ */
+export const pikkuApprovalDescription = (fn) => {
+    return fn;
+};
+export function pikkuFunc(func) {
+    return typeof func === 'function' ? { func } : func;
+}
+export const pikkuListFunc = (config) => {
+    return pikkuFunc(config);
+};
+export function pikkuSessionlessFunc(func) {
+    return typeof func === 'function' ? { func } : func;
+}
+/**
+ * Creates a function that takes no input and returns no output.
+ * Useful for health checks, triggers, or cleanup operations.
+ *
+ * @param func - Function definition, either direct function or configuration object
+ * @returns The normalized configuration object
+ *
+ * @example
+ * ```typescript
+ * const cleanupTempFiles = pikkuVoidFunc(async ({fileSystem, logger}) => {
+ *     logger.info('Starting cleanup of temporary files')
+ *     await fileSystem.deleteDirectory('/tmp/uploads')
+ *     logger.info('Cleanup completed')
+ * })
+ * ```
+ */
+export const pikkuVoidFunc = (func) => {
+    return typeof func === 'function' ? { func } : func;
+};
+/**
+ * References a registered function by name for use in any wiring.
+ * Works for both local and addon functions — resolves via RPC at runtime.
+ *
+ * @template Name - The function name (must be a key in FlattenedRPCMap)
+ * @param rpcName - The name of the function to reference
+ * @returns A Pikku function config that proxies calls via RPC
+ *
+ * @example
+ * ```typescript
+ * // Use in agent tools
+ * tools: [ref('todos:listTodos'), ref('myLocalFunc')]
+ *
+ * // Use in HTTP wiring
+ * wireHTTP({ route: '/greet', method: 'post', func: ref('greet') })
+ * ```
+ */
+export const ref = (rpcName) => {
+    return {
+        func: async (_services, data, { rpc }) => {
+            return rpc.invoke(rpcName, data);
+        }
+    };
+};
+/**
+ * Creates a Pikku config factory.
+ * Use this to define your application's configuration factory.
+ *
+ * @param func - Config factory function that returns your application's config
+ * @returns The config factory function
+ *
+ * @example
+ * ```typescript
+ * export const createConfig = pikkuConfig(async () => {
+ *   return {
+ *     apiUrl: process.env.API_URL || 'http://localhost:3000',
+ *     dbUrl: process.env.DATABASE_URL
+ *   }
+ * })
+ * ```
+ */
+export const pikkuConfig = (func) => func;
+/**
+ * Creates a Pikku singleton services factory.
+ * Use this to define services that are created once and shared across all requests.
+ *
+ * @param func - Singleton services factory function
+ * @returns The singleton services factory function
+ *
+ * @example
+ * ```typescript
+ * export const createSingletonServices = pikkuServices(async (config, existingServices) => {
+ *   return {
+ *     config,
+ *     logger: new CustomLogger(),
+ *     db: await createDatabaseConnection(config.dbUrl)
+ *   }
+ * })
+ * ```
+ */
+export const pikkuServices = (func) => {
+    return async (config, existingServices = {}) => {
+        const createdServices = await func(config, existingServices);
+        const services = { ...existingServices, ...createdServices };
+        const authFactory = __pikkuState(null, 'package', 'authFactory');
+        if (authFactory) {
+            let authInstance;
+            services.auth = () => {
+                authInstance ??= Promise.resolve()
+                    .then(() => authFactory(services))
+                    .catch((error) => {
+                    authInstance = undefined;
+                    throw error;
+                });
+                return authInstance;
+            };
+        }
+        const resolved = services;
+        __pikkuState(null, 'package', 'singletonServices', resolved);
+        return resolved;
+    };
+};
+/**
+ * Creates a Pikku wire services factory.
+ * Use this to define services that are created per-request/session.
+ *
+ * @param func - Wire services factory function
+ * @returns The wire services factory function
+ *
+ * @example
+ * ```typescript
+ * export const createWireServices = pikkuWireServices(async (services, wire) => {
+ *   const session = await wire.session?.get()
+ *   return {
+ *     userCache: new UserCache(session?.userId)
+ *   }
+ * })
+ * ```
+ */
+export const pikkuWireServices = (func) => {
+    const factories = __pikkuState(null, 'package', 'factories');
+    __pikkuState(null, 'package', 'factories', { ...factories, createWireServices: func });
+    return func;
+};
+/**
+ * Tag-scoped middleware. Applies to any wiring that carries the matching tag.
+ *
+ * @example
+ * addTagMiddleware('admin', [adminMiddleware])
+ */
+export const addTagMiddleware = (tag, middleware) => {
+    addTagMiddlewareCore(tag, middleware, '@pikku/addon-aws-s3');
+};
+/**
+ * Wire-agnostic global middleware. Runs at the top of every wiring's
+ * middleware chain — before wire-, tag-, and function-level entries.
+ *
+ * Resolution order: global -> wire -> tag -> function.
+ *
+ * @example
+ * addGlobalMiddleware([telemetryMiddleware])
+ */
+export const addGlobalMiddleware = (middleware) => {
+    addGlobalMiddlewareCore(middleware, '@pikku/addon-aws-s3');
+};
+/**
+ * Tag-scoped permissions. Applies to any wiring that carries the matching tag.
+ *
+ * @example
+ * addTagPermission('admin', [adminPermission])
+ */
+export const addTagPermission = (tag, permissions) => {
+    addTagPermissionCore(tag, permissions, '@pikku/addon-aws-s3');
+};
+/**
+ * Wire-agnostic global permissions. Runs at the top of every wiring's
+ * permission resolution — before wire-, tag-, and function-level entries.
+ *
+ * Resolution order: global -> wire -> tag -> function.
+ *
+ * @example
+ * addGlobalPermission([signedInUser])
+ */
+export const addGlobalPermission = (permissions) => {
+    addGlobalPermissionCore(permissions, '@pikku/addon-aws-s3');
+};
+export { wireAddon } from '@pikku/core/rpc';
+/**
+ * Addon contract references. Generated from each wired addon's published
+ * contract metadata — no addon source is imported. Functions are proxied via
+ * ref() (RPC) exactly like ref('namespace:fn').
+ */
+const __addonHttp = {};
+const __addonChannel = {};
+const __addonCli = {};
+export const refHTTP = (name, options) => {
+    const contract = __addonHttp[name];
+    return (options?.basePath !== undefined
+        ? { ...contract, basePath: options.basePath }
+        : contract);
+};
+export const refChannel = (name) => __addonChannel[name];
+export const refCLI = (name) => __addonCli[name];
+//# sourceMappingURL=pikku-function-types.gen.js.map

package/dist/.pikku/function/pikku-function-types.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-function-types.gen.js","sourceRoot":"","sources":["../../../.pikku/function/pikku-function-types.gen.ts"],"names":[],"mappings":"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"}